# Tennis Scraper & Odds API | Live Scores, Results, H2H | $1/1k (`trev0n/tennis-scraper`) Actor

Tennis results, fixtures and betting odds for ATP, WTA, Challenger and ITF: scores with tie-breaks, round, surface, H2H, odds from 15+ bookmakers with opening prices and line movement, player match history, and rankings.

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

## Pricing

from $1.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

## 🎾 Tennis Scraper & Odds API: Live Scores, Results, Betting Odds & H2H

🎯 **Every professional tennis match in one clean dataset: live and final scores with tie-breaks, the schedule, head-to-head records and bookmaker odds with opening prices and line movement. From $1 per 1,000 matches.**

Collect live scores, results and upcoming matches from the ATP and WTA tours, Grand Slams, Challengers, ITF and UTR events, in singles and doubles, for today or any day since 2008. Each match comes with the tournament, level and country, both players and their seeds, the score set by set, the status (finished, retired, walkover, live, scheduled) and average odds. Turn on match details to add the round, surface, both players' rank, age, height and playing hand, the full head-to-head, and odds from up to 15 bookmakers, with over/under, handicap and correct-score markets. Player profiles with career win/loss by surface and season, and ATP and WTA rankings, are included too. All data comes from TennisExplorer.

### ⚡ Quick Start

Press **Start** with the prefilled input and you get **today's ATP and WTA matches**: finished results, matches in progress and the rest of the day's schedule, each with average odds. A typical day has 500 to 700 singles matches across all levels.

**📡 Live and today's matches, refreshed every 15 minutes.** Schedule this input and each run returns only the matches that started, changed score, finished or had their odds move since the previous run:

```json
{
    "dateFrom": "today",
    "tours": ["atp-single", "wta-single"],
    "statuses": ["live", "scheduled"],
    "incrementalMode": true,
    "maxResults": 0
}
```

**📈 Historical betting dataset for a prediction model.** A full season of results with surface, round, ranks and the odds of every bookmaker:

```json
{
    "dateFrom": "2025-01-01",
    "dateTo": "2025-12-31",
    "tours": ["atp-single"],
    "levels": ["main"],
    "includeMatchDetails": true,
    "maxResults": 0
}
```

**🎯 Tomorrow's matches with opening odds**, to compare against the closing price later:

```json
{
    "dateFrom": "tomorrow",
    "tours": ["atp-single", "wta-single"],
    "includeMatchDetails": true,
    "includeOddsMovement": true
}
```

### 🚀 What Does It Do?

This scraper reads tennis results, schedules, odds, players and rankings for you and delivers **structured, ready-to-use data**. You do not have to open a single match page by hand.

💡 **Four ways to use it:**

1. **📅 Matches by date**: pick a day or a date range (up to 400 days) and the tours. You get every match with its score, or the schedule for days that have not been played yet.
2. **👤 Players**: type names such as "Jannik Sinner" or "Iga Swiatek". You get a profile with win/loss by season and surface, and the player's full match history for the seasons you choose, or for the whole career.
3. **🏆 Rankings**: ATP and WTA singles, doubles and race, current or for a past week, as deep as you need.
4. **📋 Direct URLs**: paste any TennisExplorer day list, tournament, match, player or ranking page.

🔁 **Monitoring mode** remembers what earlier runs saw. Schedule it every hour, and each run returns only new matches, matches that finished, and matches whose odds moved. You pay only for what changed.

### 👥 Who Is This For?

| 🏢 Use Case                             | 💬 How It Helps                                                                                                        |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| 📈 **Sports bettors & tipsters**        | Compare opening and closing odds from up to 15 bookmakers, spot line moves, and check the head-to-head before you bet. |
| 🤖 **Model builders & data scientists** | Build prediction models on years of results with surface, round, ranks, set scores and market odds in one table.       |
| 📰 **Sports media & apps**              | Fill live-score pages, draws and player cards with fresh results, schedules and rankings every hour.                   |
| 🎯 **Fantasy & prediction platforms**   | Settle contests automatically with final scores, retirements and walkovers already marked.                             |
| 🏫 **Coaches, academies & scouts**      | Follow juniors and ITF players, their results by surface and their ranking climb week by week.                         |
| 📊 **Analysts & researchers**           | Study upsets, tie-break rates, surface specialists and betting-market accuracy across the tour.                        |

