{"openapi":"3.1.0","info":{"title":"Indie Apps","version":"1.0.0","description":"A read-only view of indie-apps.com: apps by independent developers, the people who made them, and a weekly board ranked by App Store visits this directory actually sent. No key, no account, no writes.","license":{"name":"Data from Apple; see /terms","url":"https://indie-apps.com/terms"}},"servers":[{"url":"https://indie-apps.com/v1"}],"paths":{"/apps":{"get":{"summary":"List apps","description":"Newest first. Pass q to search by name, developer or description.","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"q","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"A page of listings.","content":{"application/json":{"schema":{"type":"object","properties":{"returned":{"type":"integer"},"limit":{"type":"integer"},"query":{"type":["string","null"]},"apps":{"type":"array","items":{"type":"object","required":["slug","name","developer","category","url"],"properties":{"slug":{"type":"string","description":"Stable identifier, used in every URL."},"name":{"type":"string"},"developer":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"}}},"category":{"type":"string","description":"Apple's primary category."},"categories":{"type":"array","items":{"type":"string"}},"description":{"type":"string","description":"The editor's blurb where one exists, otherwise Apple's own description."},"price":{"type":"object","properties":{"formatted":{"type":["string","null"],"description":"As the US App Store prints it, e.g. \"$4.99\"."},"free":{"type":"boolean"}}},"icon":{"type":["string","null"],"format":"uri"},"appStoreUrl":{"type":"string","format":"uri"},"platform":{"type":"string","enum":["ios","mac"]},"listedAt":{"type":["string","null"],"format":"date-time","description":"When this directory listed it — not when Apple released it."},"url":{"type":"string","format":"uri"}}}}}}}}},"400":{"$ref":"#/components/responses/Problem"}}}},"/apps/{slug}":{"get":{"summary":"Get one app","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The listing.","content":{"application/json":{"schema":{"type":"object","properties":{"app":{"type":"object","required":["slug","name","developer","category","url"],"properties":{"slug":{"type":"string","description":"Stable identifier, used in every URL."},"name":{"type":"string"},"developer":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"}}},"category":{"type":"string","description":"Apple's primary category."},"categories":{"type":"array","items":{"type":"string"}},"description":{"type":"string","description":"The editor's blurb where one exists, otherwise Apple's own description."},"price":{"type":"object","properties":{"formatted":{"type":["string","null"],"description":"As the US App Store prints it, e.g. \"$4.99\"."},"free":{"type":"boolean"}}},"icon":{"type":["string","null"],"format":"uri"},"appStoreUrl":{"type":"string","format":"uri"},"platform":{"type":"string","enum":["ios","mac"]},"listedAt":{"type":["string","null"],"format":"date-time","description":"When this directory listed it — not when Apple released it."},"url":{"type":"string","format":"uri"}}}}}}}},"404":{"$ref":"#/components/responses/Problem"}}}},"/developers":{"get":{"summary":"List developers","description":"Everyone with a listing, most-listed first.","responses":{"200":{"description":"Every developer in the directory.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/debuts":{"get":{"summary":"This week's debut board","description":"Apps that debuted in an ISO week, ranked by how many people this directory sent to the App Store during it. Counted, not voted. Omit year and week for the current one.","parameters":[{"name":"year","in":"query","schema":{"type":"integer"}},{"name":"week","in":"query","schema":{"type":"integer","minimum":1,"maximum":53}}],"responses":{"200":{"description":"The board.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"}}}}},"components":{"responses":{"Problem":{"description":"RFC 9457 problem details.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"}}}}}}}}}