Skip to main content

Base URL

https://v2.tennis.sportsapipro.com
Rankings are a tennis-unique feature — not available in the football or basketball APIs. These endpoints return comprehensive ranking data including rank, points, and player details.
Rankings return Team IDs, not Player Entity IDs. To access career endpoints like /api/players/:id/h2h/:opponentId, call GET /api/teams/:teamId first and read the player.id field from the response. See Team ID vs Player Entity ID for details.

ATP Rankings

ATP Singles Rankings

GET /api/rankings
Returns the current ATP Singles rankings (up to 500 players).

ATP Race Rankings

GET /api/rankings/atp-race
Returns the current ATP Race to Turin rankings (calendar year points).

WTA Rankings

WTA Singles Rankings

GET /api/rankings/wta
Returns the current WTA Singles rankings.

WTA Race Rankings

GET /api/rankings/wta-race
Returns the current WTA Race rankings (calendar year points).

Custom Rankings

Rankings by Type ID

GET /api/rankings/type/{typeId}
Returns rankings for a specific ranking type. Only tennis ranking types are allowed.
typeId
number
required
The ranking type ID. Valid tennis types: 5 (ATP alt), 6 (WTA Singles), 7 (ATP Singles), 8 (WTA Race), 34 (ATP Race), 35.
Non-tennis type IDs will return a 400 Bad Request with an error message listing the valid types. This prevents football or other sport data from leaking through the tennis namespace.

Example Requests

curl -X GET "https://v2.tennis.sportsapipro.com/api/rankings" \
  -H "x-api-key: YOUR_API_KEY"