### ✨ Features

- 🌍 **Every tour and level**: ATP, WTA, Grand Slams, Challenger, ITF / Futures, UTR and team events, singles and doubles.
- 📅 **Any day since 2008**: results for past days, the schedule for today and tomorrow, date ranges up to 400 days in one run.
- 🎾 **Full scores**: every set, tie-break points, sets won, winner, and best of three or five.
- 🚦 **Match status**: finished, retired, walkover, live or scheduled, worked out for you from the score.
- 💰 **Bookmaker odds**: average match odds on every match, plus up to 15 bookmakers with opening prices on match pages.
- 📉 **Line movement (optional)**: the timestamped history of every price change, from opening to the last update.
- 🎲 **More markets (optional)**: over/under sets and games, Asian handicap, correct score.
- 🤝 **Head-to-head**: the full H2H record and every previous meeting, with tournament, surface, round and score.
- 🧑 **Player data**: rank at the time of the match, birth date, height, weight and playing hand.
- 📚 **Career histories**: every match of a player for chosen seasons or the whole career, with round, surface and odds.
- 🏆 **Rankings**: ATP and WTA singles, doubles and race, current or any past week, with points and weekly movement.
- 🔁 **Incremental monitoring**: only new matches, finished matches and moved odds after the first run.
- ⚡ **Fast & Scalable**: a full day of matches in seconds, and tens of thousands of matches per run.
- 🧹 **Deduplication**: a match found by several lists or players is delivered once.
- 📤 **Export Anywhere**: Download results as JSON, CSV, Excel, or push to Google Sheets, Zapier, Make, or your CRM

### 🎛️ Filters & Options

| Option                                    | What It Does                                                                           |
| ----------------------------------------- | -------------------------------------------------------------------------------------- |
| 📅 **From date / To date**                | A day or a range: exact dates, "today", "yesterday", "tomorrow" or "-7" for a week ago |
| 🎾 **Tours**                              | ATP singles, WTA singles, ATP doubles, WTA doubles                                     |
| 🏅 **Tournament levels**                  | Main tour, Challenger, ITF / Futures, UTR, team events, other                          |
| 🚦 **Match status**                       | Finished, retired, walkover, live or scheduled matches only                            |
| 🔎 **Only matches of player**             | Keep matches of one player, e.g. "Alcaraz"                                             |
| 💰 **Add match details & bookmaker odds** | Round, surface, ranks, player bio, head-to-head and odds from every bookmaker          |
| 🎲 **Odds markets**                       | Match winner, over/under, Asian handicap, correct score                                |
| 📉 **Include odds movement**              | Every price change with its time                                                       |
| 👤 **Players**                            | Player names or player page links                                                      |
| 📚 **Player seasons**                     | Seasons of match history, or "all" for the whole career                                |
| 🗂️ **Include player match history**       | Profiles only, or profiles with every match                                            |
| 🏆 **Rankings**                           | ATP / WTA singles, doubles and race                                                    |
| 🗓️ **Ranking week**                       | A past ranking week instead of the current one                                         |
| 🔢 **Ranking positions**                  | How deep to read each ranking                                                          |
| 🔢 **Maximum matches**                    | How many matches to collect in one run (0 = all)                                       |
| ⚙️ **Pages in parallel**                  | Speed controls for lists and match pages                                               |
| 🔁 **Incremental monitoring**             | Only new and changed matches, with a named baseline                                    |
| 🔗 **Direct URLs**                        | Any TennisExplorer day list, tournament, match, player or ranking page                 |

### 📦 What You Get (Output Fields)

Every match includes:

#### Match

| Field           | Example                                                   |
| --------------- | --------------------------------------------------------- |
| matchId         | `3326821`                                                 |
| matchUrl        | `https://www.tennisexplorer.com/match-detail/?id=3326821` |
| date            | `2026-09-20`                                              |
| startTimeUtc    | `2026-09-20T00:05:00.000Z`                                |
| status          | `finished`                                                |
| tour / tourName | `wta-single` / `WTA singles`                              |
| gender / format | `women` / `singles`                                       |
| bestOf          | `3`                                                       |

