Pricing

from $2.55 / 1,000 match record (standard)s

Try for free

Go to Apify Store

Tennis Data API: Live Scores, ATP WTA ITF Results & Rankings

Try for free

Tennis data API and sports data API: tennis live scores for today's ATP and WTA matches (ITF opt-in), plus tennis match results (ATP results, WTA results, ITF results), match stats, tennis head to head records, tennis player stats and rankings. Search players and tournaments by name.

Pricing

from $2.55 / 1,000 match record (standard)s

Rating

0.0

(0)

Developer

Scott Helvick

Actor stats

Bookmarked

Total users

Monthly active users

11 hours ago

Last modified

Categories

Sports

Developer tools

Automation

Record Type

record_type

Required

Row variant: live_match, match, h2h_summary, player_stats, ranking, lookup or notice. Determines which fields are populated; irrelevant fields are null.

Type:string

Example:

match

Mode

mode

Required

Requested mode: live, matches, h2h, player_stats, rankings, changes or lookup.

Type:string

Example:

matches

Match Id

match_id

Optional

Stable match identifier, '::::'. Unique across tours and stable across refreshes, so it is safe as a join key. Null outside match rows.

Type:string | null

Example:

atp:540:2025:MS:ms001

Edition Id

edition_id

Optional

Tournament edition identifier, '::' — the first three segments of match_id. Groups every match of one running of a tournament. Null outside match rows.

Type:string | null

Example:

atp:540:2025

Tour

tour

Optional

Tour label: atp, wta or itf. ATP includes Challenger events; null when not applicable.

Type:string | null

Example:

atp

Year

year

Optional

Tournament edition year, which may differ from a calendar boundary match date.

Type:integer | null

Example:

2025

Draw

draw

Optional

Draw the match belongs to: MS men's singles, WS women's singles, MQ and WQ the matching qualifying draws. Version one is singles only. Null outside match rows.

Type:string | null

Example:

Stage

stage

Optional

Draw stage: main or qual; null if unavailable.

Type:string | null

Example:

main

Round

round

Optional

Draw round such as R128, QF, SF, F, RR or Q1; null if unavailable.

Type:string | null

Example:

Round Seq

round_seq

Optional

Numeric round ordering supplied by the index; null if unavailable.

Type:integer | null

Example:

Status

status

Optional

Match state. Completed history uses completed, retired, walkover, default, bye, scheduled, in_progress or cancelled. A live row uses the board's own set: scheduled, live, completed, retired, walkover or suspended, with status_detail carrying any finer or unrecognised marker.

Type:string | null

Example:

completed

Date

date

Optional

Match date in YYYY-MM-DD form; null outside match rows or when unavailable.

Type:string | null

Example:

2025-07-13

Completed At

completed_at

Optional

Completion timestamp when the source supplies one; otherwise null.

Type:string | null

Example:

2025-07-13T18:00:00Z

Winner Id

winner_id

Optional

Source-prefixed winning player identifier; null if the winner is unknown.

Type:string | null

Example:

atp:s0ag

Loser Id

loser_id

Optional

Source-prefixed losing player identifier; null if the loser is unknown.

Type:string | null

Example:

atp:a0e2

Winner

winner

Optional

Winning player's identity and per-match raw statistics, passed through as served by the index. Populated only on match rows (modes matches, h2h and changes); null on aggregate, ranking and notice rows. Fields: player_id is source-namespaced, such as atp:s0ag; name and country may be null when the index has not resolved an identity; qid is a Wikidata Q-number or null; resolution is source, crosswalk, wikidata or unresolved, recording how the identity was established (unresolved is a stored answer, never a guess from a name); redirect_to is the surviving player id when this id was merged away, otherwise null (a merged id keeps answering so clients can follow the merge); stats is an object of raw sums for this player in this match, or null when statistics were not usable, never zero play. Raw sums, in order: aces, double_faults, serve_points, first_in, first_won, second_won, second_points, bp_saved, bp_faced, service_games, return_points, first_return_won, first_return_points, second_return_won, second_return_points, bp_converted, bp_opportunities, return_games, total_points_won, total_points. Never percentages, because percentages cannot be re-aggregated. stats_reason explains null stats: source_missing, zero_serve_points, zero_service_games, inconsistent_serve_counts or unfetchable; null when stats is populated.

