datagrit › Data › Tennis Stats Scraper - ATP & WTA Scores, Rankings

Tennis Stats Scraper - ATP & WTA Scores, Rankings

ATP and WTA tennis match results with set and tiebreak scores, seeds, rankings and player profiles for any date range.

Tennis Stats Scraper returns ATP and WTA tennis matches for any date range as clean, flat rows: tournament, round, players with country and seed, status, winner, the games of every set and the tiebreak points of every tiebreak. The same run can add the current ATP and WTA singles rankings with points and movement, and player profiles with height, playing hand and season record, titles and prize money. It reads the public ESPN tennis JSON API, needs no proxy and no browser, and exports to JSON, CSV or Excel, the Apify API, n8n, Make or AI agents through MCP.

Who is it for?

• Sports bettors and modellers who need results with set and tiebreak scores, retirements and walkovers for back-testing, or the published order of play for the next days.
• Data scientists building win-probability or rating models (Elo, Glicko) from several seasons of tour-level results in one run.
• Journalists and fantasy players who want a player's recent form, a head-to-head record or this week's results across all tournaments.
• Apps and dashboards that show a daily results feed; the only-new mode returns just what changed since the previous run.

What data do you get?

Matches

Every match of the ATP and WTA tournaments ESPN covers, including the Grand Slams with mixed doubles, qualifying rounds and doubles. Doubles rows name both partners of each pair. The tour of a match follows its draw: the women's matches of a combined event such as the China Open are WTA, mixed doubles are Mixed. Junior draws and legends (over-35 and over-45) events are skipped and counted in the run status. A match that ESPN lists in both the ATP and the WTA feed is returned once; if the two feeds differ at that moment, the more advanced state (finished over in progress over scheduled) is kept and the run status says so.

Scores and data quality

Scores are given from the winner's point of view with tiebreak points in brackets and a deciding match tiebreak (doubles and mixed doubles) in square brackets such as [10-4]; ret. marks a retirement and w/o a walkover. ESPN writes match tiebreaks in two ways, either as a 1-0 set with tiebreak points or as a plain set such as 10-4; both come out as [10-4], with the points in the tiebreak fields of that set and 1-0 as its games. A plain 10-8 last set at a Grand Slam before 2023 stays as games, because it can be an advantage set. For finished matches, scoreConsistent is false when the published set scores do not add up to the recorded winner or ESPN's result note still says "leads" or "is tied with"; this happens for a few older matches that were never completed at the source. The run status counts how many completed matches carry set scores and how many players have a known country, and the run fails instead of returning empty scores if the source stops publishing them.

Rankings and players

Rankings are the current singles lists from ESPN's ranking endpoint, which holds the top 150 of the ATP and of the WTA (asking for more returns the same 150). The run status gives the share of ranked players with points and with a country code. Player profiles come from ESPN's player records with the season statistics of the player's tour.

Is it legal to scrape this data?

The Actor reads the public JSON endpoints that serve ESPN's own tennis scoreboard, ranking and player pages. It does not log in, use cookies or bypass any access control. Match results, rankings and player facts such as height or date of birth are published facts about professional athletes. How you use the data, for example in a commercial product, is your responsibility. This description is not legal advice.

Output fields

Every result is one flat record, so it drops straight into a spreadsheet, a database or a CRM.

Sample record