#### Tournament

| Field                 | Example                                                            |
| --------------------- | ------------------------------------------------------------------ |
| tournamentName        | `Guadalajara 2 WTA`                                                |
| tournamentUrl         | `https://www.tennisexplorer.com/guadalajara-2-wta/2026/wta-women/` |
| tournamentYear        | `2026`                                                             |
| tournamentCountryCode | `mx`                                                               |
| tournamentLevel       | `main`                                                             |
| round                 | `final`                                                            |
| surface               | `hard`                                                             |

#### Players & Score

| Field                               | Example                                               |
| ----------------------------------- | ----------------------------------------------------- |
| player1Name / player2Name           | `Jovic I.` / `Stearns P.`                             |
| player1Url                          | `https://www.tennisexplorer.com/player/jovic-19208/`  |
| player1Seed                         | `2`                                                   |
| winner / winnerName                 | `1` / `Jovic I.`                                      |
| player1SetsWon / player2SetsWon     | `2` / `0`                                             |
| score                               | `6-4, 6-2`                                            |
| sets                                | `[{"player1": 6, "player2": 4, "tiebreak": null}, …]` |
| player1FullName                     | `Jovic Iva`                                           |
| player1Rank / player2Rank           | `13` / `36`                                           |
| player1BirthDate / player2BirthDate | `2007-12-06` / `2001-10-08`                           |
| player1HeightCm / player1WeightKg   | `null` / `null` (filled when the site lists them)     |
| player1Plays                        | `right`                                               |

#### Odds & Head-to-Head

| Field                           | Example                                                                                                            |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| player1Odds / player2Odds       | `1.28` / `3.66`                                                                                                    |
| bookmakerOdds                   | `[{"bookmaker": "10Bet", "player1": 1.29, "player2": 3.5, "player1Opening": 1.29, "player2Opening": 3.4, …}]`      |
| overUnderOdds                   | `[{"market": "Over/Under 2.5 sets", "line": 2.5, "over": 2.6, "under": 1.44, …}]`                                  |
| asianHandicapOdds               | `[{"market": "Asian Handicap -1.5 sets", "line": -1.5, "player1": 1.09, "player2": 6, …}]`                         |
| correctScoreOdds                | `[{"score": "2:0", "bookmaker": "10Bet", "odds": 1.73}]`                                                           |
| h2hPlayer1Wins / h2hPlayer2Wins | `1` / `0`                                                                                                          |
| h2hMatches                      | `[{"year": 2026, "tournamentName": "Guadalajara 2 WTA", "surface": "hard", "round": "F", "score": "6-4, 6-2", …}]` |

#### Players (profile records)

| Field                            | Example                                                                                        |
| -------------------------------- | ---------------------------------------------------------------------------------------------- |
| fullName                         | `Sinner Jannik`                                                                                |
| country                          | `Italy`                                                                                        |
| birthDate / age                  | `2001-08-16` / `25`                                                                            |
| heightCm / weightKg              | `188` / `76`                                                                                   |
| singlesRank / singlesHighestRank | `1` / `1`                                                                                      |
| careerWinLoss                    | `{"summary": {"wins": 465, "losses": 138}, "clay": {"wins": 119, "losses": 46}, …}`            |
| winLossByYear                    | `[{"year": 2026, "summary": {"wins": 45, "losses": 4}, "grass": {"wins": 8, "losses": 0}, …}]` |

#### Rankings (ranking records)

| Field                 | Example                   |
| --------------------- | ------------------------- |
| ranking / rankingDate | `atp-race` / `2026-09-21` |
| rank / move           | `4` / `0`                 |
| playerName            | `Alcaraz Carlos`          |
| country / countryCode | `Spain` / `es`            |
| points                | `4050`                    |

### 📊 Example Output

