Getting live-scores

On this reference page, we explain how you can obtain the score of the matches that are currently played around the world.

NOTE: In our football API endpoints there are 2 ids for each football match. First, it is the fixture id, it is solely for the purpose of keeping track of scheduled matches. The fixture id is different than the match id, which is the second ID that we use. Every match gets an ID when it is about to start. Once the match is over and it goes into the history database this match id persists and remains the same. The fixture id and match id for the same match are totally different. That's why we have the fixture_id field both in the live-score api endpoint and in the history api endpoint.

ENDPOINT

You have several options for filtering the live scores when using this football API endpoint. You can get the list of all matches using the explanation in the first section of this page. To get the scores for a certain competition or certain country only, you will need to provide the ids of the country or competition. This functionality is explained in the second and third parts of this reference.

In order to get the live-scores of currently played football matches, the only thing you need to do is the call the url bellow. Once a game has finished, it will stay in the live-score feed for up to 3 hours more. For example, if the game has ended after the regular time of 90 minutes it will be available in the feed with a status of FINISHED for another hour and 15 minutes. If there is extra time, the game will be available for 45 minutes more after the extra time has ended.

In this example, we have used the demo api key and secret pair. If you login in, you will see all examples with your own api key and api secret

PARAMETERS

The live-scores api endpoint supports several parameters that help you filter matches based on country, competition, competitions, or team. There is also a parameter that allow you to translate some of the data in different languages.

REPONSE

The response contains the following information for every match element in the list. The response data and its types is the same both for the JSON and XML data responses.

{
    "success": true,
    "data": {
        "match": [
            {
                "scheduled": "13:00",
                "competition_id": 165,
                "ps_score": "",
                "location": "Stadioni Tamaz Stepania",
                "odds": {
                    "live": {
                        "X": 3.3,
                        "1": 1.65,
                        "2": 5
                    },
                    "pre": {
                        "X": null,
                        "1": null,
                        "2": null
                    }
                },
                "last_changed": "2021-06-08 14:53:02",
                "competition_name": "Erovnuli Liga 2",
                "home_id": 1399,
                "score": "2 - 2",
                "id": 257578,
                "away_name": "FC Merani Martvili",
                "time": "90+",
                "away_id": 5996,
                "ht_score": "1 - 1",
                "home_name": "Sioni Bolnisi",
                "added": "2021-06-08 13:03:02",
                "h2h": "https:\/\/livescore-api.com\/api-client\/teams\/head2head.json?key=demo_key&team2_id=5996&secret=demo_secret&team1_id=1399",
                "status": "ADDED TIME",
                "has_lineups": false,
                "ft_score": "",
                "events": "https:\/\/livescore-api.com\/api-client\/scores\/events.json?key=demo_key&secret=demo_secret&id=257578",
                "fixture_id": 1433692,
                "et_score": "",
                "outcomes": {
                    "half_time": "X",
                    "full_time": null,
                    "extra_time": null
                },
                "info": "This match is only supported through the new competitions structure"
            },
            {
                "scheduled": "13:00",
                "competition_id": 165,
                "ps_score": "",
                "location": "",
                "odds": {
                    "live": {
                        "X": 4,
                        "1": 1.65,
                        "2": 2.1
                    },
                    "pre": {
                        "X": null,
                        "1": null,
                        "2": null
                    }
                },
                "last_changed": "2021-06-08 14:53:02",
                "competition_name": "Erovnuli Liga 2",
                "home_id": 4844,
                "score": "3 - 2",
                "id": 257579,
                "away_name": "FC Wit Georgia",
                "time": "FT",
                "away_id": 4157,
                "ht_score": "1 - 1",
                "home_name": "Gareji",
                "added": "2021-06-08 13:03:03",
                "h2h": "https:\/\/livescore-api.com\/api-client\/teams\/head2head.json?key=demo_key&team2_id=4157&secret=demo_secret&team1_id=4844",
                "status": "FINISHED",
                "has_lineups": false,
                "ft_score": "3 - 2",
                "events": "https:\/\/livescore-api.com\/api-client\/scores\/events.json?key=demo_key&secret=demo_secret&id=257579",
                "fixture_id": 1433693,
                "et_score": "",
                "outcomes": {
                    "half_time": "X",
                    "full_time": "1",
                    "extra_time": null
                },
                "info": "This match is only supported through the new competitions structure"
            }
        ]
    }
}

EXAMPLES

cUrl:

curl -XGET "https://livescore-api.com/api-client/scores/live.json?key=demo_key&secret=demo_secret"

file_get_contents('https://livescore-api.com/api-client/scores/live.json?key=demo_key\&secret=demo_secret');

import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/scores/live.json?key=demo_key\&secret=demo_secret')
response = urllib2.urlopen(req)
print response.read()

GETTING LIVE-SCORES BY COMPETITION

To get the live-scores only for a certain competition, you have to provide the id of the competition as a get parameter in the api endpoint URL. In the example below, we show you how to get all the live-scores for Italy's Seria A. cUrl:

curl -XGET "https://livescore-api.com/api-client/scores/live.json?key=demo_key&secret=demo_secret&competition_id=4"

file_get_contents('https://livescore-api.com/api-client/scores/live.json?key=demo_key\&secret=demo_secret\&competition_id=4');

import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/scores/live.json?key=demo_key\&secret=demo_secret\&competition_id=4')
response = urllib2.urlopen(req)
print response.read()