get_rankings

2 creditsBasic lookupPOST /v1/get_rankings

Weekly ranking lists since 2007, or one player's ranking history

Use it when you want a weekly ranking list, the list in force on a date, or one player's ranking history.

Parameters

seasonstring | numberoptional: Year.
weekintegeroptional: Week number of the season.
datestringoptional: The list in force on this date, YYYY-MM-DD.
player_idstringoptional: One player's ranking history instead of a list.
limitintegeroptional: Max rows of a list (default 100).

Notes

Over MCP, ask for it in plain English and the client calls get_rankings itself. Point any MCP client at https://mcp.acesapi.com/mcp?key=YOUR_API_KEY.
Each call costs 2 credits, taken before it runs and refunded if the server errors.
Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.acesapi.com/v1/get_rankings \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "limit": 5
}'

Response

json

{
  "tour": "ATP",
  "season": 2026,
  "week": 40,
  "ranking_date": "2026-10-01",
  "rankings": [
    {
      "rank": 1,
      "previous_rank": 1,
      "points": 11000,
      "player_id": "3623",
      "name": "Jannik Sinner",
      "country": "ITA"
    },
    {
      "rank": 2,
      "previous_rank": 2,
      "points": 9720,
      "player_id": "2375",
      "name": "Alexander Zverev",
      "country": "GER"
    },
    {
      "rank": 3,
      "previous_rank": 3,
      "points": 5560,
      "player_id": "3782",
      "name": "Carlos Alcaraz",
      "country": "ESP"
    }
  ],
  "count": 5
}