LIVE FOOTBALL SCORES DATA

Every match being played now, with the score, the minute and the events so far. Part of membership.

EVERY MATCH IN PLAY

/v1/live gives every match being played now in the competitions your key reads, with the score and the minute. competition keeps to one.

curl "https://api.footballapi.org/v1/live" \
  -H "X-API-Key: your key"

import requests

r = requests.get(
    "https://api.footballapi.org/v1/live",
    headers={"X-API-Key": "your key"},
)
print(r.json()["data"])

const res = await fetch("https://api.footballapi.org/v1/live", {
  headers: { "X-API-Key": "your key" },
});
const { data } = await res.json();
console.log(data);

$ch = curl_init("https://api.footballapi.org/v1/live");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-API-Key: your key"],
]);
$data = json_decode(curl_exec($ch), true)["data"];
print_r($data);

ONE MATCH

/v1/live/{match_id} gives a match with its events so far. The match_id is the same one the fixture had, and the result will have.

HOW OFTEN TO CALL

Answers refresh every 5 seconds, so calling more often than that returns the same answer. Membership allows 120 calls a minute. When a match ends it leaves /v1/live and its result settles in /v1/results.

WHO CAN CALL IT

Live scores are part of membership. On the complimentary key they answer 403 upgrade_required. See membership