ToolzerHubAnswer

Does the ATP have an API? Tennis rankings as JSON

The ATP and WTA license official data to betting and media firms. Our tennis API returns the top 500 of the ATP or WTA ranking in one call.

5 min read

Short answer

  • Neither the ATP nor the WTA documents a public developer API. Their official data is licensed to Sportradar and Stats Perform for betting and media.
  • Their rankings pages are for reading: the ATP page opens on the top 100 and the WTA site links a rankings PDF.
  • Our Sofascore API returns 500 players of the ATP, WTA or Race rankings in one call, with points and last week's rank, at 1 credit.
On this page

Neither tour documents a developer API. The ATP's data arm licenses betting and media data to Sportradar, and the WTA licenses live scores and stats to sportsbooks through Stats Perform. For rankings, live matches and match stats as JSON with one API key, our Sofascore API reads Sofascore's public tennis pages.

Where official tennis data goes

The ATP runs its data through Tennis Data Innovations, a joint venture with ATP Media, and an ATP release describes a multi-year deal giving Sportradar betting and media data rights for ATP Tour and Challenger events. The WTA has an exclusive deal with Stats Perform to distribute its live scores and stats to licensed sportsbooks. For readers, the ATP rankings page opens on the top 100 and the WTA site links a rankings PDF.

Tennis rankings with ToolzerHub

We make ToolzerHub. Our Sofascore API covers tennis alongside football and 20 other sports. The routes for tennis, each 1 credit a call:

  • /v1/sofascore/rankings: ATP, WTA, ATP Race or WTA Race, 500 players
  • /v1/sofascore/events/live?sport=tennis: matches in play now
  • /v1/sofascore/event/statistics: aces, double faults, break points and more for one match
  • /v1/sofascore/event/point-by-point: every point of a match
bash
export TOOLZERHUB_API_KEY=your_key
curl -H "x-api-key: $TOOLZERHUB_API_KEY" \
  "https://api.toolzerhub.com/v1/sofascore/rankings?type=atp"

The second row of the ATP ranking, inside data, trimmed:

json
{
  "type": "atp",
  "updated_at": "2026-11-03T13:01:57Z",
  "count": 500,
  "rankings": [{
    "rank": 2,
    "name": "Jannik Sinner",
    "points": 9450,
    "previous_rank": 1,
    "previous_points": 10450,
    "best_rank": 1,
    "tournaments_played": 19,
    "team": {"id": 206570, "country": {"code": "IT", "name": "Italy"}}
  }]
}

previous_rank is last week's position, so one call shows who moved. team.id is the player's Sofascore id, which the player and match routes take. tournaments_played and previous_points are filled on the ATP list, on 446 and 500 of its rows, and empty on the WTA and Race lists.

Save the ATP and WTA rankings to CSV

The script takes one or more lists, writes every player to a CSV and prints the No. 1, the countries with most players in the top 100, and the biggest weekly climb and drop. Install requests (pip install requests) and save it as tennis_rankings.py.

python
import collections
import csv
import os
import sys
import time

import requests

URL = "https://api.toolzerhub.com/v1/sofascore/rankings"
HEADERS = {"x-api-key": os.environ.get("TOOLZERHUB_API_KEY", "")}
FIELDS = ["list", "rank", "previous_rank", "name", "country", "points", "previous_points",
          "best_rank", "tournaments_played", "player_id"]


def rankings(kind, tries=3):
    # Retry rate limits, server errors and dropped connections.
    for attempt in range(tries):
        last = attempt == tries - 1
        try:
            r = requests.get(URL, headers=HEADERS, params={"type": kind}, timeout=120)
        except requests.RequestException:
            if last:
                raise
            time.sleep(5 * (attempt + 1))
            continue
        if r.status_code in (429, 500, 502, 503, 504) and not last:
            time.sleep(5 * (attempt + 1))
            continue
        r.raise_for_status()
        return r.json()["data"]


def main(kinds="atp,wta", out="tennis_rankings.csv"):
    with open(out, "w", newline="", encoding="utf-8") as f:
        writer = csv.DictWriter(f, fieldnames=FIELDS)
        writer.writeheader()
        for kind in filter(None, (k.strip() for k in kinds.split(","))):
            data = rankings(kind)
            rows = data["rankings"]
            for p in rows:
                team = p.get("team") or {}
                writer.writerow({
                    "list": kind, "rank": p["rank"], "previous_rank": p["previous_rank"], "name": p["name"],
                    "country": (team.get("country") or {}).get("name"), "points": p["points"],
                    "previous_points": p["previous_points"], "best_rank": p["best_rank"],
                    "tournaments_played": p["tournaments_played"], "player_id": team.get("id"),
                })
            top100 = rows[:100]
            countries = collections.Counter(((p.get("team") or {}).get("country") or {}).get("name") for p in top100)
            moves = [(p["previous_rank"] - p["rank"], p["name"], p["rank"]) for p in top100 if p["previous_rank"]]
            up, down = max(moves), min(moves)
            print(f"{kind} ({data['updated_at'][:10]}): {len(rows)} players, No. 1 {rows[0]['name']} "
                  f"with {rows[0]['points']:,} points; top 100 by country "
                  f"{', '.join(f'{c} {n}' for c, n in countries.most_common(3))}; "
                  f"biggest climb {up[1]} +{up[0]} to {up[2]}, biggest drop {down[1]} {down[0]} to {down[2]}")


if __name__ == "__main__":
    if not HEADERS["x-api-key"]:
        sys.exit("set TOOLZERHUB_API_KEY first")
    main(*sys.argv[1:])

What the four lists showed

python tennis_rankings.py atp,wta,atp-race,wta-race made 4 calls in 11 seconds and saved 2,000 rows.

List No. 1 and points Most players in the top 100 Biggest climb in the top 100 Biggest drop in the top 100
ATP Alexander Zverev, 9,550 USA 14, France 11, Argentina 10 Terence Atmane, +17 to 73 Arthur Rinderknech, -7 to 68
WTA Elena Rybakina, 8,099 USA 14, Czechia 10, Ukraine 7 Harriet Dart, +31 to 84 Janice Tjen, -28 to 75
ATP Race Alexander Zverev, 9,520 USA 14, France 11, Argentina 10 Tomáš Macháč, +10 to 59 Sebastian Korda, -14 to 100
WTA Race Elena Rybakina, 8,099 USA 15, Czechia 10, Ukraine 7 Aliaksandra Sasnovich, +14 to 87 Mayar Sherif, -6 to 62

Sinner dropped from first to second, losing 1,000 points in the week. The ranking and the Race sit close together: in the ATP top 50, no player is more than 6 places apart on the two lists.

What it costs

A list is 1 credit, so the four lists every Monday are about 17 credits a month. The 100 free credits a month cover that with room for match stats; $19 buys 10,000 credits that never expire, and plans for higher volume cover live scores and match stats across a season. Set your key and the rankings are a CSV in seconds.

For football, see free football APIs compared. For cricket, see does Cricbuzz have an API.

We are not affiliated with the ATP, the WTA or Sofascore.

Get this data from your own code

The SofaScore API returns it as JSON with one x-api-key header. 100 free credits monthly.