{"openapi":"3.1.0","info":{"title":"MakeThemRank public data API","version":"1.0.0","description":"Public, read-only access to the live paid-placement leaderboard and individual listing records. Rank, bid, and click values are volatile and should be refreshed before citation."},"servers":[{"url":"https://makethemrank.com"}],"paths":{"/api/leaderboard":{"get":{"operationId":"getLeaderboard","summary":"Get the current paid-placement leaderboard","description":"Returns active listings ordered by permanent paid bid total descending. Earlier successful payment breaks equal-total ties.","responses":{"200":{"description":"A verified live leaderboard snapshot, including a confirmed empty board.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeaderboardResponse"}}}},"503":{"description":"The live data could not be verified. Retry rather than treating this as an empty board."}}}},"/api/listings/{listingId}":{"get":{"operationId":"getPublicListing","summary":"Get one public listing and its public bid history","parameters":[{"name":"listingId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The current public listing record.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicListingResponse"}}}},"404":{"description":"No active listing has this ID."},"503":{"description":"The listing could not be verified. Retry rather than treating this as a confirmed 404."}}}}},"components":{"schemas":{"ListingSummary":{"type":"object","required":["id","rank","kind","title","description","category","bidTotalCents","clickCount","sourceUrl","profileUrl","apiUrl","sourceUrlRelationship"],"properties":{"id":{"type":"string","description":"Stable MakeThemRank listing ID."},"rank":{"type":"integer","minimum":1},"kind":{"type":"string","enum":["app_store","website","x"]},"title":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"bidTotalCents":{"type":"integer","minimum":0,"description":"Permanent paid bid total in USD cents."},"clickCount":{"type":"integer","minimum":0,"description":"Recorded outbound clicks, not guaranteed unique visitors."},"sourceUrl":{"type":"string","format":"uri"},"profileUrl":{"type":"string","format":"uri"},"apiUrl":{"type":"string","format":"uri"},"iconUrl":{"type":["string","null"],"format":"uri"},"sourceUrlRelationship":{"type":"string","const":"sponsored user-submitted listing"},"activatedAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}}},"LeaderboardResponse":{"type":"object","required":["schemaVersion","dataStatus","name","generatedAt","currency","listingCount","rankingMethod","listings"],"properties":{"schemaVersion":{"type":"string","const":"1.0.0"},"dataStatus":{"type":"string","const":"live"},"name":{"type":"string"},"description":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"},"currency":{"type":"string","const":"USD"},"listingCount":{"type":"integer","minimum":0},"rankingMethod":{"type":"object","properties":{"primary":{"type":"string"},"tieBreak":{"type":"string"},"paidPlacement":{"type":"boolean","const":true}}},"listings":{"type":"array","items":{"$ref":"#/components/schemas/ListingSummary"}}}},"PublicListingResponse":{"type":"object","required":["schemaVersion","dataStatus","recordType","listing","history","paidPlacement","profileUrl","sourceUrlRelationship","rankingMethod","retrievedAt"],"properties":{"schemaVersion":{"type":"string","const":"1.0.0"},"dataStatus":{"type":"string","const":"live"},"recordType":{"type":"string","const":"public_listing"},"listing":{"type":"object"},"rank":{"type":["integer","null"],"minimum":1},"history":{"type":"array","items":{"type":"object"}},"paidPlacement":{"type":"boolean","const":true},"profileUrl":{"type":"string","format":"uri"},"sourceUrlRelationship":{"type":"string","const":"sponsored user-submitted listing"},"rankingMethod":{"type":"string"},"retrievedAt":{"type":"string","format":"date-time"}}}}}}