Tennis Data API
Every tennis match since 1877, one call away2.3 million singles results from Grand Slams down to ITF, with rounds, seeds, surfaces, bookmaker prices, match statistics, point by point and Elo ratings. JSON over HTTPS, plus an MCP server for your AI tools.
Free key
Start free in a minute, upgrade when you need more
A free key reads every match from yesterday to two days ahead, at every level: scores, rounds, seeds and surfaces, with every price, the statistics and point by point on yesterday's matches. Prices before play and the full archive are one plan away, and the same code keeps working when you upgrade.
# your first call, today's matches curl -H "Authorization: Bearer $TDA_KEY" \ "https://api.tennisdatabaseapi.com/v1/matches"
PlansOne key, every plan reads the same data shape
Free key
Try it on today's matches- Limits
- Calls50 a day
- Rate10 a minute
- DatesYesterday to +2 days
- Data
- Scores, rounds, seeds
- Bookmaker prices and movesYesterday
- Match statisticsYesterday
- Point by pointYesterday
- Head to head, player history
- MCP server for AI tools
Live
Daily tools, models and alerts- Limits
- Calls300,000 a month
- Rate120 a minute
- DatesLast 45 days to +2
- Data
- Scores, rounds, seeds
- Bookmaker prices and moves
- Match statistics
- Point by point
- Head to head, player history
- MCP server for AI tools
Archive
Research and back-testing- Limits
- Calls300,000 a month
- Rate120 a minute
- DatesEvery season to yesterday
- Data
- Scores, rounds, seeds
- Bookmaker prices and moves
- Match statistics
- Point by point
- Head to head, player history
- MCP server for AI tools
Complete
Everything, past and live- Limits
- Calls1 million a month
- Rate300 a minute
- DatesEvery season to +2 days
- Data
- Scores, rounds, seeds
- Bookmaker prices and moves
- Match statistics
- Point by point
- Head to head, player history
- MCP server for AI tools
Endpoints
One key, twelve endpoints, every level of the game
Plain JSON over HTTPS. Pick an endpoint to see the call in your language and what comes back.
| Endpoint | Plan | |
|---|---|---|
| /matches | Free key | |
| /results/yesterday | Free key | |
| /fixtures | Free key | |
| /live | Paid | |
| /live/{id} | Paid | |
| /matches/{id} | Free key | |
| /matches/{id}/statistics | Free key | |
| /matches/{id}/points | Free key | |
| /matches/{id}/odds | Free key | |
| /matches/{id}/moves | Free key | |
| /players | Free key | |
| /players/{id} | Free key | |
| /players/{id}/matches | Paid | |
| /players/{id}/seasons | Free key | |
| /players/{id}/statistics | Paid | |
| /players/{id}/titles | Free key | |
| /players/{id}/rankings | Paid | |
| /players/{id}/elo | Paid | |
| /h2h/{a}/{b} | Paid | |
| /rankings | Free key | |
| /rankings/{date} | Paid | |
| /elo | Free key | |
| /tournaments | Free key | |
| /tournaments/{id} | Free key | |
| /tournaments/{id}/champions | Free key | |
| /tournaments/{id}/{season} | Paid | |
| /tournaments/{id}/{season}/draw | Paid | |
| /calendar | Free key | |
| /doubles | Paid | |
| /doubles/matches/{id}/statistics | Paid | |
| /doubles/matches/{id}/points | Paid | |
| /doubles/pairs/{id} | Paid | |
| /markets/accuracy | Free key | |
| /markets/upsets | Free key | |
| /markets/margins | Paid | |
| /records | Free key | |
| /records/{season} | Free key | |
| /search | Free key | |
| /meta/coverage | Free key | |
| /exports | Paid | |
| /exports/{season}/{dataset} | Paid | |
| /freshness | Free key | |
| /usage | Free key |
Inside every match
The score tells you who won. The data tells you how.
Every match carries up to 22 statistics, set by set, and every game point by point: who served, who broke, how each game went. Here is the 2019 Wimbledon final, from one call.
Points won
Federer won 14 more points
Aces
Federer served 15 more
Tiebreaks
Djokovic won all three
GET /v1/matches/{id} 200 { "score": "7-6(5) 1-6 7-6(4) 4-6 13-12(3)", "minutes": 297, "stats": { "aces": [10, 25], ... 22 in all }, "point_by_point": { "games": [ 68 games ] } }
MCP server
Ask your AI about any match. It looks it up for you.
Connect the MCP server once and your assistant finds matches, players, head to heads and whole tournaments by itself, with your key and your plan's limits.
- 1Get a keyFree, or the plan you need
- 2Add the server to your clientOne entry in its MCP settings
- 3Ask in plain wordsYour assistant picks the right tool
{
"mcpServers": {
"tennis": {
"url": "https://api.tennisdatabaseapi.com/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}
Ten tools, lit as they are used
Who it is for
One database. Four ways to play it.
Whether you price matches, publish them, study them or hand them to an AI, it is the same key and the same data.
Bettors and modellers
Opening and closing prices from every bookmaker, price moves and the full statistics behind every result.
Apps and media
Scores, draws and results for today and tomorrow, with seeds, rounds and surfaces ready to show.
Researchers and analysts
Every season since 1877 at every level, for back-testing, papers and long views of the game.
AI builders
Give your assistant the whole of tennis through the MCP server, with your key and your limits.
Questions
Straight answers, no small print.
The things people ask before their first call. Search, or pick a topic.
50 calls a day and 10 a minute, for matches from yesterday to two days ahead, at every level: scores, rounds, seeds and surfaces. Yesterday's matches come with every bookmaker's price, the price moves, the statistics and point by point, so you can test what the paid plans give. No card and no end date.
Singles results go back to 1877. Depth grows with the years: statistics, point by point and prices are fuller in the modern era. /v1/meta/coverage shows what is held, season by season, counted from the data.
Grand Slams, the men's and women's tours, Challengers, ITF events and team events, men and women. Filter any list with tier and tour.
Live results are refreshed about every ten minutes, and the day closes out with full scores, statistics and prices once matches finish.
Every bookmaker's opening and closing price for the match winner, the games and sets lines, correct score prices and every price move with its time. Odds are on the Live, Archive and Complete plans.
Nothing in your code. You keep the same key; fields that were null on the free key fill in, and older dates open up on Archive and Complete.
Calls over the minute or day limit are refused until it resets. /v1/usage shows your plan, calls used and limits, and does not count as a call.
Yes. Add the MCP server to any client that supports MCP, with your key, and the assistant uses ten tools to look up matches, players and tournaments by itself.
Monthly or yearly by card, cancel any time. Charges appear as DEVELOPERDATA.NET, and billing questions go to tennisdatabaseapi.com/support.
DeveloperData.net (Developer Data), Empire Tower, South Sathorn Road, Bangkok, Thailand. Support is at tennisdatabaseapi.com/support.
No question matches that. Try another word, or open a ticket.
Match point
Your serve.
First call in a minute.
Put your email in, get a key, and make your first call before the kettle boils. Upgrade on the same key when you need the prices and the archive.