tennisapi.dev / tennis rankings api

A rankings API with a time machine built in

5.5 million ranking rows across every published ATP and WTA week — current tables, any Monday in history, and chart-ready career trajectories.

Get a free API key Read the docs
$ curl "https://api.citoapi.com/api/v1/tennis/rankings?tour=ATP&date=1990-08-13" \
    -H "x-api-key: YOUR_API_KEY"

{ "ranking_date": "1990-08-13", "tour": "ATP",
  "items": [ { "rank": 1, "player_name": "Stefan Edberg", "points": 3389 } ] }

Any Monday, reconstructed exactly

Pass a date to /tennis/rankings and get the world as it stood that week — ranks, points, movement. Rebuild the week Graf reached No. 1, or the table the Monday after a famous upset. /tennis/rankings/dates lists every available week so date pickers and sliders drive themselves.

Careers as data, not anecdotes

/tennis/rankings/history/{playerId} returns one player's entire ranking trajectory — the qualifier grind, the breakthrough, the peak, the comeback — ready to plot without assembly.

Current tables for product surfaces

/tennis/rankings/top gives a compact top-N for homepages and widgets; the full table endpoint supports country and rank-range filters for leaderboards that go deeper.

The dataset behind it

1,730,276 matchesEvery ATP and WTA match since 1968 — main draws, qualifying, Challengers, and ITF — with set scores and serve stats.
5,566,184 ranking rowsEvery published weekly ranking Monday for both tours, queryable by exact date.
137,410 playersBios, handedness, countries, activity status, and career statistics with surface and year filters.
57,910 tournamentsEditions with tier, surface, dates, season calendars, and round-by-round draw brackets.
Head-to-head engineAny two players in history — or a whole group via the H2H matrix — with surface, finals, and Slam splits.
Live scoreboardsIn-progress matches with per-match detailed state, plus recent results the moment they finish.

Frequently asked

How far back do rankings go?

To the early published weeks of each tour in the 1970s — every ranking Monday since is queryable by date.

Are rankings tied to player profiles?

Yes — ranking rows carry the same stable player IDs used by matches, head-to-heads, and stats.

Can I chart a player's ranking history?

Yes — one call returns the full career trajectory for any player, ready for charting.

Your first call is thirty seconds away

Free tier to prove it, production tiers when you ship.

More tennis API resources