{"openapi":"3.1.0","info":{"title":"Sports API","version":"1.0.0","description":"Search sports teams and players, fetch detailed team profiles (stadium, league, founding year, badges) and browse leagues across football (soccer) and 30+ other sports. Powered by TheSportsDB.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/sports-api","description":"oanor gateway"}],"tags":[{"name":"Sports"}],"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/leagues":{"get":{"operationId":"get_v1_leagues","tags":["Sports"],"summary":"List leagues (all or filtered)","description":"","parameters":[{"name":"sport","in":"query","required":false,"description":"Sport (e.g. Soccer)","schema":{"type":"string"},"example":"Soccer"},{"name":"country","in":"query","required":false,"description":"Country (e.g. England)","schema":{"type":"string"},"example":"England"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":5,"sport":"Soccer","country":"England","leagues":[{"id":"4570","name":"EFL Cup","sport":"Soccer","alternate":"Football League Cup, Carabao Cup"},{"id":"4847","name":"EFL Trophy","sport":"Soccer","alternate":"English Football League Trophy"},{"id":"5225","name":"England Non League Div One Isthmian North","sport":"Soccer","alternate":"Non League Div One - Isthmian North"},{"id":"5226","name":"England Non League Div One Isthmian South","sport":"Soccer","alternate":"Non League Div One - Isthmian South Central"},{"id":"5228","name":"England Non League Div One Southern Central","sport":"Soccer","alternate":"Non League Div One - Southern South"}]},"meta":{"timestamp":"2026-05-29T23:46:51.014Z","request_id":"12ab4aa2-52a4-4f87-824d-af58e34e4574"},"status":"ok","message":"Leagues retrieved successfully","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/players":{"get":{"operationId":"get_v1_players","tags":["Sports"],"summary":"Search players by name","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Player name","schema":{"type":"string"},"example":"Messi"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"query":"Messi","players":[{"id":"34146370","born":"1987-06-24","name":"Lionel Messi","team":"Inter Miami","sport":"Soccer","thumb":"https://r2.thesportsdb.com/images/media/player/thumb/kpfsvp1725295651.jpg","position":"Right Winger","nationality":"Argentina"}]},"meta":{"timestamp":"2026-05-29T23:46:51.534Z","request_id":"ee2410f4-9965-4f63-bc7f-ab4b60d0a0d1"},"status":"ok","message":"Players retrieved successfully","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/team":{"get":{"operationId":"get_v1_team","tags":["Sports"],"summary":"Team details by id","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Numeric team id","schema":{"type":"string"},"example":"133604"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"133604","name":"Arsenal","sport":"Soccer","league":"English Premier League","country":"England","stadium":"Emirates Stadium","website":"www.arsenal.com","alternate":"Arsenal Football Club, AFC, Arsenal FC","description":"Arsenal Football Club is a professional football club based in Islington, London, England, that plays in the Premier League, the top flight of English football. The club has won 13 League titles, a record 13 FA Cups, 2 League Cups, 15 FA Community Shields, 1 League Centenary Trophy, 1 UEFA Cup Winners' Cup and 1 Inter-Cities Fairs Cup.\r\n\r\nArsenal was the first club from the South of England to join The Football League, in 1893, and they reached the First Division in 1904. Relegated only once, in 1913, they continue the longest streak in the top division, and have won the second-most top-flight…","formed_year":"1892","stadium_capacity":"60338"},"meta":{"timestamp":"2026-05-29T23:46:51.933Z","request_id":"b9bedb78-1db5-4827-a95d-c78dfc0e1ac6"},"status":"ok","message":"Team retrieved successfully","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/teams":{"get":{"operationId":"get_v1_teams","tags":["Sports"],"summary":"Search teams by name","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Team name","schema":{"type":"string"},"example":"Arsenal"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"query":"Arsenal","teams":[{"id":"133604","name":"Arsenal","sport":"Soccer","league":"English Premier League","country":"England","stadium":"Emirates Stadium","website":"www.arsenal.com","alternate":"Arsenal Football Club, AFC, Arsenal FC","description":"Arsenal Football Club is a professional football club based in Islington, London, England, that plays in the Premier League, the top flight of English football. The club has won 13 League titles, a record 13 FA Cups, 2 League Cups, 15 FA Community Shields, 1 League Centenary Trophy, 1 UEFA Cup Winners' Cup and 1 Inter-Cities Fairs Cup.\r\n\r\nArsenal was the first club from the South of England to join The Football League, in 1893, and they reached the First Division in 1904. Relegated only once, in 1913, they continue the longest streak in the top division, and have won the second-most top-flight…","formed_year":"1892","stadium_capacity":"60338"}]},"meta":{"timestamp":"2026-05-29T23:46:52.277Z","request_id":"864a12a0-a07e-4d41-a813-5a808e4c1253"},"status":"ok","message":"Teams retrieved successfully","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":2500,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":900,"monthly_call_quota":45000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2900,"monthly_call_quota":220000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7900,"monthly_call_quota":750000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/sports-api"}