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
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:
{
"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.
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.