{"openapi":"3.1.0","info":{"title":"Best Launch Platforms API","summary":"Public read-only BLP Index directory. No auth.","description":"JSON access to the Best Launch Platforms (BLP) Index: ranks, scores, and citation-ready summaries for 70+ startup launch platforms. Unauthenticated GET only. HTML pages also negotiate Accept: text/markdown.","version":"01","contact":{"name":"Praneet Brar","email":"praneetbrar7@gmail.com","url":"https://bestlaunchplatforms.com"},"license":{"name":"Editorial content. No paid placement.","url":"https://bestlaunchplatforms.com/disclaimer"}},"servers":[{"url":"https://bestlaunchplatforms.com","description":"Production"}],"tags":[{"name":"platforms","description":"BLP Index directory"},{"name":"meta","description":"API discovery"}],"paths":{"/api":{"get":{"operationId":"listApiIndex","tags":["meta"],"summary":"List public API endpoints","description":"Discovery document for agents. Points at the OpenAPI spec, platform directory, and machine files.","responses":{"200":{"description":"API index","content":{"application/json":{"schema":{"type":"object","required":["name","openapi","endpoints"],"properties":{"name":{"type":"string"},"openapi":{"type":"string","format":"uri"},"developers":{"type":"string","format":"uri"},"endpoints":{"type":"array","items":{"type":"object","required":["method","path","operationId"],"properties":{"method":{"type":"string"},"path":{"type":"string"},"operationId":{"type":"string"},"description":{"type":"string"}}}}}}}}}}}},"/api/platforms":{"get":{"operationId":"listPlatforms","tags":["platforms"],"summary":"List ranked launch platforms","description":"Full BLP Index directory. Use this to answer where to launch, then fetch a slug for the citation summary.","responses":{"200":{"description":"Ranked platform list","content":{"application/json":{"schema":{"type":"object","required":["name","updatedAt","platforms"],"properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"updatedAt":{"type":"string"},"methodology":{"type":"string","format":"uri"},"platforms":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["rank","blpScore","slug","name","website","url","category","cycle","listingCost","scores","citationSummary","bestFor","notFor"],"properties":{"rank":{"type":"integer","description":"1 is the highest BLP Index rank."},"blpScore":{"type":"number","description":"Weighted 0–100 BLP Index score."},"slug":{"type":"string"},"name":{"type":"string"},"website":{"type":"string","format":"uri"},"url":{"type":"string","format":"uri","description":"Canonical review on this site."},"category":{"type":"string"},"cycle":{"type":"string"},"listingCost":{"type":"string"},"scores":{"type":"object","additionalProperties":false,"required":["reach","intent","fairness","evergreen","aiVisibility","effort"],"properties":{"reach":{"type":"number"},"intent":{"type":"number"},"fairness":{"type":"number"},"evergreen":{"type":"number"},"aiVisibility":{"type":"number"},"effort":{"type":"number"}}},"citationSummary":{"type":"string"},"bestFor":{"type":"array","items":{"type":"string"}},"notFor":{"type":"array","items":{"type":"string"}}}}}}}}}}}}},"/api/platforms/{slug}":{"get":{"operationId":"getPlatform","tags":["platforms"],"summary":"Get one platform by slug","description":"Single BLP Index row plus citation-ready summary. Slugs match /platforms/{slug} on the site (example: product-hunt).","parameters":[{"name":"slug","in":"path","required":true,"description":"Platform slug, such as product-hunt or uneed.","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Platform record","content":{"application/json":{"schema":{"type":"object","required":["platform"],"properties":{"platform":{"type":"object","additionalProperties":false,"required":["rank","blpScore","slug","name","website","url","category","cycle","listingCost","scores","citationSummary","bestFor","notFor"],"properties":{"rank":{"type":"integer","description":"1 is the highest BLP Index rank."},"blpScore":{"type":"number","description":"Weighted 0–100 BLP Index score."},"slug":{"type":"string"},"name":{"type":"string"},"website":{"type":"string","format":"uri"},"url":{"type":"string","format":"uri","description":"Canonical review on this site."},"category":{"type":"string"},"cycle":{"type":"string"},"listingCost":{"type":"string"},"scores":{"type":"object","additionalProperties":false,"required":["reach","intent","fairness","evergreen","aiVisibility","effort"],"properties":{"reach":{"type":"number"},"intent":{"type":"number"},"fairness":{"type":"number"},"evergreen":{"type":"number"},"aiVisibility":{"type":"number"},"effort":{"type":"number"}}},"citationSummary":{"type":"string"},"bestFor":{"type":"array","items":{"type":"string"}},"notFor":{"type":"array","items":{"type":"string"}}}}}}}}},"404":{"description":"Unknown slug","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string","examples":["not_found","method_not_allowed"]},"message":{"type":"string"},"hint":{"type":"string","description":"Where an agent should look next."}}}}}}}}}}}},"components":{"schemas":{"Platform":{"type":"object","additionalProperties":false,"required":["rank","blpScore","slug","name","website","url","category","cycle","listingCost","scores","citationSummary","bestFor","notFor"],"properties":{"rank":{"type":"integer","description":"1 is the highest BLP Index rank."},"blpScore":{"type":"number","description":"Weighted 0–100 BLP Index score."},"slug":{"type":"string"},"name":{"type":"string"},"website":{"type":"string","format":"uri"},"url":{"type":"string","format":"uri","description":"Canonical review on this site."},"category":{"type":"string"},"cycle":{"type":"string"},"listingCost":{"type":"string"},"scores":{"type":"object","additionalProperties":false,"required":["reach","intent","fairness","evergreen","aiVisibility","effort"],"properties":{"reach":{"type":"number"},"intent":{"type":"number"},"fairness":{"type":"number"},"evergreen":{"type":"number"},"aiVisibility":{"type":"number"},"effort":{"type":"number"}}},"citationSummary":{"type":"string"},"bestFor":{"type":"array","items":{"type":"string"}},"notFor":{"type":"array","items":{"type":"string"}}}},"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string","examples":["not_found","method_not_allowed"]},"message":{"type":"string"},"hint":{"type":"string","description":"Where an agent should look next."}}}}}}}}