```json
{
    "recordType": "match",
    "matchId": 3326821,
    "matchUrl": "https://www.tennisexplorer.com/match-detail/?id=3326821",
    "date": "2026-09-20",
    "startTimeUtc": "2026-09-20T00:05:00.000Z",
    "status": "finished",
    "tour": "wta-single",
    "tourName": "WTA singles",
    "gender": "women",
    "format": "singles",
    "tournamentName": "Guadalajara 2 WTA",
    "tournamentUrl": "https://www.tennisexplorer.com/guadalajara-2-wta/2026/wta-women/",
    "tournamentYear": 2026,
    "tournamentCountryCode": "mx",
    "tournamentLevel": "main",
    "round": "final",
    "surface": "hard",
    "bestOf": 3,
    "player1Name": "Jovic I.",
    "player1Url": "https://www.tennisexplorer.com/player/jovic-19208/",
    "player1Slugs": ["jovic-19208"],
    "player1Seed": "2",
    "player2Name": "Stearns P.",
    "player2Url": "https://www.tennisexplorer.com/player/stearns-1fdf2/",
    "player2Slugs": ["stearns-1fdf2"],
    "player2Seed": null,
    "winner": 1,
    "winnerName": "Jovic I.",
    "player1SetsWon": 2,
    "player2SetsWon": 0,
    "score": "6-4, 6-2",
    "sets": [
        { "player1": 6, "player2": 4, "tiebreak": null },
        { "player1": 6, "player2": 2, "tiebreak": null }
    ],
    "player1Odds": 1.28,
    "player2Odds": 3.66,
    "h2hBeforeMatch": null,
    "source": "matchList",
    "player1FullName": "Jovic Iva",
    "player1Rank": 13,
    "player1BirthDate": "2007-12-06",
    "player1HeightCm": null,
    "player1WeightKg": null,
    "player1Plays": "right",
    "player1PhotoUrl": "https://www.tennisexplorer.com/res/img/player/n9qpZeH4-tjoxv74H.jpeg",
    "player2FullName": "Stearns Peyton",
    "player2Rank": 36,
    "player2BirthDate": "2001-10-08",
    "player2HeightCm": null,
    "player2WeightKg": null,
    "player2Plays": "right",
    "player2PhotoUrl": "https://www.tennisexplorer.com/res/img/player/KMmIUv0R-hfdXHCbh.jpeg",
    "h2hPlayer1Wins": 1,
    "h2hPlayer2Wins": 0,
    "h2hMatches": [
        {
            "year": 2026,
            "tournamentName": "Guadalajara 2 WTA",
            "tournamentUrl": "https://www.tennisexplorer.com/guadalajara-2-wta/2026/wta-women/",
            "surface": "hard",
            "round": "F",
            "winnerName": "Jovic",
            "loserName": "Stearns",
            "score": "6-4, 6-2"
        }
    ],
    "detailFetched": true,
    "averageOdds": { "player1": 1.28, "player2": 3.66 },
    "bookmakerOdds": [
        {
            "bookmaker": "10Bet",
            "player1": 1.29,
            "player2": 3.5,
            "player1Opening": 1.29,
            "player2Opening": 3.4,
            "openingTime": "2026-09-19T09:45:00.000Z",
            "player1Movement": [
                { "time": "2026-09-19T14:04:00.000Z", "odds": 1.29 },
                { "time": "2026-09-19T11:57:00.000Z", "odds": 1.3 }
            ],
            "player2Movement": [{ "time": "2026-09-19T23:03:00.000Z", "odds": 3.5 }]
        }
    ],
    "overUnderOdds": [
        {
            "market": "Over/Under 2.5 sets",
            "unit": "sets",
            "line": 2.5,
            "bookmaker": "10Bet",
            "over": 2.6,
            "under": 1.44
        }
    ],
    "asianHandicapOdds": [
        {
            "market": "Asian Handicap -1.5 sets",
            "unit": "sets",
            "line": -1.5,
            "bookmaker": "10Bet",
            "player1": 1.09,
            "player2": 6
        }
    ],
    "correctScoreOdds": [{ "score": "2:0", "bookmaker": "10Bet", "odds": 1.73 }],
    "scrapedAt": "2026-09-23T10:25:45.629Z"
}
```

### 📋 Dataset Views

The Apify Console gives you **5 ready-made table views** to quickly browse your results:

