Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Discovery

Rankings

GET

/v2/rankings

All plans

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

sport

query

sport slug; limits the list to rankings of that sport

Response

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