{"openapi":"3.1.0","info":{"title":"AI Platforms List API","version":"1.0.0","description":"Read the hand-checked list of AI tools and buy a listing. No account or key. Card payments happen on Stripe (a person pays the checkoutUrl); agents can pay in USDC on Base with x402.","contact":{"email":"info@aiplatformslist.com"}},"servers":[{"url":"https://aiplatformslist.com"}],"paths":{"/api/v1/tools":{"get":{"summary":"Search or list tools","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string","enum":["llms-and-apis","assistants-and-chatbots","coding","agents-and-automation","image-and-design","video","audio-and-voice","writing-and-marketing","language-and-documents","computer-vision","ml-platforms","data-and-search","healthcare","security-and-legal","research-and-education","productivity"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0}}],"responses":{"200":{"description":"Tools","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"category":{"type":"string"},"tagline":{"type":"string"},"pricingUrl":{"type":["string","null"]},"sponsored":{"type":"boolean"},"source":{"type":"string","enum":["seed","house","submitted"]},"pageUrl":{"type":"string"}}}}}}}}}}}},"/api/v1/tools/{slug}":{"get":{"summary":"One tool","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The tool","content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"category":{"type":"string"},"tagline":{"type":"string"},"pricingUrl":{"type":["string","null"]},"sponsored":{"type":"boolean"},"source":{"type":"string","enum":["seed","house","submitted"]},"pageUrl":{"type":"string"}}}}}},"404":{"description":"No such tool","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/api/v1/categories":{"get":{"summary":"Categories with counts","responses":{"200":{"description":"Categories"}}}},"/api/v1/plans":{"get":{"summary":"Listing plans and prices","responses":{"200":{"description":"Plans"}}}},"/api/v1/listings":{"post":{"summary":"Start a listing. Paid plans return a checkoutUrl a person pays on Stripe.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["plan","name","url","category","tagline","email"],"properties":{"plan":{"type":"string","enum":["free","fasttrack","featured"]},"name":{"type":"string","minLength":2,"maxLength":80},"url":{"type":"string","description":"The tool's website"},"category":{"type":"string","enum":["llms-and-apis","assistants-and-chatbots","coding","agents-and-automation","image-and-design","video","audio-and-voice","writing-and-marketing","language-and-documents","computer-vision","ml-platforms","data-and-search","healthcare","security-and-legal","research-and-education","productivity"]},"tagline":{"type":"string","minLength":10,"maxLength":160,"description":"One line about the tool, no links"},"description":{"type":"string","maxLength":600},"pricingModel":{"type":"string","enum":["free","freemium","paid","open-source","usage-based"]},"email":{"type":"string","description":"Optional: where notices about the listing go"}}}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"listingId":{"type":"string"},"status":{"type":"string","enum":["awaiting_payment","payment_processing","pending_review","held","live","rejected","payment_failed","charging","refund_due","expired"]},"plan":{"type":"string"},"name":{"type":"string"},"message":{"type":"string"},"pageUrl":{"type":"string"},"featuredUntil":{"type":"string"},"checkoutUrl":{"type":"string"}}}}}},"400":{"description":"Bad input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"409":{"description":"Already listed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Too many requests","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/api/v1/listings/{id}":{"get":{"summary":"Listing status","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Status","content":{"application/json":{"schema":{"type":"object","properties":{"listingId":{"type":"string"},"status":{"type":"string","enum":["awaiting_payment","payment_processing","pending_review","held","live","rejected","payment_failed","charging","refund_due","expired"]},"plan":{"type":"string"},"name":{"type":"string"},"message":{"type":"string"},"pageUrl":{"type":"string"},"featuredUntil":{"type":"string"}}}}}},"404":{"description":"No such listing","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/api/v1/listings/x402":{"post":{"summary":"Buy a listing in USDC on Base with x402 (no account)","description":"Without PAYMENT-SIGNATURE the answer is 402 with the terms in the PAYMENT-REQUIRED header. Sign them and repeat the request with PAYMENT-SIGNATURE. The site is checked before the payment settles.","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["plan","name","url","category","tagline"],"properties":{"plan":{"type":"string","enum":["fasttrack","featured"],"description":"fasttrack = $29 once; featured = $19 for 30 days"},"name":{"type":"string","minLength":2,"maxLength":80},"url":{"type":"string","description":"The tool's website"},"category":{"type":"string","enum":["llms-and-apis","assistants-and-chatbots","coding","agents-and-automation","image-and-design","video","audio-and-voice","writing-and-marketing","language-and-documents","computer-vision","ml-platforms","data-and-search","healthcare","security-and-legal","research-and-education","productivity"]},"tagline":{"type":"string","minLength":10,"maxLength":160,"description":"One line about the tool, no links"},"description":{"type":"string","maxLength":600},"pricingModel":{"type":"string","enum":["free","freemium","paid","open-source","usage-based"]},"email":{"type":"string","description":"Optional: where notices about the listing go"}}}}}},"responses":{"201":{"description":"Paid and live; PAYMENT-RESPONSE header carries the settlement"},"402":{"description":"Payment required; terms in PAYMENT-REQUIRED"},"409":{"description":"Already listed or featured, or payment used"},"422":{"description":"The site failed the check; nothing charged"},"503":{"description":"x402 is off or the payment service did not answer"}}}}}}