Free Sports API
Support
The free JSON sports API will always remain free at point of access for basic sports data.
All example links should be testable in the browser for v1.
Here are some php, javascript, python code examples to get you going.
Test API Keys
Free users can use the test API key "3" during development of your app or for educational use.
If you have paid for a premium key, just replace "3" with your "API KEY" in the URL.
API Limits
The Rate limiter will kick in if you make over 100 requests per minute on our API with a 429 response.
V1 API vs V2
Version 1 of the API is now 7 years old and very stable. Most of the API is also free to use.
V2 is a more modern implimentation with API key header authentication and simpler descriptive calls.
Both use the same data, but may difer in structure. V2 is only available to Patreon subscribers
Premium API
$7 monthly Patreon supporters get a dedicated production API key
including 2min Livescores, Video highlights and all other upgraded features.
You must be registered on TheSportsDB and a supporter on Patreon
Once signed up you can find your API key on the user page.
Contact
Email: [email protected] - Please state if you are a Patreon Supporter
V1 API
Search
Search for team by name
/api/v1/json/3/searchteams.php?t=Arsenal
Search for team short code
/api/v1/json/3/searchteams.php?sname=ARS
Search for all players from team
/api/v1/json/3/searchplayers.php?t=Arsenal
Search for players by name
/api/v1/json/3/searchplayers.php?p=Danny_Welbeck
/api/v1/json/{APIKEY}/searchplayers.php?t={TeamName}&p={Playername}
Search for event by event name
/api/v1/json/3/searchevents.php?e=Arsenal_vs_Chelsea
/api/v1/json/3/searchevents.php?e=Arsenal_vs_Chelsea&s=2016-2017
Search for event by event file name
/api/v1/json/3/searchfilename.php?e=English_Premier_League_2015-04-26_Arsenal_vs_Chelsea
Search for Venue
/api/v1/json/3/searchvenues.php?t=Wembley
NOTE: You can replace spaces '%20' with underscores if you want, when requesting multi word strings.
List
List all sports
/api/v1/json/3/all_sports.php
List all leagues (limited 50 on free tier)
/api/v1/json/3/all_leagues.php
List all countries
/api/v1/json/3/all_countries.php
List all Leagues in a country (limited 50 on free tier)
/api/v1/json/3/search_all_leagues.php?c=England
/api/v1/json/3/search_all_leagues.php?c=England&s=Soccer
List all Seasons in a League
/api/v1/json/3/search_all_seasons.php?id=4328
List all Teams in a League
/api/v1/json/3/search_all_teams.php?l=English%20Premier%20League
/api/v1/json/3/search_all_teams.php?s=Soccer&c=Spain
List All teams details in a league by Id
/api/v1/json/3/lookup_all_teams.php?id=4328
List All players in a team by Team Id
/api/v1/json/3/lookup_all_players.php?id=133604
List all users loved teams and players
/api/v1/json/3/searchloves.php?u=zag
Lookups
League Details by Id
/api/v1/json/3/lookupleague.php?id=4346
Team Details by Id
/api/v1/json/3/lookupteam.php?id=133604
Player Details by Id
/api/v1/json/3/lookupplayer.php?id=34145937
Venue Details by Id
/api/v1/json/3/lookupvenue.php?id=16163
Event Details by Id
/api/v1/json/3/lookupevent.php?id=441613
Event Statistics by Id
/api/v1/json/3/lookupeventstats.php?id=1032723
Event Lineup by Id
/api/v1/json/3/lookuplineup.php?id=1032723
List timeline for events by event ID
/api/v1/json/3/lookuptimeline.php?id=1032718
Player Honours by Player Id
/api/v1/json/3/lookuphonours.php?id=34147178
Player Milestones by Player Id
/api/v1/json/3/lookupmilestones.php?id=34161397
Player Former Teams by Player Id
/api/v1/json/3/lookupformerteams.php?id=34147178
Player Contracts by Player Id
/api/v1/json/3/lookupcontracts.php?id=34147178
Event Player Results by Event Id
/api/v1/json/3/eventresults.php?id=652890
Event TV by Event Id
/api/v1/json/3/lookuptv.php?id=584911
Lookup Table by League ID and Season
/api/v1/json/3/lookuptable.php?l=4328&s=2020-2021 * Featured Soccer Leagues only
Lookup Equipment by Team ID
/api/v1/json/3/lookupequipment.php?id=133597
Schedules
Next 5 Events by Team Id
/api/v1/json/3/eventsnext.php?id=133602
Next 15 Events by League Id
/api/v1/json/3/eventsnextleague.php?id=4328
Last 5 Events by Team Id (Limited to home team for free tier)
/api/v1/json/3/eventslast.php?id=133602
Last 15 Events by League Id
/api/v1/json/3/eventspastleague.php?id=4328
Events in a specific round by league id/round/season
/api/v1/json/3/eventsround.php?id=4328&r=38&s=2014-2015
Events on a specific day
/api/v1/json/3/eventsday.php?d=2014-10-10
/api/v1/json/3/eventsday.php?d=2014-10-10&s=Soccer
/api/v1/json/3/eventsday.php?d=2014-10-10&l=4356
/api/v1/json/3/eventsday.php?d=2014-10-10&l=Australian_A-League
TV Events on a day (By Sport/Date/TV Station Country)
/api/v1/json/3/eventstv.php?d=2018-07-07
/api/v1/json/3/eventstv.php?d=2018-07-07&s=Fighting
/api/v1/json/3/eventstv.php?d=2019-09-28&a=United%20Kingdom&s=Cycling
/api/v1/json/3/eventstv.php?c=Peacock_Premium
All events in specific league by season (Free tier limited to 100 events)
/api/v1/json/3/eventsseason.php?id=4328&s=2014-2015
NOTE: These round numbers relate to special strings:
Round 125 = Quarter-Final
Round 150 = Semi-Final
Round 160 = Playoff
Round 170 = Playoff Semi-Final
Round 180 = Playoff Final
Round 200 = Final
Round 500 = Pre-Season
Images
Preview Images
Most of the time you won't want to download the original large image, just get a small preview.
This is possible simple by adding ''/preview'' onto the end URL. This will give you a small 200px version.
Original -
/images/media/league/fanart/xpwsrw1421853005.jpg
Medium 500px -
/images/media/league/fanart/xpwsrw1421853005.jpg/medium
Small 250px -
/images/media/league/fanart/xpwsrw1421853005.jpg/small
Tiny 50px -
/images/media/league/badge/pdd43f1610891709.png/tiny
Video Highlights
Latest Event Youtube Highlights
/api/v1/json/{APIKEY}/eventshighlights.php
/api/v1/json/{APIKEY}/eventshighlights.php?d=2019-10-13
/api/v1/json/{APIKEY}/eventshighlights.php?d=2019-10-12&l=WTA%20Tour
/api/v1/json/{APIKEY}/eventshighlights.php?l=MLB
/api/v1/json/3/eventshighlights.php?i=4329
/api/v1/json/{APIKEY}/eventshighlights.php?s=Soccer
/api/v1/json/{APIKEY}/eventshighlights.php?s=Soccer&d=2020-02-15
Larger API Limits
Show ALL events from season (developer key is limited to 250 events).
/api/v1/json/3/eventsseason.php?id=4424&s=2019
Livescores V1 NOTE: V2 is now recommended for livescore
These are just a static examples for non-patreon
Soccer -
/api/v1/json/3/latestsoccer.php
NCAA Basketball -
/api/v1/json/3/latestncaabasketball.php
NCAA Football -
/api/v1/json/3/latestncaafootball.php
Basketball -
/api/v1/json/3/latestbasketball.php
Am Football -
/api/v1/json/3/latestamericanfootball.php
Ice Hockey -
/api/v1/json/3/latesticehockey.php
Baseball -
/api/v1/json/3/latestbaseball.php
NOTE: Updated LIVE every 2mins for Patreon
V2 API
Authentication
Base URL is = https://www.thesportsdb.com/api/v2/json
Send your API key in the header 'X-API-KEY'
Currently, you need to be a patreon supporter to use v2 of the API.
Signup here
We recomend
HTTPie or
Postman for testing
Example (replace xxxxxx with your api key, found on your profile if you are a paid user):
Livescore V2
/api/v2/json/livescore/Soccer
/api/v2/json/livescore/Basketball
/api/v2/json/livescore/Ice_Hockey
/api/v2/json/livescore/4399
/api/v2/json/livescore/4380
/api/v2/json/livescore/all
example livescore data
Lookups V2 (beta)
/api/v2/json/lookup/league/4328
/api/v2/json/lookup/team/133675
/api/v2/json/lookup/team_equipment/133597
/api/v2/json/lookup/player/34172575
/api/v2/json/lookup/player_contracts/34146304
/api/v2/json/lookup/player_honours/34146304
/api/v2/json/lookup/player_milestones/34146304
/api/v2/json/lookup/player_teams/34146304
/api/v2/json/lookup/event/441613
/api/v2/json/lookup/event_lineup/1937584
/api/v2/json/lookup/event_results/652890
/api/v2/json/lookup/event_stats/1937584
/api/v2/json/lookup/event_timeline/1937584
/api/v2/json/lookup/event_tv/584911
/api/v2/json/lookup/event_highlights/2044892
/api/v2/json/lookup/venue/15910
All V2 (beta)
/api/v2/json/all/countries
/api/v2/json/all/sports
/api/v2/json/all/leagues
List V2 (beta)
/api/v2/json/list/seasons/4328
/api/v2/json/list/seasonposters/4328
/api/v2/json/list/players/133604
/api/v2/json/list/players/Manchester_United
/api/v2/json/list/teams/4328
/api/v2/json/list/teams/English_Premier_League
Search V2 (beta)
/api/v2/json/search/league/English_Premier_League
/api/v2/json/search/team/Manchester_United
/api/v2/json/search/player/Harry_Kane
/api/v2/json/search/venue/Wembley
/api/v2/json/search/event/FIFA_World_Cup_2022-12-18_Argentina_vs_France
/api/v2/json/searchalternate/league/PFL
Filter V2 (beta)
/api/v2/json/filter/events/4328/2003-2004
/api/v2/json/filter/events/day/2024-09-08
/api/v2/json/filter/tv/day/2024-06-22
/api/v2/json/filter/tv/channel/Sky_Sports_Main_Event
/api/v2/json/filter/tv/country/United_Kingdom
/api/v2/json/filter/tv/sport/Motorsport
Schedule V2 (beta)
/api/v2/json/schedule/next/league/4328
/api/v2/json/schedule/previous/league/4328
/api/v2/json/schedule/next/team/133612
/api/v2/json/schedule/previous/team/133612
/api/v2/json/schedule/league/4328/2023-2024