GoSportsAPIDocs
Sign InGet API Key
Tennis / Rankings

Get Rankings

Retrieve the latest ATP and WTA singles rankings, with points and movement since the previous release.

GET/v1/tennis/rankings

Parameters

NameTypeRequiredDescription
x-api-keystringRequiredYour API key, sent as a header.
tourstringRequiredATP or WTA.
datedateOptionalRelease date (YYYY-MM-DD). Defaults to the latest.
player_idintegerOptionalReturn only this player’s ranking.
pageintegerOptionalPage number. Default 1, 50 per page.

Response

  • dataarray<Ranking>
    Players ordered by rank.
  • rankinteger
    Current ranking.
  • playerobject
    id, name and country.
  • pointsinteger
    Ranking points.
  • movementinteger
    Places gained or lost since the last release.
  • metaobject
    tour, date and total.

Status codes

  • 200Rankings returned
  • 400Invalid parameter
  • 401Missing or invalid API key
  • 429Rate limit reached