{"openapi":"3.1.0","info":{"title":"ShipX public API","version":"1.0.0","description":"Read-only access to public ShipX launch data: products launched by makers with fewer than 1,000 followers on X. No authentication. Rate limit: 120 requests/minute per IP. Private data (follower counts, emails, analytics) is never exposed."},"servers":[{"url":"https://shipx.live/api/v1"}],"paths":{"/products":{"get":{"summary":"List public products","parameters":[{"name":"sort","in":"query","schema":{"type":"string","enum":["newest","top","trending"]}},{"name":"category","in":"query","schema":{"type":"string"},"description":"Category slug, e.g. developer-tools"},{"name":"tag","in":"query","schema":{"type":"string"}},{"name":"technology","in":"query","schema":{"type":"string"}},{"name":"audience","in":"query","schema":{"type":"string"}},{"name":"pricing","in":"query","schema":{"type":"string","enum":["free","freemium","paid","open_source"]}},{"name":"platform","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Paginated products","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"},"tagline":{"type":"string"},"logo":{"type":"string","nullable":true},"pricing":{"type":"string","enum":["free","freemium","paid","open_source"],"nullable":true},"categories":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"maker":{"type":"object","properties":{"username":{"type":"string"},"name":{"type":"string"},"profile":{"type":"string"}}},"launch":{"type":"object","nullable":true,"properties":{"week":{"type":"string","example":"2026-W41"},"weekUrl":{"type":"string"},"date":{"type":"string","format":"date-time"}}},"supports":{"type":"integer"},"comments":{"type":"integer"},"featured":{"type":"boolean","description":"Paid/editorial featured placement. Never affects ranking."}}}},"page":{"type":"integer"},"pageCount":{"type":"integer"},"total":{"type":"integer"}}}}}}}}},"/products/{slug}":{"get":{"summary":"Get one product","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Product detail"},"404":{"description":"Not found"}}}},"/weeks/{week}":{"get":{"summary":"Get a launch week feed","parameters":[{"name":"week","in":"path","required":true,"schema":{"type":"string","example":"2026-w41"},"description":"ISO week slug or 'current'"}],"responses":{"200":{"description":"Week with ranked launches"}}}},"/makers/{username}":{"get":{"summary":"Get a maker’s public profile","parameters":[{"name":"username","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Maker"},"404":{"description":"Not found"}}}},"/categories":{"get":{"summary":"List categories and audiences","responses":{"200":{"description":"Taxonomy"}}}},"/search":{"get":{"summary":"Search products, makers and topics","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"pricing","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Search results"}}}}}}