Rankings

GET

https://api.datasportsapi.com/v2/rankings

Plan: All plans
Auth: Bearer dsa_live_…
Parameters: 0 required · 1 optional
Returns: RankingTypeInfo[]

Lists every ranking DataSportsAPI provides: FIFA (men), UEFA coefficients for countries and clubs, World Rugby (men), ATP and WTA singles in both official and live form, UTR ratings (men and women), padel world rankings (men and women), and the divisions of the UFC and of Fight Nation Championship.

Worth knowing

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.

01Parameters

Name	In	Required	Description
`sport`	query	Optional	sport slug; limits the list to rankings of that sport

sportqueryOptional
sport slug; limits the list to rankings of that sport

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/rankings"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data: RankingTypeInfo[]
meta: count, and sport when a sport filter was applied

ObjectsRankingTypeInfo

Example response

4 lines

{ "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 } }

04Errors

400bad_request
the sport is not recognised

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code