Tennis Scores and Results Scraper: how to get ATP, WTA, Odds, Rankings as JSON/CSV (API, Python, no code)

Q: How do I use the Tennis Scores and Results Scraper from Python?

Install the apify-client package, create a client with your Apify API token, call the Actor v0iddo/tennis-scores-api with an input like the one above, and read the rows from the run's dataset. The Python snippet above does exactly that.

Q: How do I limit the number of results?

Set the maxItems input field to the number of results you need; the run stops there, so it also caps the cost of one run. You can also set a maximum cost for a run in the run options on Apify, and the run stops when it is reached.

Scrape tennis scores: ATP and WTA match results of any day with set by set scores, tiebreaks, winner and pre-match odds, the day's schedule, current WTA singles or doubles rankings, or the WTA season calendar. This guide shows the output fields, a working input, and Python, JavaScript and cURL code for the Actor v0iddo/tennis-scores-api on Apify.

Open Tennis Scores and Results Scraper on Apify

What data you get

One row per result. Every row can be downloaded as JSON, CSV, Excel or HTML, or read through the API.

Field	Label	Type	Example
`date`	Date	text	2026-11-06
`time`	Time	text	23:15
`tournamentName`	Tournament	text	Paris
`player1`	Player 1	text	Ruud C.
`player2`	Player 2	text	Borges N.
`score`	Score	text	7-6(5) 6-4
`winner`	Winner	text	Ruud C.
`odds1`	Odds 1	number	1.43
`odds2`	Odds 2	number	2.83
`rank`	Rank	number
`playerName`	Player	text
`rankingPoints`	Ranking Points	number
`tour`	Tour	text	ATP
`url`	URL	URL	https://www.tennisexplorer.com/match-detail/?id=3371175
`matchId`		text	3371175
`startTimeUtc`		text	2026-11-06T22:15:00Z
`status`		text	finished
`matchType`		text	atp-single
`tournamentUrl`		text	https://www.tennisexplorer.com/paris/2026/atp-men/
`countryCode`		text	FR
`player1Url`		text	https://www.tennisexplorer.com/player/ruud-dfb38/
`player2Url`		text	https://www.tennisexplorer.com/player/borges-8d823/
`setsWon1`		number	2
`setsWon2`		number	0
`setScores`		list	["7-6(5)", "6-4"]

Input example

This is the input that is pre-filled on the Actor page. Change the values for your own run.

{
  "dataType": "match_results",
  "matchType": "all",
  "days": 1,
  "maxItems": 20
}

Input field	Type	What it does
`dataType`	string	matchresults: finished matches of a day with set scores, winner and odds.
`matchType`	string	Which matches to read: all (ATP and WTA, singles and doubles), atp-single, wta-single, atp-double or wta-double.
`date`	string	Day to read as YYYY-MM-DD.
`days`	integer	Number of days to read: matchresults goes back from Date, upcomingmatches goes forward from it.
`rankingType`	string	Singles or doubles ranking.
`maxPages`	integer	Number of ranking list pages to fetch.
`maxItems`	integer	The run stops after this many result rows.

Output sample

Real rows from a run of the Actor. Fields that name people are left out of the sample.