Type:object | null

Example:

[object Object]

Loser

loser

Optional

Losing player's identity and per-match raw statistics, passed through as served by the index. Populated only on match rows (modes matches, h2h and changes); null on aggregate, ranking and notice rows. Fields: player_id is source-namespaced, such as atp:s0ag; name and country may be null when the index has not resolved an identity; qid is a Wikidata Q-number or null; resolution is source, crosswalk, wikidata or unresolved, recording how the identity was established (unresolved is a stored answer, never a guess from a name); redirect_to is the surviving player id when this id was merged away, otherwise null (a merged id keeps answering so clients can follow the merge); stats is an object of raw sums for this player in this match, or null when statistics were not usable, never zero play. Raw sums, in order: aces, double_faults, serve_points, first_in, first_won, second_won, second_points, bp_saved, bp_faced, service_games, return_points, first_return_won, first_return_points, second_return_won, second_return_points, bp_converted, bp_opportunities, return_games, total_points_won, total_points. Never percentages, because percentages cannot be re-aggregated. stats_reason explains null stats: source_missing, zero_serve_points, zero_service_games, inconsistent_serve_counts or unfetchable; null when stats is populated.

Type:object | null

Example:

[object Object]

Winner Seed

winner_seed

Optional

Winner seed in this tournament, not their ranking; null for an unseeded or unknown player.

Type:integer | null

Example:

Loser Seed

loser_seed

Optional

Loser seed in this tournament, not their ranking; null for an unseeded or unknown player.

Type:integer | null

Example:

Winner Entry

winner_entry

Optional

Winner entry designation such as WC or Q when supplied; otherwise null.

Type:string | null

Example:

Loser Entry

loser_entry

Optional

Loser entry designation such as WC or Q when supplied; otherwise null.

Type:string | null

Example:

Winner Rank

winner_rank

Optional

Winner ranking associated with the match; null if unavailable.

Type:integer | null

Example:

Loser Rank

loser_rank

Optional

Loser ranking associated with the match; null if unavailable.

Type:integer | null

Example:

Score

score

Optional

Source match score; null when unavailable. Preserve retirement and tiebreak notation.

Type:string | null

Example:

4-6 6-4 6-4 6-4

Sets

sets

Optional

Structured set scores when supplied; null if unavailable. Nested layout follows the source: completed rows carry the source's own arrays, and a live row carries one object per set with a side per key.

Type:array | null

Example:

6,4,6,2,7,6

Duration S

duration_s

Optional

Match duration in seconds; null if the source does not publish it.

Type:integer | null

Example:

10440

Conflict

conflict

Optional

Whether the indexed match is marked as conflicting; null when no flag is available.

Type:boolean | null

Example:

false

Merged into

merged_into

Optional

The surviving match id when a cross-source merge folded this match into another. The row keeps the id it was written with and points at the survivor, so a client holding the old id still gets an answer. Merged matches are filtered out of matches and h2h, so this is null there; it is populated on the changes feed, where it is what lets a consumer REPOINT a local row rather than merely deleting it when the tombstone arrives. Null on every other row type and on any match that was never merged.

Type:string | null

Example:

atp:540:2025:MQ:qs016

Stats

stats

Optional

Cohort aggregate raw serve and return sums on player_stats rows only. Per-match statistics live under winner/loser. Null when unavailable or on other row types; aggregated sums are not percentages.

Type:object | null

Example:

[object Object]

Stats Reason

stats_reason

Optional

Reason cohort aggregate statistics are absent on player_stats rows only: no_match_with_stats when no match in the cohort had usable statistics; otherwise null. Per-match statistics and their stats_reason live under winner/loser.

Type:string | null

Example:

source_missing

Revision

revision

Optional

Incremental change revision in changes mode; null on other records.

