{"openapi":"3.1.0","info":{"title":"SubmitMySaas Public Data API","version":"1.0.0","description":"Read-only access to public ongoing/completed listings and aggregate launch statistics. No authentication required. Descriptions are summaries. Source URLs point to human-readable evidence."},"servers":[{"url":"https://submitmysaas.com"}],"paths":{"/api/public/products":{"get":{"operationId":"listProducts","summary":"List published product summaries","parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000000,"default":1}},{"name":"category","in":"query","schema":{"type":"string"},"description":"Category ID from /categories, such as ai or developer-tools."},{"name":"pricing","in":"query","schema":{"type":"string","enum":["all","free","freemium","paid"],"default":"all"}},{"name":"sort","in":"query","schema":{"type":"string","enum":["recent","alphabetical","upvotes"],"default":"recent"}}],"responses":{"200":{"description":"Up to 24 public summaries and a next-page URL, or null at the end.","content":{"application/json":{"schema":{"type":"object","required":["source","page","pageSize","totalCount","pageCount","next","products"],"properties":{"source":{"type":"string","format":"uri"},"page":{"type":"integer"},"pageSize":{"type":"integer","const":24},"totalCount":{"type":"integer"},"pageCount":{"type":"integer"},"next":{"type":["string","null"]},"products":{"type":"array","items":{"$ref":"#/components/schemas/Product"}}}}}}},"400":{"description":"Invalid, unknown, or repeated parameters."},"404":{"description":"Unknown category or page."},"429":{"description":"Rate limit exceeded. Retry-After indicates seconds to wait."}}}},"/data/launch-statistics.json":{"get":{"operationId":"launchStatistics","summary":"Aggregate public launch counts","responses":{"200":{"description":"Snapshot timestamp, source and methodology URLs, totals, category counts, pricing counts, and up to 12 launch months. Categories overlap. This is a platform census, not an industry survey.","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","format":"uri"},"methodology":{"type":"string","format":"uri"},"generatedAt":{"type":"string","format":"date-time"},"total":{"type":"integer"},"datedLaunches":{"type":"integer"},"categories":{"type":"array","items":{"type":"object"}},"pricing":{"type":"array","items":{"type":"object"}},"months":{"type":"array","items":{"type":"object"}}}}}}}}}},"/data/launch-statistics.csv":{"get":{"operationId":"launchStatisticsCsv","summary":"Download aggregate launch counts as CSV","responses":{"200":{"description":"Columns: snapshot_utc, dimension, value, count, denominator. Category and pricing denominators are all products; month denominators include only dated launches.","content":{"text/csv":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"Product":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"},"description":{"type":"string"},"pricing":{"type":"string"},"platforms":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}}},"launchDate":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}}}}}