Published October 28, 2026 | Version 1.0.3

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.

Files

DATA_DICTIONARY.md

Files (12.2 MB)

Name Size
md5:0cd22a95d32d9678e2976167a2f779b8
2.3 kB Preview Download
md5:0bf47dc8cd7d359621fa2e117ab932f7
2.4 MB Download
md5:92d3a7a6cc075da402668733a21a0709
420.4 kB Download
md5:cd484a2d728e3f8c3eb338576e9707bf
9.4 MB Download
md5:5ef6f088b4d4519d88038ebfda648c86
4.5 kB Preview Download