{"openapi":"3.1.0","info":{"title":"Pickrate Public API","version":"1.0.0","description":"Query whether AI agents pick a developer tool over its competitors (its 'Pick Rate'). The same read surface is available as an MCP server at /api/mcp and via WebMCP at /.well-known/webmcp."},"servers":[{"url":"https://pickrate.io"}],"paths":{"/api/public/report":{"get":{"operationId":"getReport","summary":"Pick Rate report for one tool","description":"Headline Pick Rate, rank, and who beats a single tool. Resolve by name, slug, domain, or package.","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"Tool name, slug, domain, or package (e.g. 'stripe', 'clerk', '@sendgrid/mail')."}],"responses":{"200":{"description":"Report","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"slug":{"type":"string"},"category":{"type":"string"},"pickRate":{"type":"number","description":"Share of trials an agent picks this tool (0–1)."},"rank":{"type":"integer"},"field":{"type":"integer","description":"Number of tools in the category."},"defaultRate":{"type":"number"},"shortlistRate":{"type":"number"},"nTrials":{"type":"integer"},"asOf":{"type":["string","null"],"format":"date-time"},"beatenBy":{"type":"array","items":{"type":"object"}},"url":{"type":"string","format":"uri"}}}}}},"400":{"description":"Missing q"},"404":{"description":"No tool matched"}}}},"/api/public/leaderboard":{"get":{"operationId":"getLeaderboard","summary":"Ranked tools for a category","description":"Tools in a category ranked by Pick Rate. Omit `category` to list available categories (optionally scoped to one domain).","parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string"},"description":"Category slug (e.g. 'payments', 'auth', 'search')."},{"name":"domain","in":"query","required":false,"schema":{"type":"string","enum":["dev-tools","saas"]},"description":"When listing categories (no category given), scope to one leaderboard tree."}],"responses":{"200":{"description":"Ranked vendors, or the list of categories when no category is given","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No such category"}}}}}}