tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsStart here

Tennis API documentation

Tennis data, one call away

Every professional singles match, men from 1877 and women from 1968: Grand Slams and tour events down to challengers and ITF, with scores, rounds, surfaces and seeds. Where it is known, each match carries its closing prices, every bookmaker's price and how it moved, games and sets lines, correct score prices, full match statistics and every point.

Results are added about every ten minutes as matches finish. People build betting models and backtests, results widgets, player and tournament pages, fantasy and scouting tools, and assistants that answer tennis questions from facts rather than memory. JSON over HTTPS, GET only, UTC times, and ids that never change.

2,344,864singles matches
939,090with closing prices
288,384with full statistics
213,935point by point

1Start here

1Get a keyFree with Google sign-in: 50 calls a day, no card.Get a free key
2Make the first callYesterday's results, right here below or in your terminal.Quick start
3Read the answerEvery field of a match, from the score to every point.One match
Try itRuns against the live API with your key. Your key stays in this browser.API
GEThttps://api.tennisdatabaseapi.com/v1/results/yesterday?tour=women&per_page=2

2Every subject

Matches and results

Results on a day, yesterday's results, one match in full, the week's events and doubles.

Read the guide
Players

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

Read the guide
Tournaments

Find an event, see every season it has been held, every match and the draw of a season, and its champions.

Read the guide
Prices and markets

Closing prices on every match list; on one match each bookmaker, the opening prices, the lines and every move; and how the market has done.

Read the guide
Statistics and point by point

Serve, return and point statistics by set, point by point, and a player's figures over many matches.

Read the guide

3Every endpoint

MatchesResults on a day, the matches set to be played, the matches in play now, one match in full, and each part of a match on its own.
GETMatches on a day/v1/matchesMatches on a day, with scores and closing prices
GETYesterday's results/v1/results/yesterdayYesterday's results
GETFixtures/v1/fixturesThe matches set to be played, from those under way to two days ahead: start time, round, both players with ranking and Elo, the chance Elo gives each, and the price before play where the market has one
GETLive scores/v1/liveThe singles matches in play now, read every 15 seconds: sets, games, the game in progress with who serves and its points, how long ago each was read, and those finished in the last 15 minutes
GETLive match/v1/live/{id}One match in play: the live score and every game so far, point by point, with who served, breaks, break points and set points. After it leaves Live, its last score stays here 7 days (meta.in_live false)
GETMatch/v1/matches/{id}One match: score, every bookmaker's price with its opening price, the games and sets lines, correct score prices, price movement and the full statistics
GETMatch statistics/v1/matches/{id}/statisticsServe and return figures for each player, for the match and each set, with the service games held and broken
GETPoint by point/v1/matches/{id}/pointsEvery game and point of a match: who served, who won it, breaks, break points and set points
GETMatch prices/v1/matches/{id}/oddsEvery bookmaker's closing and opening price for a match, and every market: games, sets, handicaps and correct score
GETPrice moves/v1/matches/{id}/movesEach change of each bookmaker's match price before the start, timed
PlayersFind a player: their record, matches, seasons, statistics, titles, rankings, Elo and head to heads.
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 statistics/v1/players/{id}/statisticsA player's serve and return figures over every match held with statistics, and their opponents' against them
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
RankingsThe rankings now and on any week held, and our Elo ratings.
GETRankings/v1/rankingsThe current singles rankings, with each player's highest ranking and Elo
GETRankings on a date/v1/rankings/{date}The ranking list of the week of a date: singles, men from 1973 and women from 2003; women's doubles with list=doubles
GETElo ratings/v1/eloThe players our Elo rates highest, overall or on one surface, among those with a match in the last year
TournamentsFind an event: its seasons, every match, the draw, its champions, and what is being played this week.
GETFind tournaments/v1/tournamentsTournaments, by name, tour or tier
GETTournament/v1/tournaments/{id}A tournament and every season held
GETTournament season/v1/tournaments/{id}/{season}Every match of one season of a tournament
GETSeason draw/v1/tournaments/{id}/{season}/drawOne season of a tournament round by round, from qualifying to the final, with seeds and entry
GETChampions/v1/tournaments/{id}/championsThe champion and runner-up of every season of a tournament, and who has won it most
GETThis week/v1/calendarThe events being played in the week of a date, every level, with surface, city and matches held so far
DoublesDoubles matches on a day, and a pair with every match they played.
GETDoubles on a day/v1/doublesEvery doubles match of one day, with both pairs, seeds, the score and closing prices
GETDoubles pair/v1/doubles/pairs/{id}A doubles pair, their record together and every match they played, newest first
Betting marketsHow the closing prices have done, the biggest upsets and each bookmaker's margin.
GETMarket accuracy/v1/markets/accuracyHow often the closing favourite won: by price, level, surface and season, and over the last 30 days
GETBiggest upsets/v1/markets/upsetsThe longest closing prices that won at Grand Slam and tour level
GETBookmaker margins/v1/markets/marginsEach bookmaker's average margin on its closing prices since the start of last year
RecordsThe most wins and titles, all time and in one season.
GETAll-time leaders/v1/recordsThe most matches won and the most titles, all time
GETSeason leaders/v1/records/{season}The most matches won and the most titles in one season
Account and dataSearch, what the database holds, every season as bulk files, and your own usage.
GETSearch/v1/searchPlayers and tournaments together, by name
GETCoverage/v1/meta/coverageWhat the database holds, season by season, counted from the data
GETBulk files/v1/exportsEvery season as compressed CSV files: matches, prices, price moves, statistics and point by point, with rows, size and checksum, rebuilt nightly
GETBulk file/v1/exports/{season}/{dataset}One season's file of one dataset (matches, prices, moves, statistics or points), gzip-compressed CSV
GETUsage/v1/usageYour plan, calls used and limits (does not count)

