Rankings
GET
/
View as MarkdownTry in Playground →
Every ranking DataSportsAPI provides: FIFA (men), World Rugby (men), UEFA coefficients (countries, clubs), ATP and WTA singles (official, live), UTR ratings and padel world rankings (men and women each). The divisions of the UFC and of Fight Nation Championship are included too.
entry indicates what each row of a ranking represents: team (a club or national side), competitor (a player or fighter, delivered as a TeamRef of kind individual) or country. The list comes from our own catalogue, so no upstream request is made.
Parameters
sportquery
sport slug; limits the list to rankings of that sport
Response
- data
RankingTypeInfo[]- meta
- count, and sport when a sport filter was applied
- errors
- 400
bad_request— the sport is not recognised
Any /v2 call can also come back with one of the common errors.
curl -H "Authorization: Bearer sk_live_…" \
"https://api.datasportsapi.com/v2/rankings"Example
{ "data": [ { "type": "fifa-men", "name": "FIFA World Ranking (men)", "sport": "football", "gender": "male", "entry": "team" },
{ "type": "uefa-countries", "name": "UEFA country coefficients", "sport": "football", "gender": null, "entry": "country" }, …,
{ "type": "atp", "name": "ATP singles ranking", "sport": "tennis", "gender": "male", "entry": "competitor" }, … ],
"meta": { "count": 30 } }