[
  {
    "matchId": "3371175",
    "date": "2026-11-06",
    "time": "23:15",
    "startTimeUtc": "2026-11-06T22:15:00Z",
    "status": "finished",
    "tour": "ATP",
    "matchType": "atp-single",
    "tournamentName": "Paris",
    "tournamentUrl": "https://www.tennisexplorer.com/paris/2026/atp-men/",
    "countryCode": "FR",
    "player1": "Ruud C.",
    "player1Url": "https://www.tennisexplorer.com/player/ruud-dfb38/",
    "player2": "Borges N.",
    "player2Url": "https://www.tennisexplorer.com/player/borges-8d823/",
    "setsWon1": 2,
    "setsWon2": 0,
    "setScores": [
      "7-6(5)",
      "6-4"
    ],
    "score": "7-6(5) 6-4",
    "winner": "Ruud C.",
    "odds1": 1.43,
    "odds2": 2.83,
    "url": "https://www.tennisexplorer.com/match-detail/?id=3371175"
  },
  {
    "matchId": "3371177",
    "date": "2026-11-06",
    "time": "20:05",
    "startTimeUtc": "2026-11-06T19:05:00Z",
    "status": "finished",
    "tour": "ATP",
    "matchType": "atp-single",
    "tournamentName": "Paris",
    "tournamentUrl": "https://www.tennisexplorer.com/paris/2026/atp-men/",
    "countryCode": "FR",
    "player1": "Alcaraz C.",
    "player1Seed": "2",
    "player1Url": "https://www.tennisexplorer.com/player/alcaraz-5ab70/",
    "player2": "Fritz T.",
    "player2Seed": "11",
    "player2Url": "https://www.tennisexplorer.com/player/fritz-f1aa7/",
    "setsWon1": 2,
    "setsWon2": 1,
    "setScores": [
      "6-7(10)",
      "7-5",
      "6-3"
    ],
    "score": "6-7(10) 7-5 6-3",
    "winner": "Alcaraz C.",
    "odds1": 1.32,
    "odds2": 3.37,
    "url": "https://www.tennisexplorer.com/match-detail/?id=3371177"
  }
]

Code: Python, JavaScript and cURL

Get your API token in Apify Console under Settings, then Integrations. The Actor id is v0iddo/tennis-scores-api.

Python (apify-client)

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run_input = {'dataType': 'match_results', 'matchType': 'all', 'days': 1, 'maxItems': 20}

run = client.actor("v0iddo/tennis-scores-api").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

JavaScript (apify-client)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const input = {
  "dataType": "match_results",
  "matchType": "all",
  "days": 1,
  "maxItems": 20
};

const run = await client.actor('v0iddo/tennis-scores-api').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

cURL

curl -X POST "https://api.apify.com/v2/acts/v0iddo~tennis-scores-api/run-sync-get-dataset-items" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"dataType": "match_results", "matchType": "all", "days": 1, "maxItems": 20}'

Price

$1.95 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $1.36 per 1,000. See the pricing tab for your plan. A new Apify account gets $5 of platform credit every month.

Good to know

Match results (the default) list every finished ATP and WTA match of the day, Challenger events included, with the winner first: set by set games, a tiebreak as 7-6(5), sets won and the two...
Times are the site's (GMT+1, as tennisexplorer.com shows them); startTimeUtc gives the same start in UTC. Doubles rows name both players of each team. status is finished, retired, walkover...
Rankings (dataType wtarankings) cover active WTA tour professionals, about 20 players a page; the WTA calendar (wtatournaments) lists the season's events with start and end dates.
Data reflects what the sites publish at the time of collection; a match in progress is not followed live.

FAQ

What data does the Tennis Scores and Results Scraper return?

Each result is one row in an Apify dataset. Fields include date, time, tournamentName, player1, player2, score, winner, odds1, and more. The table above shows every field with an example value.

How do I use the Tennis Scores and Results Scraper from Python?

Install the apify-client package, create a client with your Apify API token, call the Actor v0iddo/tennis-scores-api with an input like the one above, and read the rows from the run's dataset. The Python snippet above does exactly that.

Can I use it without writing code?

Yes. Open the Actor page on Apify, fill in the input form (an example is already filled in), press Start, and download the results as JSON, CSV, Excel or HTML. You can also schedule runs there.

How much does it cost?

$1.95 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $1.36 per 1,000. A new Apify account gets $5 of platform credit every month.

How do I limit the number of results?

Set the maxItems input field to the number of results you need; the run stops there, so it also caps the cost of one run. You can also set a maximum cost for a run in the run options on Apify, and the run stops when it is reached.

Can I send the results to Google Sheets, Make, Zapier or n8n?

Yes. Apify datasets connect to Google Sheets, Slack, Make, Zapier and n8n, and a webhook can call your own service when a run finishes. You can also export the dataset as JSON, CSV or Excel.

Open Tennis Scores and Results Scraper on Apify

Related guides

PubMed Scraper: Pull daily-new PubMed citations matching any query.
Freelancer.com Jobs and Projects Scraper: Scrape Freelancer.com job listings by skill: project title, description, average bid and whether it is hour...
Eluta.ca Job Scraper: Scrape Canadian job listings from eluta.ca by keyword and location.