API Reference

Rankings

The Rankings module provides live world rankings for both singles and doubles categories across ATP and WTA tours. Rankings data is updated regularly to reflect the latest tournament results.

How Rankings Work

Rankings are not a separate table. They are served directly from the Player entity, which stores the current ranking snapshot on each player row. The database is updated whenever ATP/WTA publish their official weekly ranking lists.

A separate Rating table stores historical ranking snapshots — one row per player per date — enabling you to reconstruct ranking history or build charts showing how a player's position changed over time.

Source	What it contains	Use case
Player entity	Current ranking: position, points, progress, surface breakdown	Today's live rankings list
Rating entity	Historical snapshot: `date`, `position`, `point` per player	Ranking history charts, "peak ranking" analysis

Endpoint Summary

GET/tennis/v2/{tour_type}/ranking/singles

GET/tennis/v2/{tour_type}/ranking/doubles

GET/tennis/v2/{tour_type}/ranking/singles?race=true

GET/tennis/v2/ranking/{tour_type}/top

GET/tennis/v2/ranking/{tour_type}/filters

GET/tennis/v2/ranking/{tour_type}/player/{player_id}/history

GET/tennis/v2/ranking/{tour_type}

Get Singles Ranking

GET/tennis/v2/{tour_type}/ranking/singles

Returns the current ATP or WTA singles world rankings, ordered by position.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.

Query Parameter

Parameter	Required	Description
`race`	No	Set to `true` to return the Race to Turin / Race to Fort Worth standings instead of the standard 52-week rankings. Results are sorted by year-to-date race points (`racePoints`) descending. Supports `filter=PlayerCountry` and pagination. Example: `race=true`
`filter`	No	Semicolon-separated filters in `Key:value` format. Available filters: `RankingDate:YYYY - MM - DD` — returns the ranking snapshot on or before this date (standard rankings only, not applicable when `race=true`) `PlayerCountry:USA, GBR` — filter by 3-letter country acronym (works with both standard and race rankings) Example: `filter=RankingDate:2025-01-06;PlayerCountry:ESP,ITA`
`pageSize`	No	Results per page. Default: `10` (standard rankings) / `100` (race rankings).
`pageNo`	No	Page number, 1-indexed. Default: `1`. Example: pageNo=1. Use `hasNextPage` in the response to check for more pages.

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/atp/ranking/singles' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Doubles Rankings

GET/tennis/v2/{tour_type}/ranking/doubles

Returns the current ATP or WTA doubles world rankings, ordered by position.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.

Query Parameter

Parameter	Required	Description
`filter`	No	Semicolon-separated filters in `Key:value` format. Available filters: `PlayerCountry:USA, GBR` — filter by 3-letter country acronym Example: `filter=PlayerCountry:ESP,ITA`

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/atp/ranking/doubles' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Race Rankings (Year-to-Date)

GET/tennis/v2/{tour_type}/ranking/singles?race=true

Returns the Race to Turin (ATP) or Race to Fort Worth (WTA) year-to-date standings, sorted by race points descending.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.

Query Parameter

Parameter	Required	Description
`race`	Yes	Set to `true` to return the Race to Turin / Race to Fort Worth standings instead of the standard 52-week rankings. Results are sorted by year-to-date race points (`racePoints`) descending. Supports `filter=PlayerCountry` and pagination. Example: `race=true`

Add race=true to the singles ranking endpoint to switch from the standard 52-week rolling rankings to the year-to-date race standings. Only players with race points > 0 are returned.

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/atp/ranking/singles?race=true' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Top 10 Rankings

GET/tennis/v2/ranking/{tour_type}/top

Retrieve the latest Top 10 ATP or WTA rankings, including player names, rankings, ranking points, country codes, and the official ranking date.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.

Example Request: JAVASCRIPT

const response = await fetch("https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ranking/atp/top", {
   method: "GET",
   headers: {
      "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
      "X-RapidAPI-Host": "tennis-api-atp-wta-itf.p.rapidapi.com",
   },
});

const result = await response.json();
console.log(result);

Get Ranking Filters

GET/tennis/v2/ranking/{tour_type}/filters

Retrieve all available filter options for ranking queries, including tours, ranking types, countries, ranking dates, and other supported filter values. Use these values to build valid requests for ranking endpoints.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ranking/atp/filters' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Player Ranking History

GET/tennis/v2/ranking/{tour_type}/player/{player_id}/history

Retrieve a player's ranking history over time, including ranking positions, ranking points, movement since the previous ranking, and historical ranking dates.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`player_id`	Yes	Player ID (≥ 1). Obtain from the Players module.

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ranking/atp/player/5992/history' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Full Rankings

GET/tennis/v2/ranking/{tour_type}

Returns the complete player rankings list for the selected tour, ranking type, and date. Each ranking entry includes the player's current position, ranking points, weekly/yearly movement, points gained or lost during the week, and basic player information.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.

Query Parameter

Parameter	Required	Description
`group`	Yes	Filter by group. Enum("singles", "doubles"). Example: group=singles
`date`	Yes	date in DD.MM.YYYY format, e.g. date=08.07.2026
`countryAcr`	No	e.g. countryAcr=ESP
`page`	No	Page number (default: 1). Example: page=1
`limit`	No	Number of rivalries to return (default: 10). Example: limit=10

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ranking/atp?countryAcr=ESP&date=08.07.2026&page=1&limit=10&group=doubles' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

ℹ️

Tip

The /tennis/v2/ranking endpoint in the Miscellaneous module returns ranking tier definitions (Grand Slam, Masters 1000, etc.) — not player rankings.