SupportThe API and site will always remain free at point of access. If you love our service and find this site useful you can sign up as a Patreon supporter for
$5 or more to get special features such as livescores. You can cancel anytime. This allows us to pay for the servers and bandwidth and develop new features.
Test API KeysFree users, can use the test API key "2" during development of your app or for educational use(see test links below).
NOTE: The developer key does not include livescores, player lists or YouTube highlight links.
API LimitsDevelopers must not send more than 1 API request per 2 seconds
API Production Key Upgrade$5 Patreon supporters get a dedicated production API key with special features.
Production keys include 2min livescores, Video Highlights and all other upgraded features.
ContactEmail: [email protected] (please state if you are a Patreon Supporter)
SearchSearch for team by name
https://www.thesportsdb.com/api/v1/json/2/searchteams.php?t=Arsenal *Patreon ONLY*
Search for team short code
https://www.thesportsdb.com/api/v1/json/{APIKEY}/searchteams.php?sname={TeamShortCode} *Patreon ONLY*
Search for all players from team *Patreon ONLY*
https://www.thesportsdb.com/api/v1/json/2/searchplayers.php?t=Arsenal
Search for players by name
https://www.thesportsdb.com/api/v1/json/2/searchplayers.php?p=Danny%20Welbeck
https://www.thesportsdb.com/api/v1/json/{APIKEY}/searchplayers.php?t={TeamName}&p={Playername}
Search for event by event name
https://www.thesportsdb.com/api/v1/json/2/searchevents.php?e=Arsenal_vs_Chelsea
https://www.thesportsdb.com/api/v1/json/2/searchevents.php?e=Arsenal_vs_Chelsea&s=2016-2017
Search for event by event file name
https://www.thesportsdb.com/api/v1/json/2/searchfilename.php?e=English_Premier_League_2015-04-26_Arsenal_vs_Chelsea
NOTE: You can replace spaces '%20' with underscores if you want, when requesting multi word strings.
ListList all sports
https://www.thesportsdb.com/api/v1/json/2/all_sports.php
List all leagues
https://www.thesportsdb.com/api/v1/json/2/all_leagues.php
List all countries
https://www.thesportsdb.com/api/v1/json/2/all_countries.php
List all Leagues in a country (limited 50 on free tier)
https://www.thesportsdb.com/api/v1/json/2/search_all_leagues.php?c=England
https://www.thesportsdb.com/api/v1/json/2/search_all_leagues.php?c=England&s=Soccer
List all Seasons in a League
https://www.thesportsdb.com/api/v1/json/2/search_all_seasons.php?id=4328
List all Teams in a League
https://www.thesportsdb.com/api/v1/json/2/search_all_teams.php?l=English%20Premier%20League
https://www.thesportsdb.com/api/v1/json/2/search_all_teams.php?s=Soccer&c=Spain
List All teams details in a league by Id
https://www.thesportsdb.com/api/v1/json/2/lookup_all_teams.php?id=4328 *Patreon ONLY*
List All players in a team by Team Id *Patreon ONLY*
https://www.thesportsdb.com/api/v1/json/2/lookup_all_players.php?id=133604
List all users loved teams and players https://www.thesportsdb.com/api/v1/json/2/searchloves.php?u=zag
LookupsLeague Details by Id
https://www.thesportsdb.com/api/v1/json/2/lookupleague.php?id=4346 *Patreon ONLY*
Team Details by Id
https://www.thesportsdb.com/api/v1/json/2/lookupteam.php?id=133604 *Patreon ONLY*
Player Details by Id
https://www.thesportsdb.com/api/v1/json/2/lookupplayer.php?id=34145937
Event Details by Id
https://www.thesportsdb.com/api/v1/json/2/lookupevent.php?id=441613 *Patreon ONLY*
Event Statistics by Id *Patreon ONLY*
https://www.thesportsdb.com/api/v1/json/2/lookupeventstats.php?id=1032723
Event Lineup by Id *Patreon ONLY*
https://www.thesportsdb.com/api/v1/json/2/lookuplineup.php?id=1032723
List timeline for events by event ID *Patreon ONLY*
https://www.thesportsdb.com/api/v1/json/2/lookuptimeline.php?id=1032718
Player Honours by Player Id
https://www.thesportsdb.com/api/v1/json/2/lookuphonours.php?id=34147178
Player Former Teams by Player Id
https://www.thesportsdb.com/api/v1/json/2/lookupformerteams.php?id=34147178
Player Contracts by Player Id
https://www.thesportsdb.com/api/v1/json/2/lookupcontracts.php?id=34147178
Event Results by Event Id
https://www.thesportsdb.com/api/v1/json/2/eventresults.php?id=652890
Event TV by Event Id *Patreon ONLY*
https://www.thesportsdb.com/api/v1/json/2/lookuptv.php?id=584911
Lookup Table by League ID and Season
https://www.thesportsdb.com/api/v1/json/2/lookuptable.php?l=4328&s=2020-2021
Lookup Equipment by Team ID
https://www.thesportsdb.com/api/v1/json/2/lookupequipment.php?id=133597
SchedulesNext 5 Events by Team Id
https://www.thesportsdb.com/api/v1/json/2/eventsnext.php?id=133602 *Patreon ONLY*
Next 15 Events by League Id
https://www.thesportsdb.com/api/v1/json/2/eventsnextleague.php?id=4328 *Patreon ONLY*
Last 5 Events by Team Id
(Limited to home team for free tier) https://www.thesportsdb.com/api/v1/json/2/eventslast.php?id=133602
Last 15 Events by League Id
https://www.thesportsdb.com/api/v1/json/2/eventspastleague.php?id=4328 *Patreon ONLY*
Events in a specific round by league id/round/season
https://www.thesportsdb.com/api/v1/json/2/eventsround.php?id=4328&r=38&s=2014-2015
Events on a specific day *Patreon ONLY*
https://www.thesportsdb.com/api/v1/json/2/eventsday.php?d=2014-10-10
https://www.thesportsdb.com/api/v1/json/2/eventsday.php?d=2014-10-10&s=Soccer
https://www.thesportsdb.com/api/v1/json/2/eventsday.php?d=2014-10-10&l=4356
https://www.thesportsdb.com/api/v1/json/2/eventsday.php?d=2014-10-10&l=Australian_A-League
TV Events on a day (By Sport/Date/TV Station Country)*Patreon ONLY*
https://www.thesportsdb.com/api/v1/json/2/eventstv.php?d=2018-07-07
https://www.thesportsdb.com/api/v1/json/2/eventstv.php?d=2018-07-07&s=Fighting
https://www.thesportsdb.com/api/v1/json/2/eventstv.php?d=2019-09-28&a=United%20Kingdom&s=Cycling
https://www.thesportsdb.com/api/v1/json/APIKEY/eventstv.php?f=Peacock%20Premium (Future Events)
All events in specific league by season (Free tier limited to 100 events)
https://www.thesportsdb.com/api/v1/json/2/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
ImagesPreview 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 Image - https://www.thesportsdb.com/images/media/league/fanart/xpwsrw1421853005.jpg
Small 250px Image - https://www.thesportsdb.com/images/media/league/fanart/xpwsrw1421853005.jpg/preview
Tiny 50px Image - https://www.thesportsdb.com/images/media/league/badge/pdd43f1610891709.png/tiny *badges only
Video Highlights (Patreon only)Latest Event Youtube Highlights
https://www.thesportsdb.com/api/v1/json/{APIKEY}/eventshighlights.php
https://www.thesportsdb.com/api/v1/json/{APIKEY}/eventshighlights.php?d=2019-10-13
https://www.thesportsdb.com/api/v1/json/{APIKEY}/eventshighlights.php?d=2019-10-12&l=WTA%20Tour
https://www.thesportsdb.com/api/v1/json/{APIKEY}/eventshighlights.php?l=MLB
https://www.thesportsdb.com/api/v1/json/{APIKEY}/eventshighlights.php?s=Soccer
https://www.thesportsdb.com/api/v1/json/{APIKEY}/eventshighlights.php?s=Soccer&d=2020-02-15
Larger API Limits (Patreon only)Show ALL events from season (developer key is limited to 250 events). Usefull for MLB and NHL listings.
https://www.thesportsdb.com/api/v1/json/2/eventsseason.php?id=4424&s=2019
Livescores V1 (Patreon only) NOTE: V2 is now recommended for livescore
These are just a static examples for non-patreon
Soccer https://www.thesportsdb.com/api/v1/json/2/latestsoccer.php
NCAA Basketball https://www.thesportsdb.com/api/v1/json/2/latestncaabasketball.php
NCAA Football https://www.thesportsdb.com/api/v1/json/2/latestncaafootball.php
Basketball https://www.thesportsdb.com/api/v1/json/2/latestbasketball.php
American Football https://www.thesportsdb.com/api/v1/json/2/latestamericanfootball.php
Ice Hockey https://www.thesportsdb.com/api/v1/json/2/latesticehockey.php
Baseball https://www.thesportsdb.com/api/v1/json/2/latestbaseball.php
NOTE: Updated LIVE every 2mins for Patreon
Livescore V2 (Alpha Patreon only)
https://www.thesportsdb.com/api/v2/json/APIKEY/livescore.php?s=Soccer
https://www.thesportsdb.com/api/v2/json/APIKEY/livescore.php?s=Basketball
https://www.thesportsdb.com/api/v2/json/APIKEY/livescore.php?s=Ice_Hockey
https://www.thesportsdb.com/api/v2/json/APIKEY/livescore.php?l=4399
https://www.thesportsdb.com/api/v2/json/APIKEY/livescore.php?l=4387
https://www.thesportsdb.com/api/v2/json/APIKEY/livescore.php?l=4380
NOTE: All v2 events link to events on our site directly.