tennisdatabaseAPI

Tennis Data API

Every tennis match since 1877, one call away

2.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: 50 calls a day, yesterday to tomorrow. No card needed.
0matches
0first season
10 minlive refresh
Match overviewset 1 · games 0-0 · point 0-0
serve inacefaultrally shot
1st serve in0%
Aces0
Avg serve km/h0
Avg rally0.0
Point by point, statistics and odds through one keyillustrative match

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.

Get a free key
Your free keyno card, no trial end
1Your email
2Your key
3First calls
your key appears here
Copy
Calls today0 / 50
Dates your key reads 
free keyLive, Archive and Complete
# your first call, today's matches
curl -H "Authorization: Bearer $TDA_KEY" \
  "https://api.tennisdatabaseapi.com/v1/matches"
GET/v1/matches/{id}200 OK

          
Yesterday's matches carry every price, the statistics and every point on the free key

PlansOne key, every plan reads the same data shape

Start here

Free key

Try it on today's matches
$0for ever
Upgrade on the same key
  • 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
Get a free keyNo card, no end date

Live

Daily tools, models and alerts
$39/month
about $0.13 per 1,000 calls
  • 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
Choose LiveCancel any time

Archive

Research and back-testing
$59/month
about $0.20 per 1,000 calls
  • 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
Choose ArchiveCancel any time
Best value per call

Complete

Everything, past and live
$119/month
about $0.12 per 1,000 calls
  • 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
Choose CompleteCancel any time
Cancel any time, no lock-inUpgrade or downgrade instantlySame code on every planBilled as DEVELOPERDATA.NET

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.

Full reference
EndpointReturnsPlanMCP tool
/matchesMatches on a dayFree keymatches_on_day
/results/yesterdayYesterday's resultsFree keyresults_yesterday
/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 oneFree keyfixtures
/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 minutesPaid
/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)Paid
/matches/{id}One match in fullFree keymatch_detail
/matches/{id}/statisticsServe and return figures for each player, for the match and each set, with the service games held and brokenFree keymatch_statistics
/matches/{id}/pointsEvery game and point of a match: who served, who won it, breaks, break points and set pointsFree keymatch_points
/matches/{id}/oddsEvery bookmaker's closing and opening price for a match, and every market: games, sets, handicaps and correct scoreFree keymatch_prices
/matches/{id}/movesEach change of each bookmaker's match price before the start, timedFree keyprice_moves
/playersPlayers by nameFree keyfind_player
/players/{id}A player and recordFree keyplayer_profile
/players/{id}/matchesA player's matchesPaidplayer_matches
/players/{id}/seasonsA player's won and lost by season, and by surface within each seasonFree keyplayer_seasons
/players/{id}/statisticsA player's serve and return figures over every match held with statistics, and their opponents' against themPaidplayer_statistics
/players/{id}/titlesEvery final a player won and lost, by levelFree keyplayer_titles
/players/{id}/rankingsA player's singles ranking and points, week by week, newest firstPaidranking_history
/players/{id}/eloA player's Elo rating now, and before every match, overall and on the match's surface, with the chance it gave themPaidelo_history
/h2h/{a}/{b}Head to headPaidhead_to_head
/rankingsThe current singles rankings, with each player's highest ranking and EloFree keyrankings
/rankings/{date}The ranking list of the week of a date: singles, men from 1973 and women from 2003; women's doubles with list=doublesPaidrankings_on_date
/eloThe players our Elo rates highest, overall or on one surface, among those with a match in the last yearFree keyelo_ratings
/tournamentsTournaments by nameFree keyfind_tournament
/tournaments/{id}Every season heldFree keytournament_seasons
/tournaments/{id}/championsThe champion and runner-up of every season of a tournament, and who has won it mostFree keytournament_champions
/tournaments/{id}/{season}A season's matchesPaidtournament_results
/tournaments/{id}/{season}/drawOne season of a tournament round by round, from qualifying to the final, with seeds and entryPaidseason_draw
/calendarThe events being played in the week of a date, every level, with surface, city and matches held so farFree keyevents_this_week
/doublesEvery doubles match of one day, with both pairs, seeds, the score and closing pricesPaiddoubles_on_day
/doubles/matches/{id}/statisticsA doubles match's serve and return figures for each pair, for the match and each set, where the match has them (tour-level doubles from 13 November 2026)Paiddoubles_statistics
/doubles/matches/{id}/pointsEvery game and point of a doubles match: which pair served, who won it, breaks and break pointsPaiddoubles_points
/doubles/pairs/{id}A doubles pair, their record together and every match they played, newest firstPaiddoubles_pair
/markets/accuracyHow often the closing favourite won: by price, level, surface and season, and over the last 30 daysFree keymarket_accuracy
/markets/upsetsThe longest closing prices that won at Grand Slam and tour levelFree keybiggest_upsets
/markets/marginsEach bookmaker's average margin on its closing prices since the start of last yearPaidbookmaker_margins
/recordsThe most matches won and the most titles, all timeFree keyall_time_leaders
/records/{season}The most matches won and the most titles in one seasonFree keyseason_leaders
/searchPlayers and tournaments together, by nameFree keysearch
/meta/coverageWhat the data holdsFree key
/exportsEvery season as compressed CSV files: matches, prices, price moves, statistics and point by point, with rows, size and checksum, rebuilt nightlyPaid
/exports/{season}/{dataset}One season's file of one dataset (matches, prices, moves, statistics or points), gzip-compressed CSVPaid
/freshnessHow current each dataset is: the newest day held for results, prices, price moves, statistics and point by point, the share of yesterday's and the last 7 days' matches with each, and when the database was last updated (does not count)Free key
/usageYour plan and usageFree key

          

          
sample response, shortened
Key in the Authorization header, never in the address Paged lists: page, per_page up to 200, or a cursor All times UTC OpenAPI and llms.txt published

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.

4h 57mon court
422points played
68games played
Wimbledon 2019, final, set by setNovak Djokovic (1)Roger Federer (2)
Set 1
7-6(5)
Set 2
1-6
Set 3
7-6(4)
Set 4
4-6
Set 5first final-set tiebreak at 12-12
13-12(3)

Points won

204to218

Federer won 14 more points

Aces

10to25

Federer served 15 more

Tiebreaks

3to0

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.

Your assistant, with the tennis MCP serverapi.tennisdatabaseapi.com/mcp
  1. 1
    Get a keyFree, or the plan you need
  2. 2
    Add the server to your clientOne entry in its MCP settings
  3. 3
    Ask 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

matches_on_day results_yesterday match_detail find_player player_profile player_matches head_to_head find_tournament tournament_seasons tournament_results

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.

/matches/matches/{id}/h2h/{a}/{b}
odds: { opening, closing, moves }

Apps and media

Scores, draws and results for today and tomorrow, with seeds, rounds and surfaces ready to show.

/matches?date=today/results/yesterday/tournaments/{id}/{season}
round: "quarter-final", seed: 3

Researchers and analysts

Every season since 1877 at every level, for back-testing, papers and long views of the game.

/players/{id}/matches/tournaments/{id}/meta/coverage
seasons: 1877 to today

AI builders

Give your assistant the whole of tennis through the MCP server, with your key and your limits.

matches_on_dayhead_to_headtournament_results
tools: 10, one connection

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.

No card50 calls a daySame key when you upgrade
Centre CourtTennis Database API
Matches
Seasons
Stats per match
Endpoints
MCP tools