paid plans; the rest are on every plan, the free key included

4Popular calls

Match prices/v1/matches/mt_9e5aq213/odds
Player profile/v1/players/pl_f560sfd7
Ranking history/v1/players/pl_f560sfd7/rankings?per_page=3
Elo history/v1/players/pl_f560sfd7/elo?per_page=3
Tournament/v1/tournaments/tn_1d50xrzv

5For assistants and agents

MCP serverAdd the API to Claude Code, Cursor and other assistants as tools.https://api.tennisdatabaseapi.com/mcp
MCP toolsEvery tool, its arguments and the endpoint it calls.https://tennisdatabaseapi.com/documentation/mcp-tools
Agent skillOne file that teaches an agent to use the API.https://tennisdatabaseapi.com/skill.md
ManualThe whole API in one Markdown file, for agents and search.https://tennisdatabaseapi.com/documentation/manual.md
llms.txtA short map of these docs for language models.https://tennisdatabaseapi.com/llms.txt

6Plans in short

7What is new

2026-11-05Tie-breaks in the point by point: each tie-break is now one game with tiebreak set to true, its points the running tie-break score in the same order as every other game (winner first in a match's points, player_1 first live), its server the player who served the first point. Until now each tie-break point was held as a game of its own. Every match was read again and rebuilt, and the service-game summaries follow.
2026-10-31Live scores: /v1/live lists the singles matches in play now, read every 15 seconds, with sets, games, the game in progress, who is serving and its points, and /v1/live/{id} adds every game so far, point by point. On the Live and Complete plans.
2026-10-29Every knockout match carries draw: the match its winner went on to and the matches that led into it, and each match in a tournament draw carries next_match, so a bracket can be built from the answers.

The whole changelog

8Everything else

9Questions people ask

How far back does it go?

Men's matches from 1877 and women's from 1968. Prices and statistics start later and are fullest from the 2000s; Coverage counts them decade by decade. More

How fresh are results?

Finished matches are added about every ten minutes. The free key reads yesterday to two days ahead; Live reads the last 45 days. More

Are the prices opening or closing?

Both where known: the market's closing price, each bookmaker's closing price with its opening price, and every recorded move in between. More

Does it include doubles or live scores?

Not yet: singles only, and point by point arrives once a match is finished. More

Can I use it with Claude or another assistant?

Yes: connect the MCP server, or give your agent the skill file. Both use your normal key and plan. More

What happens when I upgrade?

Nothing in your code changes: fields that were null fill in, and the dates your plan reads widen at once. More