# Tennis Results & Odds Scraper: ATP, WTA, Challenger, ITF (`tablewise/tennis-results-scraper`) Actor

Scrape tennis results and fixtures for any date: ATP, WTA, Challenger and ITF, singles and doubles. Set-by-set scores with tiebreaks, winner, walkovers and retirements, betting odds, head-to-head and start time in UTC. Export to JSON, CSV or Excel, or use the API.

- **URL**: https://apify.com/tablewise/tennis-results-scraper.md
- **Developed by:** [table wise](https://apify.com/tablewise) (community)
- **Categories:** Sports
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 matches

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What is Tennis Results & Odds Scraper?

Tennis Results & Odds Scraper gets tennis match results and upcoming fixtures
for any date, from ATP and WTA down to Challenger, ITF and UTR events, singles
and doubles: set-by-set scores with tiebreaks, the winner, walkovers and
retirements, pre-match betting odds, head-to-head for upcoming matches, and
the start time in UTC. Pick a date or a date range and get one row per match.
No API key needed.

### What you can do with it

- **Build a results database:** every ATP, WTA, Challenger and ITF match of a
  season, with scores and odds, for analysis or machine learning.
- **Betting research:** compare pre-match odds with results, or get tomorrow's
  fixtures with odds and head-to-head every morning on a schedule.
- **Feed a site or an app** with daily results and upcoming matches.
- **Track a tournament or a tour:** filter ATP, WTA or doubles only.
- Feed tennis data to an AI agent through Apify's MCP server.

### Use cases

Ready-to-run examples, with the input already filled in:

- [Get the latest ATP tennis results with odds](https://apify.com/tablewise/tennis-results-scraper/examples/latest-atp-tennis-results-with-odds):
  men's singles from the latest day (ATP, Challenger and ITF) with set scores and betting odds.
- [Get the latest WTA tennis results with odds](https://apify.com/tablewise/tennis-results-scraper/examples/latest-wta-tennis-results-with-odds):
  women's singles from the latest day (WTA, ITF and other pro events) with set scores and betting odds.

### Example output

Two real rows from test runs on 2026-11-14. A result:

```json
{
  "match_id": "3378153",
  "match_url": "https://www.tennisexplorer.com/match-detail/?id=3378153",
  "date": "2026-11-13",
  "time_cet": "17:10",
  "start_time_utc": "2026-11-13T16:10:00Z",
  "tournament": "Stockholm",
  "tournament_url": "https://www.tennisexplorer.com/stockholm/2026/atp-men/",
  "tournament_country": "SE",
  "category": "men's singles",
  "player1_name": "Fritz T.",
  "player1_url": "https://www.tennisexplorer.com/player/fritz-f1aa7/",
  "player1_seed": "1",
  "player2_name": "Musetti L.",
  "player2_url": "https://www.tennisexplorer.com/player/musetti/",
  "player2_seed": "3",
  "status": "completed",
  "winner": 1,
  "player1_sets": 2,
  "player2_sets": 0,
  "set_scores": ["6-4", "6-2"],
  "score": "6-4 6-2",
  "odds_player1": 1.58,
  "odds_player2": 2.34,
  "h2h_player1_wins": null,
  "h2h_player2_wins": null,
  "scraped_at": "2026-11-14T20:03:40Z"
}
```

And a fixture, with odds and head-to-head:

```json
{
  "match_id": "3377733",
  "date": "2026-11-15",
  "time_cet": "14:00",
  "start_time_utc": "2026-11-15T13:00:00Z",
  "tournament": "Masters Cup ATP",
  "category": "men's singles",
  "player1_name": "Zverev A.",
  "player2_name": "Jodar R.",
  "status": "scheduled",
  "winner": null,
  "score": null,
  "odds_player1": 1.42,
  "odds_player2": 2.88,
  "h2h_player1_wins": 1,
  "h2h_player2_wins": 0
}
```

| Field | What it is |
| --- | --- |
| `match_id`, `match_url` | Match id and detail page on TennisExplorer |
| `date`, `time_cet`, `start_time_utc` | Match date and time as listed (Central European time), and the time in UTC |
| `tournament`, `tournament_url`, `tournament_country` | Tournament, its page and the host country code |
| `category` | men's singles, women's singles, men's doubles or women's doubles |
| `player1_name`, `player1_url`, `player1_seed` (and `player2_...`) | Players or doubles teams, their pages and seeds or entry tags (1, WC, Q...) |
| `status` | `completed`, `walkover`, `ended_early` (retirement), `scheduled`, `in_progress` or `unknown` |
| `winner`, `player1_sets`, `player2_sets` | Who won (1 or 2) and sets won |
| `set_scores`, `score` | Games per set from player 1's side; `7-6(5)` means the tiebreak loser won 5 points |
| `odds_player1`, `odds_player2` | Decimal pre-match betting odds as shown on the site |
| `h2h_player1_wins`, `h2h_player2_wins` | Fixtures only: head-to-head wins |

### What it costs

| Event | Price |
| --- | --- |
| Actor start | USD 0.0005 per run |
| Match | USD 0.005 per match |

**Example:** the 50 latest ATP results = USD 0.25; 1,000 matches = USD 5.00,
plus USD 0.0005 per run.

You only pay for matches delivered. Days without matches and failed pages
are not charged. Use **Maximum matches** to cap the spend: a busy day with
all tours has more than 400 matches.

#### How many matches can I get with the free plan?

Apify's free plan includes USD 5 of credit every month. Used only for
this Actor, that is about 995 matches: for example, 5 runs of 199 matches =
5 × (0.0005 + 199 × 0.005) = USD 4.98.

### How to use it

1. Choose **What to get**: Results or Fixtures.
2. Choose the **Tour**: All, ATP singles (with Challenger), WTA singles, ATP
   doubles or WTA doubles.
3. Set a **Start date** and an **End date** (YYYY-MM-DD), or leave both empty:
   Results then returns the latest day with matches, and Fixtures returns
   today and tomorrow.
4. Set **Maximum matches** and click **Start**. Download the results as JSON,
   CSV or Excel.

You can also run it from the API, on a schedule, or let an AI agent call it
through Apify's MCP server.

#### Input

| Field | Type | Default | What it does |
| --- | --- | --- | --- |
| `mode` | string | `results` | `results` or `fixtures` |
| `tour` | string | `all` | `all`, `atp-single`, `wta-single`, `atp-double` or `wta-double` |
| `startDate` | string | — | Start date, YYYY-MM-DD |
| `endDate` | string | — | End date, YYYY-MM-DD (up to 366 days per run) |
| `maxMatches` | integer | 200 | Stops after this many matches |
| `delayBetweenRequests` | integer | 3 | Seconds between pages |
| `proxyConfiguration` | object | `{"useApifyProxy": true}` | Apify Proxy settings |

### Speed and reliability

One page per day and tour. In our tests on Apify: the latest 50 results in
9 seconds; 2,000 ATP singles results over 9 days in 102 seconds; 231 WTA
doubles results over 6 days in 39 seconds; every page answered on the first
try. Results are listed from the most recent day backwards.

### Limits and known issues

- Players are listed the way the site shows them: surname and initial
  ("Fritz T."), and doubles as "Grevelius E. / Heinonen A.".
- Times are the site's Central European times; `start_time_utc` converts
  them. Some fixtures have no time yet (`--:--` on the site): both fields are
  then empty.
- `ended_early` means the match finished before the last set was complete,
  almost always a retirement; the site does not say which.
- Odds are the pre-match odds the site shows, and not every match has them:
  in our tests, 119 of 2,000 ATP singles results and 135 of 242 next-day
  fixtures came without odds.
- Head-to-head is only on the fixtures pages.
- Point-by-point data, match statistics and rankings are not included.
- Data comes from public TennisExplorer pages: sports data only, no contact
  details or social media.

### FAQ

#### Which tournaments are included?

With **All**: ATP, WTA, Challenger, ITF and UTR events, singles and doubles.
Even in the off-season there are usually matches: on 24 December 2025 the
site listed 60 ITF matches.

#### Can I get a whole season?

Yes: set a date range of up to 366 days and a high **Maximum matches**. A
busy day with all tours has 400 to 500 matches.

#### Do I need an account or an API key?

No. It reads the same public pages any visitor sees.

#### Is it legal to scrape tennis results?

This Actor only reads pages that anyone can open without logging in, and it
does not collect personal data. Whether scraping is allowed depends on your
country and on how you use the data, and the source site's terms of use may
restrict automated access. If you are not sure, ask a lawyer.

#### Can I run it from the API or from Python?

Yes: with the Apify API or the official Apify clients for Python and
JavaScript. This call runs the Actor and returns the rows when it finishes
(it waits up to 5 minutes; for longer runs, start the run and read its
dataset when it ends):

```bash
curl -X POST "https://api.apify.com/v2/acts/tablewise~tennis-results-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer <YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"mode": "results", "tour": "atp-single", "startDate": "2026-11-13", "maxMatches": 100}'
```

#### Can I schedule it or send the results to other tools?

Yes. You can run it on a schedule, export each run as JSON, CSV or Excel, get
a webhook when it finishes, and connect it to Make, Zapier, n8n, Google
Drive, Slack and other tools through Apify integrations.

#### Can AI agents use it?

Yes. AI agents can find and run it through Apify's MCP server
(`https://mcp.apify.com`). Every output field has a description, so an agent
knows what each value means.

### Support

Found a problem? Open an issue on the Actor's **Issues** tab with the run ID
and we'll look into it.

### More Actors from the same developer

- [Google Hotels Scraper](https://apify.com/tablewise/google-hotels-scraper): hotel prices for your dates, ratings and prices by booking site.
- [Google Trends Scraper](https://apify.com/tablewise/google-trends-scraper): interest over time, interest by region and related queries for any keyword.
- [Semrush Domain Metrics Scraper](https://apify.com/tablewise/semrush-domain-metrics-scraper): Authority Score, backlinks, referring domains and traffic for any list of domains.
- [YouTube Transcript & Subtitles Scraper](https://apify.com/tablewise/youtube-transcript-scraper): the transcript of any YouTube video, Short or channel as text or SRT, with the video details.
- [Website Email & Contact Scraper](https://apify.com/tablewise/website-email-contact-scraper): emails, phones and social profiles from any list of websites.
- [LinkedIn Company Scraper](https://apify.com/tablewise/linkedin-company-scraper): size, industry, employees, website and offices of any LinkedIn company page.
- [LinkedIn Jobs Scraper](https://apify.com/tablewise/linkedin-jobs-scraper): LinkedIn job postings with full description, salary, seniority and applicants, without login.
- [Company Jobs Scraper: Workday, Greenhouse, Lever & Ashby](https://apify.com/tablewise/workday-greenhouse-lever-jobs-scraper): every open job from company careers sites on those four platforms.
- [AliExpress Search Scraper](https://apify.com/tablewise/aliexpress-search-scraper): prices, discounts, ratings and units sold from any AliExpress search.
- [Amazon Best Sellers Scraper](https://apify.com/tablewise/amazon-bestsellers-scraper): the top 100 of any Amazon.com Best Sellers or Hot New Releases list.
- [Amazon Product Details Scraper](https://apify.com/tablewise/amazon-product-details-scraper): price, Best Sellers Rank, specs and images for any list of ASINs.

# Actor input Schema

## `mode` (type: `string`):

Results: finished matches with scores. Fixtures: scheduled matches with odds and head-to-head.

## `tour` (type: `string`):

All includes ATP, WTA, Challenger, ITF and UTR events, singles and doubles.

## `startDate` (type: `string`):

YYYY-MM-DD, Central European date. Leave both dates empty for the latest day with results (results) or today and tomorrow (fixtures).

## `endDate` (type: `string`):

YYYY-MM-DD. Leave it empty for a single day. Up to 366 days per run.

## `maxMatches` (type: `integer`):

Stops after this many matches, so you never pay for more than this.

## `delayBetweenRequests` (type: `integer`):

Pause between pages (one page per day).

## `proxyConfiguration` (type: `object`):

Apify Proxy settings. On by default (datacenter proxy).

## Actor input object example

```json
{
  "mode": "results",
  "tour": "all",
  "maxMatches": 50,
  "delayBetweenRequests": 3,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One row per match: tournament, players, set-by-set score, winner, status, betting odds and head-to-head.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "results",
    "tour": "all",
    "maxMatches": 50,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("tablewise/tennis-results-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "results",
    "tour": "all",
    "maxMatches": 50,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("tablewise/tennis-results-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "results",
  "tour": "all",
  "maxMatches": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call tablewise/tennis-results-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tablewise/tennis-results-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Yg9BibtjFZuBuiuAq/builds/UF5B5FkNArEvI0cwE/openapi.json