Type:integer | null

Example:

148213

Optional

Change operation attached to the revision; null outside changes mode.

Type:string | null

Example:

upsert

Summary

summary

Optional

Head-to-head aggregate over the full filtered match set, delivered once per run; null on other row types.

Type:object | null

Example:

[object Object]

Player Id

player_id

Optional

Source-prefixed player identifier on ranking and player_stats rows; null on other row types.

Type:string | null

Example:

atp:s0ag

Derived

derived

Optional

Derived player statistics calculated from the aggregate; null if unavailable or not a player_stats row.

Type:object | null

Example:

[object Object]

Matches Count

matches_count

Optional

Number of matches in the player_stats or h2h_summary aggregate; null on other row types.

Type:integer | null

Example:

Matches With Stats

matches_with_stats

Optional

Number of aggregated matches with statistics; use to assess completeness, not as the total match count.

Type:integer | null

Example:

Wins

wins

Optional

Wins in the filtered player_stats aggregate; null on other row types.

Type:integer | null

Example:

Losses

losses

Optional

Losses in the filtered player_stats aggregate; null on other row types.

Type:integer | null

Example:

Level

level

Optional

Competition level of a live match: main for a tour main-draw event, challenger for an ATP Challenger event, itf for an ITF World Tennis Tour event. Challenger matches share the ATP board, so this is the field to filter on when you want one or the other. Null outside live rows.

Type:string | null

Example:

challenger

Tournament

tournament

Optional

Event name on a live match, as the tour publishes it. Null outside live rows.

Type:string | null

Example:

Phan Thiet

Tournament Id

tournament_id

Optional

Index tournament identifier on a live match, ':'. The same identifier tournamentId accepts in the other modes, so a match on court joins directly to that tournament's history. Null outside live rows.

Type:string | null

Example:

atp:3139

Round Label

round_label

Optional

Round name on a live match as the board writes it, such as Final or Round of 16; round carries the coded form. Null when the board does not name the round, and outside live rows.

Type:string | null

Example:

Final

Player A

player_a

Optional

One side of a live match: name, player_id, country, seed and resolution. A live match is never matched up by name — player_id is built from the identifier the tour itself publishes. It is null, with resolution unresolved, when the index does not hold that player yet; the name is still delivered and no extra row is raised for it. seed and country are null when the board omits them, and the whole object is null outside live rows.

Type:object | null

Example:

[object Object]

Player B

player_b

Optional

The other side of a live match, in the same shape as player_a: name, player_id, country, seed and resolution. player_a and player_b are sides, not outcomes — a match in progress has no winner, so the winner and loser columns stay null on live rows. Null outside live rows.

Type:object | null

Example:

[object Object]

Game Score

game_score

Optional

Points in the game currently being played, as {a, b} matching player_a and player_b, with values the board publishes such as 15, 40 or A. Null between games, on a match that has not started, on a finished match, and outside live rows.

Type:object | null

Example:

[object Object]

Server

server

Optional

Which side is serving in a live match: a for player_a, b for player_b. Null when the board does not publish a server, on a match that is not in play, and outside live rows.

Type:string | null

Example:

Status Detail

status_detail

Optional

The board's own state marker for a live match when it is finer than status, or when the marker was not recognised — a warm-up, a delay note. Preserved rather than dropped, so an unfamiliar state is always visible. Null when there is nothing extra to report.

Type:string | null

Example:

warm_up

Court

court

Optional

Court a live match is being played on, as the event names it. Null when the board does not publish a court, which is common on outside courts, and outside live rows.

Type:string | null

Example:

Center Court

Scheduled Start

scheduled_start

Optional

Scheduled start of a live match as a UTC timestamp. Null on most rows: several boards publish only a local date or free text such as 'Not Before 11:00', and a guessed timestamp is never emitted in its place. Null outside live rows.

Type:string | null

Example:

2026-09-20T09:00:00Z

Started At

started_at

Optional

UTC timestamp at which play began in a live match. Null before a match starts and when the board does not publish it, and outside live rows.

Type:string | null

