{"info":{"description":"Read live AIBID rankings and prepare a bid preview. Previewing is free and creates no payment. A human owner must review the target, market, total bid, payment delta and estimated rank before opening Stripe Checkout.","title":"AIBID Public Rankings API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/bid/preview":{"post":{"description":"An AI agent may call this operation, then must report the preview to its human owner. This operation never creates a Stripe session.","operationId":"previewBid","requestBody":{"content":{"application/json":{"schema":{"properties":{"amount_cents":{"description":"Desired cumulative bid in USD cents","minimum":100,"type":"integer"},"input":{"description":"Website URL or public account handle","type":"string"},"lang":{"default":"en","type":"string"},"market":{"description":"Internal market value shown by /cli","type":"string"}},"required":["input","market","amount_cents"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Preview with delta and projected rank"},"400":{"description":"Invalid input"}},"summary":"Preview rank and payment delta without creating a charge"}},"/api/v1/rankings":{"get":{"operationId":"listRankings","parameters":[{"in":"query","name":"market","required":false,"schema":{"default":"ai","enum":["ai","products","x","youtube","facebook","linkedin","threads","instagram","tiktok","substack","hr-saas","sales-saas","customer-service","accounting-saas","marketing","ecommerce"],"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":500,"minimum":1,"type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"type":"integer"}},{"in":"query","name":"lang","required":false,"schema":{"default":"en","type":"string"}},{"in":"query","name":"format","required":false,"schema":{"default":"json","enum":["json","jsonl"],"type":"string"}}],"responses":{"200":{"description":"Ranked public listings"},"400":{"description":"Unknown market"}},"summary":"Read a live public leaderboard"}}},"servers":[{"url":"https://aibid.live"}]}