Guides
Tennis data, one question at a time
Working Python, JavaScript and cURL for common tennis data questions, each run against the live API with the real response shown.
How do I get tennis Elo ratings by surface in Python?
Our Elo rating for every active player, overall or on one surface, with the number of matches behind each rating.
get_ratings · 2 credits
How do I compare a tennis player's results on clay, grass and hard court?
A player's career record split by surface: wins, losses, sets, games, tiebreaks and deciding sets, with the surface Elo ratings alongside.
get_surface_splits · 3 credits
How do I get a tennis head-to-head record in Python?
Every meeting between two players with the score and sets, plus wins by surface and in finals.
get_head_to_head · 3 credits
How do I get set-by-set tennis scores for a tournament in Python?
Every match of a tournament with seeds, winner and each set's games and tiebreak, flattened into one row per set.
get_matches · 2 credits
How do I get a tennis player's ranking history in Python?
A player's weekly ranking and points, newest first, for a season or for their career.
get_rankings · 2 credits
How do I compare ATP closing odds with the result and Elo in Python?
One call returns a match's score, both players' Elo before it and every sportsbook's open and close price. This removes the margin and sets the market beside Elo.
get_match · 2 credits
How do I get WTA odds from open to close by sportsbook in Python?
Every sportsbook's opening and closing price for a WTA match with the margin removed, to see which way the market moved and how much each book charged.
get_match · 2 credits
How do I get today's ATP tennis schedule in Python?
ATP matches in the next days with tournament, round, court and players. The call returned 19 Rolex Shanghai Masters matches from October 11 to 13.
get_schedule · 2 credits
How do I get a tennis tournament draw and results in Python?
A tournament's whole draw by round, with scores by set. The China Open had 31 main-draw matches and Novak Djokovic won the final.
get_tournament · 2 credits
How do I get a tennis player's season stats in Python?
A player's season record counted from scores: wins, sets, tiebreaks, and results by round and opponent ranking. Jannik Sinner was 44-3 in 2026.
get_player_stats · 3 credits