Example:

2026-09-20T02:32:24Z

Stale

stale

Optional

True when a live match was served from the last good read of its board because a refresh did not succeed, rather than being dropped from the answer. The run summary's sources block reports how old that read is. False on a freshly read row; null outside live rows.

Type:boolean | null

Example:

false

Rank

rank

Optional

Player ranking position on a ranking row; 1 is strongest, null on other row types.

Type:integer | null

Example:

Rank Date

rank_date

Optional

Ranking snapshot date in YYYY-MM-DD form; null outside ranking rows.

Type:string | null

Example:

2025-07-14

Points

points

Optional

Ranking points in the snapshot; null outside ranking rows or if unavailable.

Type:integer | null

Example:

12030

Tournaments Played

tournaments_played

Optional

Tournament count reported in the ranking snapshot; null when unavailable.

Type:integer | null

Example:

Kind

kind

Optional

What a lookup row identifies: player or tournament. Says which input field the id belongs in — player, playerA or playerB for a player, tournamentId for a tournament. Null outside lookup rows.

Type:string | null

Example:

player

Optional

The index id this lookup candidate answers to. Copy it into the input field named by kind; ids are stable across refreshes. Null outside lookup rows.

Type:string | null

Example:

atp:s0ag

Name

name

Optional

Full player name or tournament name as the index holds it, for a lookup candidate. Null outside lookup rows.

Type:string | null

Example:

Jannik Sinner

Country

country

Optional

Country the index holds for a lookup candidate, where one is known; per-match player countries travel inside winner and loser instead. Null outside lookup rows or when unknown.

Type:string | null

Example:

ITA

Matches Indexed

matches_indexed

Optional

Completed and retired matches this player has in the index today, which is how far apart two same-named candidates are. Zero is possible for a player known only from a draw or a ranking. Null outside player lookup rows.

Type:integer | null

Example:

412

Last Match Date

last_match_date

Optional

Date of this player's most recent indexed match, YYYY-MM-DD. Null outside player lookup rows or when the player has no dated match.

Type:string | null

Example:

2025-09-07

Years

years

Optional

Years of this tournament the index holds, ascending. Null outside tournament lookup rows; an empty list means the tournament is known but no edition is indexed yet.

Type:array | null

Example:

2023,2024,2025

Editions

editions

Optional

How many editions of this tournament the index holds — the length of years. Null outside tournament lookup rows.

Type:integer | null

Example:

Candidates

candidates

Optional

On an ambiguous_name notice, up to ten records the supplied name matched exactly, each with id, name, tour and country. Choose one and pass its id. Null on every other row.

Type:array | null

Example:

[object Object]

Source

source

Optional

Which source the row was normalized from, lowercase — atp, wta, itf or a tournament's own site. Null when the row is an aggregate or a notice rather than a source record.

Type:string | null

Example:

atp

Source Url

source_url

Optional

Source reference URL for verification; null when no record reference is available.

Type:string | null

Example:

https://www.atptour.com/en/scores/archive/wimbledon/540/2025/results

Fetched At

fetched_at

Optional

Timestamp when the source record was retrieved; null if unavailable.

Type:string | null

Example:

2025-07-14T12:00:00Z

Db Built At

db_built_at

Optional

Build timestamp of the serving data snapshot, useful for judging freshness; null if unavailable.

Type:string | null

Example:

2025-07-14T13:00:00Z

Notice

notice

Optional

Human-readable explanation of an unavailable result, correction or early stop; null on data rows. On the live board a notice names one tour that could not be refreshed, and the tour column says which; a tour that simply had no match on court raises no notice at all. Notices are never charged.

Type:string | null

Example:

No rows matched this request. The filters are valid but the index holds nothing for them — widen the date range, drop a filter, or check the player and tournament ids against a broader query.

Error Class

error_class

Optional

