Get Top 10 Rankings

GET/tennis/v2/ms-api/ranking/{tourType}/top
Returns the current top 10 ranked players for the specified tour

Path Parameter

ParameterType
{tourType}Requiredstring
"atp" or "wta"
Example Request: JAVASCRIPT
const response = await fetch("https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/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);
Example Response: JSON
[
  {
    "id": "86605501",
    "date": "2026-06-29T00:00:00.000Z",
    "point": 13450,
    "position": 1,
    "player": {
      "name": "Jannik Sinner",
      "countryAcr": "ITA"
    }
  },
  {
    "id": "86605502",
    "date": "2026-06-29T00:00:00.000Z",
    "point": 9460,
    "position": 2,
    "player": {
      "name": "Carlos Alcaraz",
      "countryAcr": "ESP"
    }
  },
  {
    "id": "86605503",
    "date": "2026-06-29T00:00:00.000Z",
    "point": 7190,
    "position": 3,
    "player": {
      "name": "Alexander Zverev",
      "countryAcr": "GER"
    }
  },
  {
    "id": "86605504",
    "date": "2026-06-29T00:00:00.000Z",
    "point": 4390,
    "position": 4,
    "player": {
      "name": "Felix Auger Aliassime",
      "countryAcr": "CAN"
    }
  },
  {
    "id": "86605505",
    "date": "2026-06-29T00:00:00.000Z",
    "point": 4160,
    "position": 5,
    "player": {
      "name": "Ben Shelton",
      "countryAcr": "USA"
    }
  },
  {
    "id": "86605506",
    "date": "2026-06-29T00:00:00.000Z",
    "point": 4110,
    "position": 6,
    "player": {
      "name": "Alex De Minaur",
      "countryAcr": "AUS"
    }
  },
  {
    "id": "86605507",
    "date": "2026-06-29T00:00:00.000Z",
    "point": 3765,
    "position": 7,
    "player": {
      "name": "Taylor Fritz",
      "countryAcr": "USA"
    }
  },
  {
    "id": "86605508",
    "date": "2026-06-29T00:00:00.000Z",
    "point": 3760,
    "position": 8,
    "player": {
      "name": "Novak Djokovic",
      "countryAcr": "SRB"
    }
  },
  {
    "id": "86605509",
    "date": "2026-06-29T00:00:00.000Z",
    "point": 3580,
    "position": 9,
    "player": {
      "name": "Daniil Medvedev",
      "countryAcr": "RUS"
    }
  },
  {
    "id": "86605510",
    "date": "2026-06-29T00:00:00.000Z",
    "point": 3460,
    "position": 10,
    "player": {
      "name": "Flavio Cobolli",
      "countryAcr": "ITA"
    }
  }
]

Get Ranking Filters

GET/tennis/v2/ms-api/ranking/{tourType}/filters
Returns available ranking filters.

Path Parameter

ParameterType
{tourType}Requiredstring
"atp" or "wta"
Example Request: CURL
curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/ranking/atp/filters' \
	--header 'x-rapidapi-host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'
Example Response: JSON
{
  "countries": [
    {
      "name": "Afghanistan",
      "acronym": "AFG"
    },
    {
      "name": "Netherlands Antilles",
      "acronym": "AHO"
    }
  ],
  "surfaces": [
    {
      "id": 6,
      "name": "Acrylic"
    },
    {
      "id": 10,
      "name": "N/A"
    },
    {
      "id": 2,
      "name": "Clay"
    },
    {
      "id": 5,
      "name": "Grass"
    },
    {
      "id": 4,
      "name": "Carpet"
    },
    {
      "id": 1,
      "name": "Hard"
    },
    {
      "id": 3,
      "name": "I.hard"
    }
  ],
  "date": [
    "2026-06-29T00:00:00.000Z",
    "2026-06-22T00:00:00.000Z"
  ]
}

Get Player Ranking History

GET/tennis/v2/ms-api/ranking/{tourType}/player/{player1Id}/history
Returns full weekly ranking history for a specific player.

Path Parameter

ParameterType
{tourType}Requiredstring
"atp" or "wta"
{player1Id}Requiredinteger
Player ID, e.g. "5992"
Example Request: CURL
curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/ranking/atp/player/5992/history' \
	--header 'x-rapidapi-host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'
Example Response: JSON
{
  "player": {
    "name": "Novak Djokovic",
    "countryAcr": "SRB"
  },
  "change": -4,
  "history": [
    {
      "date": "2026-04-13T00:00:00.000Z",
      "position": 4,
      "pts": 4710
    },
    {
      "date": "2026-04-20T00:00:00.000Z",
      "position": 4,
      "pts": 4710
    },
    {
      "date": "2026-05-04T00:00:00.000Z",
      "position": 4,
      "pts": 4700
    },
    {
      "date": "2026-05-18T00:00:00.000Z",
      "position": 4,
      "pts": 4710
    },
    {
      "date": "2026-05-25T00:00:00.000Z",
      "position": 4,
      "pts": 4460
    },
    {
      "date": "2026-06-08T00:00:00.000Z",
      "position": 7,
      "pts": 3760
    },
    {
      "date": "2026-06-15T00:00:00.000Z",
      "position": 8,
      "pts": 3760
    },
    {
      "date": "2026-06-22T00:00:00.000Z",
      "position": 8,
      "pts": 3760
    },
    {
      "date": "2026-06-29T00:00:00.000Z",
      "position": 8,
      "pts": 3760
    }
  ]
}

Get Full Rankings

GET/tennis/v2/ms-api/ranking/{tourType}
Returns full ranking list with filters.

Path Parameter

ParameterType
{tourType}Requiredstring
"atp" or "wta"

Query Parameter

ParameterType
{group}Requiredstring
Ranking group: "singles", "doubles", "race", "surface", or "prize", e.g. group=singles
{date}Requiredstring
Ranking date in YYYY-MM-DD format, e.g. date=08.07.2026
{countryAcr}Optionalstring
e.g. countryAcr=ESP
{page}Optionalstring
e.g. page=1, by default page is 1
{limit}Optionalstring
e.g. limit=1, by default limit is 10
Example Request: CURL
curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/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'
Example Response: JSON
[
  {
    "pts": 7940,
    "wk": 0,
    "position": 4,
    "player": {
      "id": 1035,
      "name": "Marcel Granollers",
      "birthday": "1986-04-12T00:00:00.000Z",
      "countryAcr": "ESP",
      "currentRank": 813,
      "progress": -2,
      "points": 161,
      "hardPoints": 15,
      "hardTournament": 5,
      "clayPoints": 208,
      "clayTournament": 19,
      "grassPoints": 20,
      "grassTournament": 1,
      "carpetPoints": 0,
      "carterTournament": 1,
      "prize": 15868397,
      "ch": null,
      "doublesPosition": 4,
      "doublesProgress": 0,
      "doublesPoints": 7940,
      "ihardPoints": 1,
      "ihardTournament": 1,
      "itf": 800234135,
      "height": null,
      "wikidata_id": null
    }
  }
]