Tennis Point-by-Point Dataset — ATP, WTA, Challenger, ITF (Public Sample)
Authors/Creators
Description
Professional tennis data from Live Tennis API: a match index of 173,571 completed matches across ATP, WTA, Challenger and ITF. They run from 2023-01-01 to 2026-08-13 (7-day embargo). 98% of them have point-by-point score sequences. Point data comes in two stated provenance classes. The live-observed layer was captured by our own collection with real UTC timestamps (22,031 matches, 3.18M point states). Live observation began 2025-10-12 and reached full volume in February 2026. The reconstructed layer covers earlier matches: reconstructed point sequences, no capture timestamps. It is not in this deposit.
This record is a public sample of the full dataset. The full dataset is free for non-commercial academic research and teaching, on application to research@livetennisapi.com.
Files. matches.csv.gz: all 173,571 completed matches with tournament, tier, surface, round, best-of, scheduled time (UTC) and players. players.csv.gz: 32,678 players with stable IDs, country, birth date and handedness. points_sample_2026-06.csv.gz: all 951,064 live-observed point states for 5,380 completed matches of June 2026, in capture order with UTC timestamps. That is 77% of the month's completed matches. README.md and DATA_DICTIONARY.md document every column, the provenance model and the known limitations. This sample contains live-observed rows only.
Limitations. The live-observed layer starts 2025-10-12 and covers roughly 10 to 13% of matches per tier so far. Earlier point sequences exist only as reconstructions without timestamps. An observed tape can start mid-match or end before the final point. Serve speed, serve direction and shot-level data are not included.
Results before 2023: the Live Tennis API results archive covers 1968 to 2022 (https://livetennisapi.com/historical-tennis-data-api).
Access to the full dataset: email research@livetennisapi.com from an institutional address with one paragraph on your research and the data you need. Conditions: non-commercial research and teaching only, no redistribution of raw data, citation required.
Version 1.0.3 (2026-10-28)
Players file: removed an external ID column. Every other column and row of players.csv.gz is unchanged. matches.csv.gz and points_sample_2026-06.csv.gz are byte for byte the 1.0.2 files. README.md carries the corrected 1.0.1 wording again, because 1.0.2 shipped the 1.0.0 README by mistake. README.md and DATA_DICTIONARY.md now describe the reconstructed layer by what it holds.
Version 1.0.2 (2026-09-28)
The timestamps in versions 1.0.0 and 1.0.1 were labelled UTC but were written in Israel local time. In points_sample_2026-06.csv.gz, timestamp_utc moves back 3 hours on all 951,064 rows. In matches.csv.gz, scheduled_time_utc moves back 3 hours on 120,758 rows and 2 hours on 52,813 rows. Each row uses the offset in force at its own instant. Every other value is unchanged. Check one row: match 9 read 2026-03-22 19:40:00 in 1.0.0 and 1.0.1. From 1.0.2 on it reads 2026-03-22 17:40:00, which is what the API has always served.
Version 1.0.1 (2026-08-22)
Corrected the 1.0.0 description, which wrongly said the data was "recorded live since January 2023". The match index starts in 2023. Live point observation started 2025-10-12. Data files unchanged.