{"openapi":"3.1.0","info":{"title":"Stadiums API","version":"1.0.0","description":"Stadiums and sports venues around the world as an API — 7,000+ stadiums from Wikidata with their seating capacity, country and city, geographic coordinates and year opened. Search and filter by name, country, minimum capacity and opening year (the results come back largest-first, so it doubles as a \"biggest stadiums in the world\" ranking), or find every stadium near any coordinate by great-circle distance. Ideal for sports, travel, ticketing, maps, trivia and matchday apps. Open data from Wikidata.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/stadiums-api","description":"oanor gateway"}],"tags":[{"name":"Stadiums"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/nearby":{"get":{"operationId":"get_v1_nearby","tags":["Stadiums"],"summary":"Stadiums near a coordinate","description":"","parameters":[{"name":"lat","in":"query","required":false,"description":"Latitude (-90..90)","schema":{"type":"string"},"example":"51.55"},{"name":"lon","in":"query","required":false,"description":"Longitude (-180..180)","schema":{"type":"string"},"example":"7.45"},{"name":"radius_km","in":"query","required":false,"description":"Search radius in km (0.5-2000, default 25)","schema":{"type":"string"}},{"name":"min_capacity","in":"query","required":false,"description":"Minimum seating capacity","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-100, default 20)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":2,"total":2,"center":{"lat":51.55,"lon":7.45},"results":[{"name":"Wullen Stadium","country":"Germany","capacity":12000,"latitude":51.446092,"longitude":7.360267,"distance_km":13.12,"opened_year":1926},{"name":"Ischelandstadion","country":"Germany","capacity":32000,"latitude":51.372239,"longitude":7.478072,"distance_km":19.86,"opened_year":1926}],"radius_km":25},"meta":{"timestamp":"2026-05-31T08:35:48.281Z","request_id":"2974e583-6cff-4a42-822b-704695bd98e0"},"status":"ok","message":"Nearby stadiums retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Stadiums"],"summary":"Search & filter stadiums (largest first)","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Search by stadium name","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Country, e.g. Germany, Brazil","schema":{"type":"string"},"example":"Germany"},{"name":"min_capacity","in":"query","required":false,"description":"Minimum seating capacity","schema":{"type":"string"}},{"name":"year_from","in":"query","required":false,"description":"Opened in or after this year","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"limit":20,"total":104,"offset":0,"filters":{"country":"Germany"},"results":[{"name":"Deutsches Stadion","country":"Germany","capacity":400000,"latitude":49.422197,"longitude":11.114142},{"name":"Allianz Arena","country":"Germany","capacity":75024,"latitude":48.218775,"longitude":11.624753},{"name":"Munich Olympic Stadium","country":"Germany","capacity":63118,"latitude":48.173056,"longitude":11.546667},{"name":"Arena AufSchalke","country":"Germany","capacity":62271,"latitude":51.554503,"longitude":7.067589,"opened_year":2001},{"name":"MHPArena","country":"Germany","capacity":60058,"latitude":48.792222,"longitude":9.231944,"opened_year":1933},{"name":"Sportforum Chemnitz","country":"Germany","capacity":60000,"latitude":50.805833,"longitude":12.934722,"opened_year":1926},{"name":"Volksparkstadion","country":"Germany","capacity":51500,"latitude":53.586944,"longitude":9.898611},{"name":"Niedersachsenstadion","country":"Germany","capacity":49000,"latitude":52.36,"longitude":9.731111,"opened_year":1954},{"name":"Hauptstadion","country":"Germany","capacity":40000,"latitude":50.795576,"longitude":6.094255,"opened_year":1924},{"name":"Deutsches Stadion","country":"Germany","capacity":33000,"latitude":52.514722,"longitude":13.239167,"opened_year":1913},{"name":"Ischelandstadion","country":"Germany","capacity":32000,"latitude":51.372239,"longitude":7.478072,"opened_year":1926},{"name":"Schauinsland-Reisen-Arena","country":"Germany","capacity":31500,"latitude":51.409028,"longitude":6.778639,"opened_year":2003},{"name":"Wedaustadion","country":"Germany","capacity":30112,"latitude":51.409033,"longitude":6.778664,"opened_year":1921},{"name":"Honsellstraße stadium","country":"Germany","capacity":30000,"opened_year":1908},{"name":"Stadion","country":"Germany","capacity":25000,"latitude":47.481572,"longitude":11.117506},{"name":"Lanxess Arena","country":"Germany","capacity":20000,"latitude":50.93843,"longitude":6.9829,"opened_year":1998},{"name":"Paul Greifzu Stadium","country":"Germany","capacity":20000,"latitude":51.824,"longitude":12.25157,"opened_year":1952},{"name":"Stadium Lichtenberg","country":"Germany","capacity":20000,"latitude":52.5297,"longitude":13.5044},{"name":"Friedrich-Ludwig-Jahn-Sportpark","country":"Germany","capacity":19708,"latitude":52.543056,"longitude":13.405278,"opened_year":1952},{"name":"Max-Reimann-Stadion","country":"Germany","capacity":19000,"latitude":51.7393,"longitude":14.3374}]},"meta":{"timestamp":"2026-05-31T08:35:48.356Z","request_id":"439d62ee-10b6-45f0-b12f-796da8b145c3"},"status":"ok","message":"Stadiums searched","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Totals, top countries & largest","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Stadiums & sports venues worldwide. /v1/search defaults to largest-capacity first; filter by name, country, min_capacity and year_from. /v1/nearby finds venues near a coordinate.","total":7241,"fields":["name","country","capacity","latitude","longitude","opened_year"],"source":"Wikidata (stadiums & sports venues)","largest":[{"name":"Deutsches Stadion","country":"Germany","capacity":400000},{"name":"Narendra Modi Stadium","country":"India","capacity":132000},{"name":"Estádio da Luz (1954)","country":"Portugal","capacity":120000},{"name":"Hassan II Stadium","country":"Morocco","capacity":115000},{"name":"Michigan Stadium","country":"United States","capacity":107601}],"countries":212,"top_countries":[{"count":1117,"country":"United States"},{"count":424,"country":"Lithuania"},{"count":291,"country":"United Kingdom"},{"count":239,"country":"France"},{"count":199,"country":"People's Republic of China"},{"count":192,"country":"Brazil"},{"count":185,"country":"Japan"},{"count":173,"country":"Ukraine"},{"count":163,"country":"Russia"},{"count":160,"country":"Indonesia"},{"count":147,"country":"India"},{"count":145,"country":"Thailand"}],"with_capacity":4263,"with_coordinates":6799},"meta":{"timestamp":"2026-05-31T08:35:48.430Z","request_id":"d33e8c32-1150-40c3-aa03-d08335d86c57"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3900,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":490,"monthly_call_quota":52000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1340,"monthly_call_quota":250000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3550,"monthly_call_quota":1230000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/stadiums-api"}