Overview
The Soccer Season Power Rankings feed provides season-based Power Rankings for contestants across the globe, at confederation level, and for specific tournament calendars.
The feed includes traditional ranking data such as rank, points, contestant identifiers, contestant names, short names, club names, and contestant codes, together with power-rating metrics such as current rating, highest season rating, lowest season rating, season average rating, current confederation rank, and current global rank at division level.
Problem Statement & Use Cases
This API solves the business problem of comparing soccer teams across different competitions, confederations, and tournament calendars using normalized power-rating and ranking metrics. It supports applications that need mathematically comparable team-strength signals beyond league-specific standings.
Real-world implementations include:
| Use Case |
Description |
| Cross-league team comparison |
Compare contestants from different competitions or confederations using current rating, global rank, and confederation rank. |
| Ranking dashboards |
Build global, confederation, or tournament-calendar-specific power-ranking tables for websites, apps, or broadcast graphics. |
| Predictor models |
Use currentRating, seasonAverageRating, highestSeasonRating, and lowestSeasonRating as features in team-strength or match-outcome models. |
| Historical or date-specific analysis |
Query rankings by rank date to evaluate how team strength changed during a tournament calendar. |
Compliance & Guidelines
Authentication and API Security
To comply with Stats Perform API security and best-practice requirements, refer to the Stats Perform FAQs, API Overview, and Authentication Guide.
Authentication uses the OAuth method to fetch data.
Polling Frequency
Do not exceed the rate confirmed by Stats Perform. Contact a Stats Perform representative for higher rate limits or clarification.
| Feed |
Tier 15 |
Tier 12+14 |
Tier 4 |
Tier 11+13 |
Tier 8+9+10 |
Tier 6+7 |
Tier 5 |
Tier 1+2+3 |
| Season Power Rankings (TM14) |
Once in 24 hours |
Once in 24 hours |
Once in 24 hours |
Once in 24 hours |
Once in 24 hours |
Once in 24 hours |
Once in 24 hours |
Once in 24 hours |
Request Formatting Rules
All URLs are case-sensitive. URL strings must contain the correct case, operators, and required parameters, or the API returns an error.
| Rule |
Requirement |
| Query string start |
Begin the query parameter string with ? immediately after the feed name. |
| Parameter separator |
Separate query parameters with &. |
| Multiple values: AND |
Use & for multiple values where the API treats them as AND. |
| Multiple values: OR |
Use , only if the parameter supports OR-style multiple values. |
| NOT operator |
Use ! only if the parameter supports negation. |
| Underscore-prefixed parameters |
Include the required _ prefix for parameters such as _fmt and _clbk. |
| Placeholder braces |
Remove placeholder curly braces {} from production API calls. They are documentation examples only. |
| Case sensitivity |
Preserve exact URL, parameter, and operator case. |
| Base URL reference |
The base URL format is {protocol}://{requestDomain}/{feedResource}. |
JSONP Requirements
If _fmt=jsonp is used, it must be combined with the callback parameter _clbk.
| Constraint |
Requirement |
Reason |
| JSONP callback |
Use _fmt=jsonp together with _clbk. |
JSONP requires a callback wrapper function. |
| Fixed callback value |
Use a fixed _clbk value whenever possible. |
Random callback names can reduce cacheability and violate API best-practice logic. |
| JavaScript frameworks |
Override framework-generated random callback names, including defaults from common frameworks such as jQuery. |
Some frameworks generate random JSONP function names unless explicitly configured. |
Endpoints
Base URL
https://api.statsperform.com
Feed Resource
/sdapi/v1/soccerdata/seasonpowerrankings
Get Season Power Rankings
GET /sdapi/v1/soccerdata/seasonpowerrankings?{queryParameters}
| Usage |
Feed |
| Get season power ratings according to specified parameter values |
/sdapi/v1/soccerdata/seasonpowerrankings?{queryParameters} |
Example Request Pattern
GET https://api.statsperform.com/sdapi/v1/soccerdata/seasonpowerrankings?_fmt={dataFormat}&{queryParameters}
Query Parameters
This feed uses Global query parameters and the feed-specific query parameters listed below.
The /seasonpowerrankings feed must be queried using the documented parameter combinations.
Feed-Specific Query Parameter Combinations
| Query Parameter Combination |
Description |
Example Request |
confed |
Get Season Power Rankings by confederation. |
GET https://api.statsperform.com/sdapi/v1/soccerdata/seasonpowerrankings?_fmt={dataFormat}&confed=yes |
confed + rank |
Get Season Power Rankings by confederation and rank. |
GET https://api.statsperform.com/sdapi/v1/soccerdata/seasonpowerrankings?_fmt={dataFormat}&confed=yes&rank={1TON} |
tmcl + rank |
Get Season Power Rankings by tournament calendar and rank. |
GET https://api.statsperform.com/sdapi/v1/soccerdata/seasonpowerrankings?_fmt={dataFormat}&tmcl={tournamentCalendarUuid}&rank={1TON} |
tmcl |
Get Season Power Rankings by tournament calendar. |
GET https://api.statsperform.com/sdapi/v1/soccerdata/seasonpowerrankings?_fmt={dataFormat}&tmcl={tournamentCalendarUuid} |
rankDt |
Get Season Power Rankings by rank date. |
GET https://api.statsperform.com/sdapi/v1/soccerdata/seasonpowerrankings?_fmt={dataFormat}&rankDt={YYYY-MM-DD} |
rank |
Get Season Power Rankings by global rank. |
GET https://api.statsperform.com/sdapi/v1/soccerdata/seasonpowerrankings?_fmt={dataFormat}&rank={1TON} |
tmcl + rank + confed |
Get Season Power Rankings by tournament calendar, confederation, and rank. |
GET https://api.statsperform.com/sdapi/v1/soccerdata/seasonpowerrankings?_fmt={dataFormat}&tmcl={tournamentCalendarUuid}&rank={1TON}&confed=yes |
tmcl + rank + rankDt + confed |
Get Season Power Rankings by tournament calendar, confederation, rank, and date. |
GET https://api.statsperform.com/sdapi/v1/soccerdata/seasonpowerrankings?_fmt={dataFormat}&tmcl={tournamentCalendarUuid}&rank={1TON}&confed=yes&rankDt={Date} |
type |
Get Season Power Rankings by type. |
GET https://api.statsperform.com/sdapi/v1/soccerdata/seasonpowerrankings?_fmt={dataFormat}&type={men\|women} |
Parameter Definitions
| Parameter |
Description |
Accepted Values / Format |
Notes |
_fmt |
Response data format. |
{dataFormat} |
Global query parameter. Required in examples. |
_clbk |
JSONP callback function name. |
Fixed callback function name. |
Required when _fmt=jsonp. |
confed |
Filters or groups Season Power Rankings by confederation. |
yes |
Can be used alone or with supported combinations. |
rank |
Filters Season Power Rankings by rank range or rank value. |
{1TON} |
Used for global rank, confederation rank, or tournament-calendar rank queries depending on other parameters. |
tmcl |
Filters Season Power Rankings by tournament calendar. |
{tournamentCalendarUuid} |
Must be an active tournament calendar unless combined with a valid date parameter. |
rankDt |
Filters Season Power Rankings by ranking date. |
YYYY-MM-DD or {Date} |
Date should fall within the tournament calendar when querying inactive tournament calendars. |
type |
Filters Season Power Rankings by ranking type. |
men, women |
Defaults to men when omitted. Restricted from use with tmcl. |
Tournament Calendar Constraints
Calling by tmcl only pulls data from today's date, so an active tmcl must be used.
| Constraint |
Requirement |
| Active tournament calendar |
If querying only by tmcl, the tournament calendar must be active on the request date. |
| Inactive tournament calendar |
To use an inactive tmcl, include a date parameter. The date must be during the specified tournament calendar. |
Type Parameter Constraints
Default feed requests without the type query parameter and requests with type=men return men's power rankings.
Women's power rankings require type=women.
The type query parameter cannot be supplied with tmcl; the combination tmcl + type is restricted.
| Constraint |
Supported Combination |
type alone |
Supported. |
type=men |
Supported; equivalent to default men's power rankings. |
type=women |
Supported; returns women's power rankings. |
type + tmcl |
Not supported. |
type + confed |
Use documented supported combinations only. |
type + rank |
Use documented supported combinations only. |
type + rankDt |
Use documented supported combinations only. |
When using the type query parameter, only the type parameter or one of the following non-tmcl combinations can be supplied in the API request:
Allowed Non-tmcl Combination |
confed |
confed + rank |
rank |
rankDt |
Output Schema
The feed response fields are documented using XML element names. JSON responses contain similar fields, but some XML-only nodes are omitted or represented differently.
`<season
PowerRankings>`
| Property |
Value |
| Format |
XML only |
| Nesting |
seasonPowerRankings |
| Description |
Required root element of the fields related to the Season Power Rankings feed information. |
| JSON behavior |
Not present in JSON feed response. In JSON, the root attribute is lastUpdated and the root element is competition. |
| Attribute |
Required |
Description |
Values |
lastUpdated |
Yes |
UTC date and time when the Season Rankings feed information or record was last updated. |
Date/Time in format YYYY-MM-DDThh:mm:ssZ |
<competition>
| Property |
Value |
| Nesting |
seasonPowerRankings/competition |
| Description |
Required root element of the fields related to the competition. |
| Attribute |
Required |
Description |
Values |
id |
Yes |
Unique ID of the competition. |
String; alphanumeric UUID |
name |
Yes |
Name of the competition. |
String |
sponsorName |
Yes |
Sponsor name of the competition. |
String |
`<tournament
Calendar>`
| Property |
Value |
| Nesting |
seasonPowerRankings/tournamentCalendar |
| Description |
Required root element of the fields related to a tournament calendar. |
| XML value |
String giving the tournament calendar name. |
| Attribute |
Required |
Description |
Values |
id |
Yes |
Unique ID of the tournament calendar. |
String; alphanumeric UUID |
ocId |
No |
Unique Opta Core tournament calendar ID. Returned only if the feed is queried by Opta Core legacy ID; otherwise not present. Empty string if no value exists. |
String |
opId |
No |
Unique Opta tournament calendar ID. Returned only if the feed is queried by Opta legacy ID; otherwise not present. Empty string if no value exists. |
String |
startDate |
Yes |
Start date in UTC of the tournament calendar. |
Date in format YYYY-MM-DDZ |
endDate |
Yes |
End date in UTC of the tournament calendar. |
Date in format YYYY-MM-DDZ |
highestTeamRating |
No |
Highest Power Rating of the team in a tournament calendar. |
Decimal |
lowestTeamRating |
No |
Lowest Power Rating of the team in a tournament calendar. |
Decimal |
averageTeamRating |
No |
Average Power Rating of the team in a tournament calendar. |
Decimal |
confederationCompRank |
No |
Rank of a team within a confederation based on its current power rating in a tournament calendar. |
Integer |
globalCompRank |
No |
Global rank of a team based on its current power rating in a tournament calendar. |
Integer |
name |
Yes |
Name of the tournament calendar. JSON only. |
String |
<division>
| Property |
Value |
| Nesting |
seasonPowerRankings/division |
| Description |
Required root element of the fields related to the division. |
| Attribute |
Required |
Description |
Values |
type |
No |
Type of the division. |
String |
<ranking>
| Property |
Value |
| Nesting |
seasonPowerRankings/division/ranking |
| Description |
Optional element holding information about ranking details in the division. |
| Attribute |
Required |
Description |
Values |
leagueUuid |
No |
Unique UUID of the competition the associated team is playing in. |
String; alphanumeric UUID |
countryUuid |
No |
Unique UUID of the country to which the associated team belongs. |
String; alphanumeric UUID |
leagueConfederationRank |
No |
Competition ranking within its associated confederation, measured by average team rating. |
String |
leagueGlobalRank |
No |
Competition global ranking, measured by average team rating. |
String |
confederationUuid |
No |
Unique UUID of the confederation where the associated team is based. |
String; alphanumeric UUID |
rank |
Yes |
Rank in the division. |
Integer |
contestantId |
Yes |
Unique ID of the contestant. |
String; alphanumeric UUID |
contestantName |
No |
Name of the contestant. |
String |
contestantShortName |
No |
Short name commonly used to refer to the contestant. |
String |
contestantClubName |
No |
Club name of the contestant. |
String |
contestantCode |
No |
Three-character code used for the contestant name, often used on TV scoreboards. |
String |
currentRating |
No |
Current power rating of a team. |
Decimal |
highestSeasonRating |
No |
Rating of the best team in the league. |
Decimal |
lowestSeasonRating |
No |
Rating of the worst team in the league. |
Decimal |
seasonAverageRating |
No |
Average rating of the teams in the league. |
Decimal |
currentConfederationRank |
No |
Current confederation rank of the contestant. |
Integer |
currentGlobalRank |
No |
Current global rank of the contestant. |
Integer |