Notice classification: source_error is retryable; retry after a short delay. no_match, ambiguous_name (the name supplied for a player or tournament field matches several indexed records — the notice lists the candidates and their ids), invalid_input, not_configured, invalid_request, not_separable (the requested slice cannot be filtered apart yet), out_of_coverage (the request names a season, date range or tour the index does not hold YET — unlike the other terminal classes this one is worth repeating later, and the notice names the covered span), budget_exhausted, row_limit and internal_error are terminal for this input. no_live_matches means every tour asked for answered and none had a match on court — a quiet hour rather than a fault, so it is worth repeating later. Inspect the notice and correct or resume the request as appropriate; null on data rows.

Type:string | null

Example:

no_match

Retry advice

retry

Optional

Machine-readable retry guidance for this record, derived from error_class. Null when the record is a result. 'never' = the source answered, or we do not cover this target: re-running the same input returns the same answer, do not re-run. 'with_changes' = the input for this record must change (see error for what): do not re-run unchanged. 'later' = a transient fault on the source or our side, or the run's budget/deadline ran out before this record: re-run the same input after a short delay.

Type:string | null

Example:

later

Options:

laterwith_changesnevernull

Tennis Results & Odds Scraper - ATP, WTA, Challenger, ITF

dami_studio/tennis-matches-scraper

Every tennis match TennisExplorer lists for the days you pick: tour, level, tournament, surface, round, both players, set scores with tiebreaks, winner, retirements and average odds. Upcoming matches come with odds too. Filter by tour, level, tournament, player or surface.

Dami's Studio

Tennis Live Scores API 🎾 (ATP, WTA, ITF, set stats)

tagadanar/tennis-live-scores

Live, finished and upcoming tennis matches in one dataset: set-by-set scores with tiebreaks, who is serving, the current game score, surface and winner. ATP, WTA, Challenger, ITF, qualifying, singles and doubles, 7 days back and 2 ahead. Optional per-set serve and break-point statistics. No API key.

Tagada Data

Tennis Live Scores Scraper: ATP, WTA, Sets, Stats and Rankings

getascraper/tennis-live-scores-scraper

Scrape live tennis scores, fixtures, rankings and match stats across ATP, WTA, Challenger and ITF. Set-by-set scores, surface, seeds, serve stats and point-by-point server data. Works with Google Sheets, Zapier, or as an MCP tool for AI agents. No login needed. From $0.79 per 1,000 results.

GetAScraper

Tennis Abstract Scraper - Rankings, Elo & Player Stats

scrapesage/tennis-scraper

Scrape ATP & WTA tennis data: official rankings, Tennis Abstract Elo ratings with hard/clay/grass surface splits, and full player profiles with career match history. No key, no login. Export JSON, CSV, Excel. Independent tool, not affiliated with Tennis Abstract.

Scrape Sage

Tennis Scraper & API - Live Scores

parsebird/tennis-scraper-api-live-scores

All-in-one tennis data API: live scores, tournament schedules, point-by-point, seasons, and player rankings with Elo ratings from SofaScore and Tennis Abstract.

ParseBird

Tennis Match Data — Live, Fixtures, Results & Model-Ready Stats

signallayer/tennis-match-data

Tennis data for ATP, WTA, Challenger & ITF: live scores, fixtures, results, rankings and model-ready pre-match feature rows (form, H2H, surface splits).

Max

Tennis Scores Scraper — ATP & WTA Live Scores & Rankings

seemuapps/tennis-scraper

Get live tennis scores, results, schedules, and world rankings for ATP and WTA tours. Set-by-set scores, rounds, courts, player countries. No API key.

Seemu Scraping

Tennis Rankings Scraper - ATP & WTA Live Player Stats

axery/tennis-rankings-scraper

Fast and lightweight ATP and WTA tennis rankings extractor. Extract live world rankings, points, age, country, and tournament progress with zero blocking.

Axery

Flashscore Tennis Scraper — Live Scores, Results & Stats

scrapersdelight/flashscore-tennis-scraper

Scrape every tennis match on Flashscore for any day in its 9-day window — ATP, WTA, Challenger and ITF, singles and doubles — with set-by-set scores, tiebreaks, winner, live game state, players, country, surface, and optional full match statistics. No API key.