Support
The 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 Keys
Free users, can use the test API key "1" during development of your app or for educational use(see test links below).
NOTE: The developer key does not include livescores or YouTube highlight links.

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.

Contact
Email: zag (at) kodi.tv (please state if you are a Patreon Supporter)

Search

Search for team by name
https://www.thesportsdb.com/api/v1/json/1/searchteams.php?t=Arsenal

Search for team short code
https://www.thesportsdb.com/api/v1/json/{APIKEY}/searchteams.php?sname={TeamShortCode}

Search for all players from team
https://www.thesportsdb.com/api/v1/json/1/searchplayers.php?t=Arsenal

Search for players by name
https://www.thesportsdb.com/api/v1/json/1/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/1/searchevents.php?e=Arsenal_vs_Chelsea
https://www.thesportsdb.com/api/v1/json/1/searchevents.php?e=Arsenal_vs_Chelsea&s=1617

Search for event by event file name
https://www.thesportsdb.com/api/v1/json/1/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.

List

List all sports
https://www.thesportsdb.com/api/v1/json/1/all_sports.php

List all leagues
https://www.thesportsdb.com/api/v1/json/1/all_leagues.php

List all Leagues in a country
https://www.thesportsdb.com/api/v1/json/1/search_all_leagues.php?c=England
https://www.thesportsdb.com/api/v1/json/1/search_all_leagues.php?c=England&s=Soccer

List all Seasons in a League
https://www.thesportsdb.com/api/v1/json/1/search_all_seasons.php?id=4328

List all Teams in a League
https://www.thesportsdb.com/api/v1/json/1/search_all_teams.php?l=English%20Premier%20League
https://www.thesportsdb.com/api/v1/json/1/search_all_teams.php?s=Soccer&c=Spain

List All teams details in a league by Id
https://www.thesportsdb.com/api/v1/json/1/lookup_all_teams.php?id=4328

List All players in a team by Team Id
https://www.thesportsdb.com/api/v1/json/1/lookup_all_players.php?id=133604

List all users loved teams and players
https://www.thesportsdb.com/api/v1/json/1/searchloves.php?u=zag

Lookups

League Details by Id
https://www.thesportsdb.com/api/v1/json/1/lookupleague.php?id=4346

Team Details by Id
https://www.thesportsdb.com/api/v1/json/1/lookupteam.php?id=133604

Player Details by Id
https://www.thesportsdb.com/api/v1/json/1/lookupplayer.php?id=34145937

Event Details by Id
https://www.thesportsdb.com/api/v1/json/1/lookupevent.php?id=441613

Player Honours by Player Id
https://www.thesportsdb.com/api/v1/json/1/lookuphonors.php?id=34147178

Player Former Teams by Player Id
https://www.thesportsdb.com/api/v1/json/1/lookupformerteams.php?id=34147178

Player Contracts by Player Id
https://www.thesportsdb.com/api/v1/json/1/lookupcontracts.php?id=34147178

Event TV by Event Id
https://www.thesportsdb.com/api/v1/json/1/lookuptv.php?id=584911

Lookup Table by League ID and Season
https://www.thesportsdb.com/api/v1/json/1/lookuptable.php?l=4328&s=1819
https://www.thesportsdb.com/api/v1/json/1/lookuptable.php?l=4328&s=1213

Schedules

Next 5 Events by Team Id
https://www.thesportsdb.com/api/v1/json/1/eventsnext.php?id=133602

Next 15 Events by League Id
https://www.thesportsdb.com/api/v1/json/1/eventsnextleague.php?id=4328

Last 5 Events by Team Id
https://www.thesportsdb.com/api/v1/json/1/eventslast.php?id=133602

Last 15 Events by League Id
https://www.thesportsdb.com/api/v1/json/1/eventspastleague.php?id=4328

Events in a specific round by league id/round/season
https://www.thesportsdb.com/api/v1/json/1/eventsround.php?id=4328&r=38&s=1415

Events on a specific day
https://www.thesportsdb.com/api/v1/json/1/eventsday.php?d=2014-10-10
https://www.thesportsdb.com/api/v1/json/1/eventsday.php?d=2014-10-10&s=Soccer
https://www.thesportsdb.com/api/v1/json/1/eventsday.php?d=2014-10-10&l=Australian_A-League


TV Events on a day (By Sport/Date/TV Station Country)
https://www.thesportsdb.com/api/v1/json/1/eventstv.php?d=2018-07-07
https://www.thesportsdb.com/api/v1/json/1/eventstv.php?d=2018-07-07&s=Fighting
https://www.thesportsdb.com/api/v1/json/1/eventstv.php?d=2019-09-28&a=United%20Kingdom&s=Cycling

TV Events on a channel (Latest)
https://www.thesportsdb.com/api/v1/json/1/eventstv.php?c=TSN_1

All events in specific league by season
https://www.thesportsdb.com/api/v1/json/1/eventsseason.php?id=4328&s=1415

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. This will work with JPG images only.
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

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

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/1/eventsseason.php?id=4424&s=2019

Livescores (Patreon only)

Soccer Livescores
https://www.thesportsdb.com/api/v1/json/1/latestsoccer.php (this is just a static example for non-patreon)
NOTE: Updated every 2mins for Patreon

Golf Livescores
https://www.thesportsdb.com/api/v1/json/1/latestgolf.php (this is just a static example for non-patreon)
NOTE: Updated every 2mins for Patreon

Basketball Livescores
https://www.thesportsdb.com/api/v1/json/1/latestbasketball.php (this is just a static example for non-patreon)
NOTE: Updated every 2mins for Patreon

American Football Livescores
https://www.thesportsdb.com/api/v1/json/1/latestamericanfootball.php (this is just a static example for non-patreon)
NOTE: Updated every 2mins for Patreon