| View                        | What It Shows                                                                  |
| --------------------------- | ------------------------------------------------------------------------------ |
| 📊 **Matches**              | Date, time, tournament, level, players, score, status, winner and average odds |
| 💰 **Match details & odds** | Round, surface, ranks, head-to-head and bookmaker odds                         |
| 👤 **Players**              | Profiles with rank, age, height, playing hand and career win/loss              |
| 🏆 **Rankings**             | Ranking week, position, movement, player, country and points                   |
| 🔁 **Monitoring**           | What changed since the last run: new matches, results, moved odds              |

The full dataset always holds every field.

### ❓ FAQ

**🤔 Which matches are covered?**
Everything TennisExplorer lists: Grand Slams, ATP and WTA tournaments, the Finals, Challengers, ITF / Futures, UTR events and team competitions such as the Davis Cup and Billie Jean King Cup, in singles and doubles. Qualifying rounds are included.

**🤔 How far back does it go?**
Daily results go back to 2008, and player pages cover whole careers. One run can read up to 400 days, and you can run the scraper again for older ranges.

**🤔 Can I get upcoming matches and odds before they start?**
Yes. Set the date to "today" or "tomorrow" and choose the "Scheduled" status. Turn on match details to add every bookmaker's current and opening odds, and schedule the run every hour with monitoring mode to catch line moves.

**🤔 How are retirements and walkovers marked?**
The status field says `retired` when a match ended before the last set was complete, `walkover` when it was never played, and `live` for a match in progress. The winner is filled in for all finished, retired and walkover matches.

**🤔 In which time zone are the times?**
All times are UTC, and days are split in UTC too, so a date range means the same thing wherever you are.

**🤔 Can I export the data?**
Yes: JSON, CSV, Excel, XML, HTML, RSS. You can also push data directly to Google Sheets, Zapier, Make, or any webhook/API endpoint.

**🤔 Can I use it as a live score feed?**
Yes. Set the date to "today", turn on monitoring mode and schedule the run every 10 to 15 minutes. Each run reads the day's lists in a few seconds and returns only the matches that started, changed score or finished. The score of a match in progress includes the games of the current set, for example `6-1, 2-0`. Points inside a game are not included, so for point-by-point data this scraper is not the right tool.

**🤔 How often should I run this?**
Every 10 to 15 minutes for live scores, every hour for odds and line moves, and once a day for results. You can schedule automatic runs on Apify with just a few clicks.

**🤔 Does it work with proxies?**
Yes. It runs fine without a proxy, which is the fastest and cheapest setting. If the site ever starts refusing requests, the run switches to Apify's residential proxies by itself.

### 🛠️ Need Custom Filters or Features?

**I'm happy to customize this scraper for your specific needs!** 🤝

Whether you need:

- 🎯 Additional filters (specific tournaments, surfaces, ranking ranges, favourites vs underdogs, odds thresholds)
- 📊 Extra data fields or custom output formats, such as one row per bookmaker or per set
- 🔄 Integration with your CRM, Google Sheets, or database
- ⏰ Scheduled scraping with automatic deduplication
- 🌐 Scraping from other sports statistics and odds platforms alongside TennisExplorer

👉 **Don't hesitate to reach out via private message**. I respond quickly and I'm always open to building exactly what you need. No request is too small or too specific!

### ⚖️ Legal & Ethical Use

This scraper collects **only publicly available information** from TennisExplorer. It does not log in, access private accounts or place bets. Please use the data responsibly and in compliance with applicable laws and the site's terms of service.

# Actor input Schema

## `dateFrom` (type: `string`):

First day of matches (UTC): YYYY-MM-DD, "today", "yesterday", "tomorrow", or a day offset such as "-7". Past days return results, today and later return the schedule. Leave empty to skip match lists when you only want players or rankings (with nothing else set, yesterday is used).

## `dateTo` (type: `string`):

Last day (inclusive), same formats as From date. Empty = the same day as From date. Up to 400 days per run.

## `tours` (type: `array`):

Which match lists to read. Challengers, ITF and UTR events are part of these lists; narrow them down with Tournament levels.

## `levels` (type: `array`):

Keep only these levels. Empty = all. Main tour covers Grand Slams, ATP, WTA and the Finals.

