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.
$ 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 matches
Every ATP and WTA match since 1968 — main draws, qualifying, Challengers, and ITF — with set scores and serve stats.
5,566,184 ranking rows
Every published weekly ranking Monday for both tours, queryable by exact date.
137,410 players
Bios, handedness, countries, activity status, and career statistics with surface and year filters.
57,910 tournaments
Editions with tier, surface, dates, season calendars, and round-by-round draw brackets.
Head-to-head engine
Any two players in history — or a whole group via the H2H matrix — with surface, finals, and Slam splits.
Live scoreboards
In-progress matches with per-match detailed state, plus recent results the moment they finish.