Getting League Standings

The football league standings api endpoint supports teams names in various languages to find out more about this. Read through our documentation on language support.

Standings is a vital part of the football data that people are interested in. It is no longer that only the livescores, fixtures, or history data matters. We provide our subscribers with the possibility to get the current standings of a league using this dedicated endpoint.



Seasons

Before you are able to get the data for a specific league you have to know the id of the season for which you want the standings for. As we know every season there is a new table with new and new statistics in it. In the table bellow, we have outlined the season that we have and which are their respective ids as well as some example leagues that might have standings for this season.

In our football data there are 2 kinds of season. Whole calendar year season e.g. 2020 or a autumn/spring season e.g. 2018/2019. The season which a league might have depends on the times in which it takes place. For example, the English Premier League, since it starts in the autumn and ends in the spring, it will get the second type of season (2018/2019). Leagues like the Swedish Allsvenskan and the Brazileiro which start in the beginning of the calendar year and are completed towards the end of the same year, get the the first type of season format (2017). When it comes to qualifiers for international tournaments involving national teams the season for the qualification group standings is the same as the season in which the final tournament will take place. For example, the season for the UEFA EURO Qualifiers Groups is (2020)!

Season ID Name Example Leagues
1 2018 Allsvenskan, Brazileiro
2 2018/2019 Champions League, English Premier League, Serie A
3 2019 Allsvenskan, Brazileiro
4 2019/2020 Champions League, English Premier League, Serie A
5 2020 UEFA EURO, UEFA EURO Qualifiers, Allsvenskan, Brazileiro

Endpoint

In order to get the standings table for a football league from our api the only thing you need to do is the call the url bellow. We are supporting table standings data for leagues and competitions for 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 history API endpoint supports several parameters that you can use to filter the football 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.

NameTypeRequiredExampleDescription
leaguenumberYes25 Indicates for which league you want to get the standings table for
seasonnumberYes2 Indicates for which season you are getting the standings table for
langstringNoru2 letter ISO 639-1 language code which will translate the names of the teams to your desired language. To find out more about the languages we support you can check our dedicated football data language support page

Response

A response to a request will contain all the teams in the table standings with their relevant information. There is a JSON example bellow this table with just a fraction of the teams participating in the English Premier League. An actual response will contain all 20 teams, it is just too big for us to put all of the data in this page.

NameTypeExampleDescription
league_id integer25 The id of league which standings you have requested
season_id integer2 The id of the season for which you have requested the table standings
name stringManchester CityThe name of the team in the requested language.
rank integer1 the rank in the standings table that the team occupies
points integer76 number of points accumulated
matches integer31 the number of matches that the team has player
goal_diff integer52 the goal difference of the team, if it is negative, it will be a negative number e.g. -6
goals_scored integer70 the number of goals the team scored in their opponents goals
goals_conceded integer18 the number of goals the team conceded in their own goal
lost integer1 the number of games the team lost
drawn integer7 the number of drawn matches
won integer23 the number of matches the team won
team_id integer7 the id of the team in our database
{
    "success": true,
    "data": {
        "table": [
            {
                "league_id": "25",
                "season_id": "2",
                "name": "Liverpool",
                "rank": "1",
                "points": "76",
                "matches": "31",
                "goal_diff": "52",
                "goals_scored": "70",
                "goals_conceded": "18",
                "lost": "1",
                "drawn": "7",
                "won": "23",
                "team_id": "7"
            },
            {
                "league_id": "25",
                "season_id": "2",
                "name": "Manchester City",
                "rank": "2",
                "points": "74",
                "matches": "30",
                "goal_diff": "58",
                "goals_scored": "79",
                "goals_conceded": "21",
                "lost": "4",
                "drawn": "2",
                "won": "24",
                "team_id": "12"
            },
            {
                "league_id": "25",
                "season_id": "2",
                "name": "Tottenham Hotspur",
                "rank": "3",
                "points": "61",
                "matches": "30",
                "goal_diff": "25",
                "goals_scored": "57",
                "goals_conceded": "32",
                "lost": "9",
                "drawn": "1",
                "won": "20",
                "team_id": "15"
            },
            {
                "league_id": "25",
                "season_id": "2",
                "name": "Arsenal",
                "rank": "4",
                "points": "60",
                "matches": "30",
                "goal_diff": "24",
                "goals_scored": "63",
                "goals_conceded": "39",
                "lost": "6",
                "drawn": "6",
                "won": "18",
                "team_id": "18"
            },
            {
                "league_id": "25",
                "season_id": "2",
                "name": "Manchester United",
                "rank": "5",
                "points": "58",
                "matches": "30",
                "goal_diff": "18",
                "goals_scored": "58",
                "goals_conceded": "40",
                "lost": "6",
                "drawn": "7",
                "won": "17",
                "team_id": "19"
            }
        ]
    }
}

Examples

The following examples show you how to use this endpoint in various programming languages. In the examples bellow we have used the English Premier League as an example, but it could be any other league that has standings. 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/leagues/table.json?key=demo_key\\&secret=demo_secret\\&league=25\\&season=2
PHP
file_get_contents('http://livescore-api.com/api-client/leagues/table.json?key=demo_key\&secret=demo_secret\&league=25\&season=2');
Python
import urllib2
req = urllib2.Request('http://livescore-api.com/api-client/leagues/table.json?key=demo_key\&secret=demo_secret\&league=25\&season=2')
response = urllib2.urlopen(req)
print response.read()