## `statuses` (type: `array`):

Keep only matches with these statuses. Empty = all. Retired and walkover are worked out from the score.

## `playerFilter` (type: `string`):

Keep only matches whose player names contain this text, e.g. "Sinner" or "Swiatek".

## `includeMatchDetails` (type: `boolean`):

Open every match page and add round, surface, both players' rank, birth date, height, weight and playing hand, the head-to-head record, and odds from every listed bookmaker with opening prices. One extra page per match, billed as a match-details event.

## `oddsMarkets` (type: `array`):

Which odds tables to add when match details are on.

## `includeOddsMovement` (type: `boolean`):

Add the timestamped history of every price change for each bookmaker's match-winner odds, from opening to the last update.

## `detailConcurrency` (type: `integer`):

How many match pages load at the same time.

## `players` (type: `array`):

Player names ("Jannik Sinner", "Iga Swiatek") or player page URLs. Each one returns a profile with win/loss by season and surface, plus the player's matches.

## `playerSeasons` (type: `array`):

Seasons of match history to read, e.g. "2025", "2024", or "all" for the whole career. Empty = the current season.

## `includePlayerMatches` (type: `boolean`):

Also output every singles, doubles and mixed match on the player pages, with round, surface, score and odds.

## `rankings` (type: `array`):

Ranking lists to output.

## `rankingDate` (type: `string`):

A past ranking week as YYYY-MM-DD (the nearest published week is used). Empty = the current ranking.

## `maxRankingPositions` (type: `integer`):

How many positions to read from each ranking (50 per page).

## `startUrls` (type: `array`):

Any tennisexplorer.com page: a day's match list or results, a tournament page, a match page, a player page or a ranking page.

## `maxResults` (type: `integer`):

Stop after this many matches (counted after filters). 0 = no limit. Player profiles and ranking rows are not counted.

## `maxConcurrency` (type: `integer`):

How many list, player and ranking pages load at the same time.

## `incrementalMode` (type: `boolean`):

Remember what previous runs saw and emit only new matches and matches whose status, score or odds changed. Schedule it every hour to track results and line moves while paying only for what changed.

## `stateKey` (type: `string`):

Name the baseline this run compares against. Leave empty to derive one from the input.

## `emitUnchanged` (type: `boolean`):

Also emit matches that have not changed since the previous run.

## `emitExpired` (type: `boolean`):

Emit a record for matches seen before that are no longer in the lists (for example a moving date window).

## `proxyFallback` (type: `boolean`):

If the site starts refusing requests, the rest of the run continues through Apify residential proxies instead of losing results.

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

No proxy is the default and the fastest, cheapest setting.

## Actor input object example

```json
{
  "dateFrom": "today",
  "dateTo": "",
  "tours": [
    "atp-single",
    "wta-single"
  ],
  "levels": [],
  "statuses": [],
  "playerFilter": "",
  "includeMatchDetails": false,
  "oddsMarkets": [
    "homeAway"
  ],
  "includeOddsMovement": false,
  "detailConcurrency": 5,
  "players": [],
  "playerSeasons": [],
  "includePlayerMatches": true,
  "rankings": [],
  "rankingDate": "",
  "maxRankingPositions": 100,
  "startUrls": [],
  "maxResults": 100,
  "maxConcurrency": 5,
  "incrementalMode": false,
  "stateKey": "",
  "emitUnchanged": false,
  "emitExpired": false,
  "proxyFallback": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `details` (type: `string`):

No description

## `players` (type: `string`):

No description

## `rankings` (type: `string`):

No description

## `runSummary` (type: `string`):

No description

# 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 = {
    "dateFrom": "today",
    "tours": [
        "atp-single",
        "wta-single"
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("trev0n/tennis-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 = {
    "dateFrom": "today",
    "tours": [
        "atp-single",
        "wta-single",
    ],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("trev0n/tennis-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 '{
  "dateFrom": "today",
  "tours": [
    "atp-single",
    "wta-single"
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call trev0n/tennis-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,trev0n/tennis-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/lOKuX6OyeuhTZrdZR/builds/wHqv2mhXfNdpNtfsj/openapi.json
