Standings, also known as rankings, show the positions of the teams competing in a season.
Standings show the total number of games played, won, lost, the number of goals for and against and the number of points they have accumulated.
So, how do you request all of this data yourself? We’re going to show you how! In this tutorial, we will first show you how to request standings for the English Premier League season 20/21 (season id: 17420 ).
Afterward, we’ll go more in-depth with an example about the Champions League’s standings. We’ll then show you how to request standings for groups and stages. And finally, how to request live standings!
Let’s get started.
Domestic league standings
The English Premier League is an example of a domestic league, similar to the Italian Serie A, German Bundesliga, etc.
For ‘normal’ domestic Leagues, the response format is different compared to Cups.
If you have Cups and ‘normal’ leagues in your plan, make sure to check out the response correctly. Let’s look at one of the most requested leagues: the Champions League 2020/2021 season (league id: 2 and season id: 17299).
You can use the same endpoint as with a standard league. However, the response will be very different.
The unique team id of the team in that position in the group
The team name in that position in the group
The unique id of the current round
The name of the round
The unique id of the group, in which the team participates in
The name of the group, in which the team participates in
The overall results of the team, i.e., the number of games, points and goals
The home results of the team, i.e., the number of games, points and goals
The away results of the team, i.e., the number of games, points and goals
The total points of the team and their goal difference
The standing rules of the place the team is in
The accumulated number of points the team has
The recent form of the team
Will be available in API 3.0: Indicates if the team moves up on down based on the last standings.
As you can see, the standings are grouped by ... groups!
We can’t stress this enough. It’s paramount that you read the response correctly.
Due to our unique group ids, you can also request the specific groups you’re interested in with the group_ids parameter.
Let’s say you only want the standings of Group C. You can add the group_idsparameter with the group id of Group C (244367) to the request. You can also request multiple groups by separating them with a comma.