tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsSubjects

Players

Find a player by name: their profile and record, matches, seasons, titles, rankings over time, Elo and head to heads.

A player has an id that never changes. Matches name the winner and the loser by that id, so a player found once links to every match, record and head to head.

1Endpoints

GETFind players/v1/playersFind players by name
GETPlayer profile/v1/players/{id}A player, with their win and loss record by surface
GETPlayer matches/v1/players/{id}/matchesA player's matches, newest first
GETPlayer seasons/v1/players/{id}/seasonsA player's won and lost by season, and by surface within each season
GETPlayer titles/v1/players/{id}/titlesEvery final a player won and lost, by level
GETRanking history/v1/players/{id}/rankingsA player's singles ranking and points, week by week, newest first
GETElo history/v1/players/{id}/eloA player's Elo rating now, and before every match, overall and on the match's surface, with the chance it gave them
GETHead to head/v1/h2h/{a}/{b}Head to head between two players

2Common jobs

Find a playerGET /v1/players?search=alcaraz
Their record by surfaceGET /v1/players/{id}
Their matches in a seasonGET /v1/players/{id}/matches?season=2025
Every titleGET /v1/players/{id}/titles
Their ranking over timeGET /v1/players/{id}/rankings
A head to headGET /v1/h2h/{a}/{b}