Getting fixtures

In this reference we will show you how you can the list of fixtures that we have for all national leagues and how to interpret the data that we give you.


In this page, we are explaining how you can get the list with currently available fixtures. The possibilities that you have to filter and traverse the football fixtures data. If you want to see for which leagues currently we do support fixtures, you can read the getting list of leagues with fixtures api documentation.

Endpoint

In order to get the list of all fixtures that our football data feed supports the only thing you need to do is the call the url bellow. Currently, we are supporting fixtures for national leagues all over the globe. 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

GET:


Parameters

The fixtures API endpoint supports several parameters that you can use to filter data and traverse through it at your convenience. The parameters are listed in the table below. You can use the parameters together as well as separately.

Parameter Type Option Effect
date yyyy-mm-dd optional Results in showing only fixtures on that date.
league number optional Results in showing only fixtures for that league
page number optional Results in sowing only fixtures on that page with results

Response

A response to a request will contain in total maximum of 30 fixtures for the provided parameters in the query. If you would like to go further in the future you can use the next page like provided by the response. If you would like to go back then you can use the previous page link provided by the response.

  • date - the data when the football match is going to be played.
  • time - the kick-off time of the football match. If we do not have accurate data you will see only zeros.
  • round - the round of the match (a.k.a match day) of the soccer game. If we do not have accurate data you will see 999 as a round number
  • home_name - the name of the home team in the match.
  • away_name - the name of the away team in the match.
  • location - the place or stadium where the match is going to be played or empty if we do not have enough data.
  • league_id - the id of the league to which the match belongs to.
  • next_page - if there are more than 30 matches that satisfy your filtering request you will be able to go to the next page with results following this link. If there is no next page this field will contain false.
  • prev_page - if there are more than 30 matches that satisfy your filtering request and you have traversed into further pages, you will be able to go to the previous page with results following this link. If there is no previous page this field will contain false.
{
    "success": true,
    "data": {
        "fixtures": [
            {
                "date": "2017-10-16",
                "time": "00:30:00",
                "round": "999",
                "home_name": "Santos Laguna",
                "away_name": "Atlas",
                "location": "",
                "league_id": "88"
            },
            {
                "date": "2017-10-16",
                "time": "00:30:00",
                "round": "999",
                "home_name": "O'Higgins",
                "away_name": "Audax Italiano",
                "location": "",
                "league_id": "63"
            },
            {
                "date": "2017-10-16",
                "time": "00:30:00",
                "round": "999",
                "home_name": "Colorado Rapids",
                "away_name": "Real Salt Lake",
                "location": "",
                "league_id": "94"
            }
        ],
        "next_page": "http:\/\/livescore-api.com\/api-client\/fixtures\/matches.json?key=demo_key&secret=demo_secret&page=2",
        "prev_page": false
    }
}


Examples

The following examples show you how to use this endpoint in various programming languages without any filters provided. 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

cUrl curl -XGET http://livescore-api.com/api-client/fixtures/matches.json?key=demo_key\&secret=demo_secret
PHP <?php
file_get_contents('http://livescore-api.com/api-client/fixtures/matches.json?key=demo_key&secret=demo_secret')
?>

Python import urllib2
req = urllib2.Request('http://livescore-api.com/api-client/fixtures/matches.json?key=demo_key&secret=demo_secret')
response = urllib2.urlopen(req)
print response.read()

Copied
Feedback