{
  "recordType": "match",
  "id": "186257",
  "tour": "ATP",
  "matchType": "singles",
  "drawName": "Men's Singles",
  "tournamentId": "959",
  "tournamentEventId": "959-2026",
  "tournamentName": "China Open",
  "season": 2026,
  "grandSlam": false,
  "tournamentStartDate": "2026-09-27T04:00:00.000Z",
  "tournamentEndDate": "2026-10-12T03:59:00.000Z",
  "location": "Beijing, China PR",
  "court": "Court 7",
  "round": "Qualifying 1st Round",
  "qualifying": true,
  "startTime": "2026-09-28T03:00:00.000Z",
  "startTimeConfirmed": true,
  "status": "finished",
  "statusDetail": "Final",
  "completed": true,
  "player1Name": "Yannick Hanfmann",
  "player1Id": "3322",
  "player1PlayerIds": "3322",
  "player1Country": "Germany",
  "player1CountryCode": "GER",
  "player1Seed": null,
  "player2Name": "Tomas Machac",
  "player2Id": "3811",
  "player2PlayerIds": "3811",
  "player2Country": "Czechia",
  "player2CountryCode": "CZE",
  "player2Seed": null,
  "winner": 2,
  "winnerName": "Tomas Machac",
  "loserName": "Yannick Hanfmann",
  "setsPlayed": 3,
  "player1SetsWon": 1,
  "player2SetsWon": 2,
  "score": "7-6(9-7) 6-7(6-8) 6-4",
  "scoreConsistent": true,
  "retired": false,
  "walkover": false,
  "tiebreaks": 2,
  "set1Player1": 6,
  "set1Player2": 7,
  "set1TiebreakPlayer1": 7,
  "set1TiebreakPlayer2": 9,
  "set2Player1": 7,
  "set2Player2": 6,
  "set2TiebreakPlayer1": 8,
  "set2TiebreakPlayer2": 6,
  "set3Player1": 4,
  "set3Player2": 6,
  "set3TiebreakPlayer1": null,
  "set3TiebreakPlayer2": null,
  "set4Player1": null,
  "set4Player2": null,
  "set4TiebreakPlayer1": null,
  "set4TiebreakPlayer2": null,
  "set5Player1": null,
  "set5Player2": null,
  "set5TiebreakPlayer1": null,
  "set5TiebreakPlayer2": null,
  "resultNote": "Tomas Machac (CZE) bt Yannick Hanfmann (GER) 7-6 (9-7) 6-7 (6-8) 6-4",
  "rank": 1,
  "previousRank": 1,
  "rankChange": 0,
  "rankingPoints": 11000,
  "rankingDate": "2026-09-24T07:00:00.000Z",
  "playerId": "3623",
  "playerName": "Jannik Sinner",
  "firstName": "Jannik",
  "lastName": "Sinner",
  "country": "Italy",
  "countryCode": "ITA",
  "age": 25,
  "birthPlace": "San Candido, Italy",
  "dateOfBirth": "2001-08-16",
  "heightCm": 191,
  "weightKg": 77,
  "hand": "Right",
  "debutYear": 2018,
  "active": true,
  "seasonYear": 2026,
  "seasonStatsAvailable": true,
  "seasonSinglesWon": 44,
  "seasonSinglesLost": 3,
  "seasonSinglesTitles": 6,
  "seasonDoublesTitles": 0,
  "seasonPrizeMoneyUsd": 11577761,
  "sourceUrl": "https://www.espn.com/tennis/scoreboard/tournament/_/eventId/959-2026/competitionType/1",
  "found": true,
  "scrapedAt": "2026-09-30T18:00:00.000Z"
}

Input

Call it from your code

Run the Actor and get the results in one request. Replace YOUR_APIFY_TOKEN with the token from your Apify account settings.

curl -X POST "https://api.apify.com/v2/acts/datagrit~tennis-stats-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"dataTypes":["matches"],"lastDays":3,"maxItems":50}'

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('datagrit/tennis-stats-scraper').call({
  "dataTypes": [
    "matches"
  ],
  "lastDays": 3,
  "maxItems": 50
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.length, items[0]);

from apify_client import ApifyClient
import os

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("datagrit/tennis-stats-scraper").call(run_input={
  "dataTypes": [
    "matches"
  ],
  "lastDays": 3,
  "maxItems": 50
})
items = client.dataset(run["defaultDatasetId"]).list_items().items
print(len(items), items[0] if items else None)

Frequently asked questions

Related Actors