tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsAccount and dataBulk file
Account and data

Bulk file

GEThttps://api.tennisdatabaseapi.com/v1/exports/{season}/{dataset}

One season's file of one dataset (matches, prices, moves, statistics or points), gzip-compressed CSV.

Free key not includedLive not includedArchive not includedComplete included

This endpoint sends the file itself, gzip-compressed CSV. Fetch it with the request below and save it, or open it with any tool that reads CSV.

1Parameters

NameInTypeWhat it is
seasonrequiredpathyearA season, such as 2024.
datasetrequiredpathstringOne of matches, prices, moves, statistics, points.

Anything else in the address answers 422 unknown_parameter, with the list of parameters this endpoint takes.

2Request

curl -H "Authorization: Bearer $TDA_KEY" \
  "https://api.tennisdatabaseapi.com/v1/exports/2026/matches"

The code follows the form in Try it, with your key in it once you have entered one. Without a key it reads $TDA_KEY.

3Answer

{
  "file": "tennis-2026-matches.csv.gz",
  "content_type": "application/gzip",
  "first_lines_unpacked": ["match_id,date,tour,tier,tournament_id,tournament,event_known,season,surface,round,winner_id,winner,winner_country,loser_id,loser,loser_country,score,winner_sets,loser_sets,status,best_of,winner_rank,loser_rank,winner_seed,loser_seed,winner_entry,loser_entry,duration_minutes,umpire,venue,city,closing_winner,closing_loser,start_time,winner_points,loser_points", "mt_dqsqrt89,2026-01-01,men,itf,tn_bxj2bw47,M25 Marrakech,true,2026,clay,round_of_16,pl_3e0dxmca,Jianu F.,Romania,pl_wbxapj1n,Delage P.,France,6-2 6-1,2,0,completed,3,280,684,,,,,64,,,Marrakesh,1.18,4.37,2026-01-01T12:15:00Z,190,49", "mt_8gkrjcd1,2026-01-01,men,itf,tn_bxj2bw47,M25 Marrakech,true,2026,clay,round_of_16,pl_2cxr2wac,Bennani R.,Morocco,pl_jp2w53yf,Garcia Longo N.,Argentina,6-3 6-2,2,0,completed,3,645,1164,,,,,74,,,Marrakesh,1.05,7.84,2026-01-01T12:05:00Z,54,10"]
}

Real answers from the API, made 2026-11-18. Long lists are cut to three items here.

4Fields

FieldTypeWhat it holds
matchesfileOne line a match: ids, date, tour, tier, tournament, season, surface, round, both players, score, sets, status, best of, ranks, seeds, entries, minutes, umpire, venue, city, the closing prices, the start time (UTC) and both players' ranking points
pricesfileOne line a match and bookmaker: closing and opening prices for the winner and the loser
movesfileOne line a price change: bookmaker, side, time and price
statisticsfileOne line a match, period and figure: the winner's and the loser's value
pointsfileOne line a game: set, game, tiebreak, server, who won it, break, games after, every point and the break points

5Errors

400bad_requestA value out of range, such as a date or a tier that is not one of the list.
401unauthorizedNo key, or a key that is unknown or revoked.
403upgrade_requiredA key on a lower plan: this endpoint is on the Complete plan.
404not_foundNo file is held for that season.
422unknown_parameterA parameter this endpoint does not take.
429rate_limitedToo many calls this minute, or the allowance used (quota_exceeded).