API Tutorial and Examples

Intro

Our free sports API has been designed to be easy to use and quick to get working.
All our V1 API methods should work in a standard browser with the jsonview extension.
Or for v2 API try HTTPie, Postman or a Chrome extension

V1 API

PHP

Simple example here to show the teams badge after a name search for "Arsenal".

$json = file_get_contents("https://www.thesportsdb.com/api/v1/json/3/searchteams.php?t=Arsenal");
$json_decoded = (json_decode($json));
echo 'Team Badge = ' . ($json_decoded->teams[0]->strBadge);

Python

Here we are looking up certain events by ID and printing the output to the console.

import requests

def lookup_events(event_ids):
    for event_id in event_ids:
        api_call = requests.get(f"https://www.thesportsdb.com/api/v1/json/3/lookupevent.php?id={event_id}")
        storage = api_call.json()
        for event in storage["events"]:
            date_event = event["dateEvent"]
            home_team = event["strHomeTeam"]
            away_team = event["strAwayTeam"]

        print(f"{date_event}: {home_team} vs {away_team}")

event_ids = [2052711, 2052712, 2052713, 2052714]

lookup_events(event_ids)

Javascript

Just reading the JSON file here and outputting the entire payload to the console

function fetchJSONData() {
            fetch("https://www.thesportsdb.com/api/v1/json/3/searchteams.php?t=Arsenal")
                .then((res) => {
                    if (!res.ok) {
                        throw new Error
                            (`HTTP error! Status: ${res.status}`);
                    }
                    return res.json();
                })
                .then((data) => 
                      console.log(data))
                .catch((error) => 
                       console.error("Unable to fetch data:", error));
        }
        fetchJSONData();

V2 API

Command Line

Lets show the livescores using curl on the command line of Linux, Windows or Mac

curl -X GET https://www.thesportsdb.com/api/v2/json/livescore/Soccer -H "X-API-KEY: xxxxxx" -L
						

PHP

Showing Livescore using CURL and PHP

$apiKey = "xxxxxx";
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, "https://www.thesportsdb.com//api/v2/json/livescore/Soccer");
curl_setopt($curl, CURLOPT_HTTPGET, 1);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, array('X-API-KEY:' . $apiKey));
$result = curl_exec($curl);
$json = json_decode($result);
var_dump($json);
						

Python

Get League data using Python

import requests

url = "https://www.thesportsdb.com/api/v2/json/all/leagues"
api_key = xxxxxx

headers = {
    "X-API-KEY": f"{api_key}",
    "Content-Type": "application/json"
}

response = requests.get(url, headers = headers)

if response.status_code == 200:
    print(response.json())
else:
    print(f"Request failed with status code: {response.status_code}")
						

Javascript

Get League data using Javascript

var fbURLv2="https://www.thesportsdb.com/api/v2/json/all/leagues";
var commentdata = "";
$.ajax({
    url: fbURLv2,
    data: "message="+commentdata,
    dataType: "json",
    type: 'POST',
    beforeSend: function(xhr) {
        xhr.setRequestHeader('X-API-KEY', 'xxxxxx');
        xhr.setRequestHeader('Content-Type', 'application/json');
    },
    // If success         
    success: function (resp) {
        console.log(resp);
    },
    // If error
    error: function(e) {
        console.log(e);
    }
});