# atptour.com API: Get ATP singles rankings

> Gets the ATP men's singles world rankings as of the latest published ranking date. Finds one ranked player by name, or returns up to 500 ranked players in rank order.

Unofficial. Not affiliated with or endorsed by atptour.com.

- Page: https://fous.com/methods/atptour.com/get-rankings
- Method: `atptour.com/get_rankings`, version 1
- Website: atptour.com
- Returns: ranking date; rank, player, country, age, points, places moved, tournaments played, profile link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `player` | string | no |  | Player name to find, for example Carlos Alcaraz. Default "". |
| `max_results` | integer | no | `500` | Maximum number of ranked players, for example 100 (up to 500). Default 100. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "max_results": 500
}
```

Its output:

```json
{
  "players": [
    {
      "age": 25,
      "rank": 1,
      "player": "Jannik Sinner",
      "country": "Italy",
      "places_moved": 0,
      "profile_link": "https://www.atptour.com/en/players/jannik-sinner/s0ag/overview",
      "ranking_points": 11000,
      "tournaments_played": 16
    },
    {
      "age": 29,
      "rank": 2,
      "player": "Alexander Zverev",
      "country": "Germany",
      "places_moved": 0,
      "profile_link": "https://www.atptour.com/en/players/alexander-zverev/z355/overview",
      "ranking_points": 9630,
      "tournaments_played": 19
    },
    {
      "age": 23,
      "rank": 3,
      "player": "Carlos Alcaraz",
      "country": "Spain",
      "places_moved": 0,
      "profile_link": "https://www.atptour.com/en/players/carlos-alcaraz/a0e2/overview",
      "ranking_points": 5060,
      "tournaments_played": 16
    }
  ],
  "ranking_date": "2026-09-28"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"atptour.com/get_rankings","input":{"max_results":500}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What is Jannik Sinner's current ATP singles ranking and how many points does he have?
- Show me the top 20 men's singles players in the latest ATP rankings on atptour.com
- Pull the current men's tennis world rankings, top 250, with country, age, and tournaments played for each player
- Where is Ben Shelton ranked right now, and did he move up or down since the last ranking update?
- Using atptour.com, find Holger Rune's position in the latest men's singles rankings along with his profile link

## Input schema

```json
{
  "type": "object",
  "properties": {
    "player": {
      "type": "string",
      "default": "",
      "description": "Player name to find, for example Carlos Alcaraz."
    },
    "max_results": {
      "type": "integer",
      "default": 100,
      "maximum": 500,
      "minimum": 1,
      "description": "Maximum number of ranked players, for example 100 (up to 500)."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "ranking_date",
    "players"
  ],
  "properties": {
    "players": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "rank",
          "player",
          "country",
          "age",
          "ranking_points",
          "places_moved",
          "tournaments_played",
          "profile_link"
        ],
        "properties": {
          "age": {
            "type": [
              "integer",
              "null"
            ]
          },
          "rank": {
            "type": "integer"
          },
          "player": {
            "type": "string"
          },
          "country": {
            "type": [
              "string",
              "null"
            ]
          },
          "places_moved": {
            "type": "integer",
            "description": "Positive means up in rank; negative means down."
          },
          "profile_link": {
            "type": "string"
          },
          "ranking_points": {
            "type": "integer"
          },
          "tournaments_played": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "additionalProperties": false
      },
      "description": "Ranked singles players in ranking order."
    },
    "ranking_date": {
      "type": "string",
      "format": "date",
      "description": "Date of the published rankings."
    }
  },
  "additionalProperties": false
}
```

## See more

- [atptour.com API: Get ATP tournament results](https://fous.com/methods/atptour.com/get-tournament-results.md): Gets singles match results round by round for an ATP tournament and year, including the champion, dates, surface and category. Without a year it uses the most recent listed edition.
- [FIFA API: Get world ranking](https://fous.com/methods/fifa.com/get-world-ranking.md): Gets the latest official FIFA men's or women's national-team ranking, with points and movement since the previous ranking. Unranked teams are excluded.
- [Chess.com API: List top players](https://fous.com/methods/chess.com/list-top-players.md): Lists up to 50 top Chess.com players for a time control, in rank order, with ratings, game records and profile links. Puzzles rankings use puzzle scores.
- [Premier League API: List top players by stat](https://fous.com/methods/premierleague.com/list-top-scorers.md): Ranks Premier League players for a season by goals, assists or goalkeeper clean sheets, with each player's club and nationality.
- [MLB API: Get player stats](https://fous.com/methods/mlb.com/get-player-stats.md): Gets an MLB player's profile and regular-season hitting and pitching statistics for one season and for his career. Without a season it uses the current season, or the player's latest MLB season if he has no stats this year.
- [NBA API: Get player by name](https://fous.com/methods/nba.com/get-player.md): Looks up an NBA player by name, including retired players, and returns the bio and regular-season per-game averages for the reported season and career.
- [Premier League API: Get player stats](https://fous.com/methods/premierleague.com/get-player-stats.md): Looks up a Premier League player by name and returns the profile and either career totals or the stats for a chosen season. If names clash, a current Premier League player is preferred.
- [Chess.com API: Get player stats](https://fous.com/methods/chess.com/get-player-stats.md): Gets a Chess.com player's public profile, ratings and game records, best puzzle rating and Puzzle Rush best score from a username or member profile link.
- [All atptour.com methods](https://fous.com/methods/atptour.com.md)