{
  "openapi": "3.0.1",
  "info": {
    "title": "TennisExplorer Scraper ($5.49/1K): Tennis Results & Odds",
    "description": "Scrape TennisExplorer: ATP, WTA, Challenger and ITF results back to 1990, fixtures with bookmaker odds and odds history, value bets, match statistics and point by point, H2H, players, rankings, tournament calendars and Elo; filters, monitoring and alerts. Unofficial.",
    "version": "0.0",
    "x-build-id": "JqjNAeAmPBQQ9fcS5"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tsutseisoftware~tennisexplorer-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tsutseisoftware-tennisexplorer-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/tsutseisoftware~tennisexplorer-scraper/runs": {
      "post": {
        "operationId": "runs-sync-tsutseisoftware-tennisexplorer-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/tsutseisoftware~tennisexplorer-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-tsutseisoftware-tennisexplorer-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "dateFrom": {
            "title": "Date from",
            "type": "string",
            "description": "First day of matches: a date (2025-07-13), or today, yesterday, tomorrow, -7 (7 days ago), +3. Past days give the results (back to 1990), today and later days the schedule with the odds. Empty = no days (use the URLs, players or tournaments below)."
          },
          "dateTo": {
            "title": "Date to",
            "type": "string",
            "description": "Last day (same formats). Empty = only \"Date from\". At most 366 days per run."
          },
          "lastDays": {
            "title": "Last days",
            "minimum": 0,
            "maximum": 366,
            "type": "integer",
            "description": "Instead of the dates: the results of the last N days (yesterday and the N-1 days before; with \"Upcoming days\" also today). Empty = use the dates."
          },
          "upcomingDays": {
            "title": "Upcoming days",
            "minimum": 0,
            "maximum": 14,
            "type": "integer",
            "description": "Instead of the dates: today and the schedule of the next N days, with the odds."
          },
          "matchTypes": {
            "title": "Match types",
            "type": "array",
            "description": "Which matches of the days, and which tours and draws of the tournaments you name below.",
            "items": {
              "type": "string",
              "enum": [
                "atp-single",
                "wta-single",
                "atp-double",
                "wta-double",
                "all"
              ],
              "enumTitles": [
                "Men's singles (ATP, Challenger, ITF)",
                "Women's singles (WTA, ITF)",
                "Men's doubles",
                "Women's doubles",
                "All (singles, doubles, mixed, juniors)"
              ]
            },
            "default": [
              "atp-single",
              "wta-single"
            ]
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum rows saved (matches, profiles, ranking rows). 0 = no limit. In monitoring: how many matches are watched (the first N in the website's order).",
            "default": 100
          },
          "startUrls": {
            "title": "TennisExplorer URLs",
            "type": "array",
            "description": "Tournament seasons (https://www.tennisexplorer.com/wimbledon/2025/atp-men/, with ?type=double for doubles or ?phase=qualification), players (https://www.tennisexplorer.com/player/sinner-8b8e8/, with ?annual=2024 for a season or ?annual=all), matches (/match-detail/?id=3377747), rankings (/ranking/wta-women/?date=2025-07-07), results or schedule pages and head-to-heads (/mutual/a/b/).",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "players": {
            "title": "Players",
            "type": "array",
            "description": "Players by name (Jannik Sinner, Swiatek) or URL: their matches of the seasons below, and their profile. The log says which player each name was matched to.",
            "items": {
              "type": "string"
            }
          },
          "tournaments": {
            "title": "Tournaments",
            "type": "array",
            "description": "Tournaments by name (Wimbledon, Roland Garros is \"French Open\", Helsinki challenger) or URL: all matches of the seasons below, with rounds, for the tours and draws chosen in \"Match types\".",
            "items": {
              "type": "string"
            }
          },
          "matchIds": {
            "title": "Match IDs",
            "type": "array",
            "description": "TennisExplorer match IDs (the id= of a match URL, e.g. 3377747).",
            "items": {
              "type": "string"
            }
          },
          "playerSeasons": {
            "title": "Player seasons",
            "type": "array",
            "description": "Seasons of the players' matches: years like 2024 and 2025, or \"all\" for the whole career. Empty = the current season.",
            "items": {
              "type": "string"
            }
          },
          "includePlayerProfile": {
            "title": "Add player profiles",
            "type": "boolean",
            "description": "One row per player (rowType \"player\"): country, height, weight, age, handedness, current and highest rank in singles and doubles, career and season wins and losses by surface, titles, the next match, and a summary of the matches read in the run (win rate, tiebreaks and deciding sets won and lost).",
            "default": true
          },
          "tournamentSeasons": {
            "title": "Tournament seasons",
            "type": "array",
            "description": "Years of the tournaments (e.g. 2023, 2024, 2025). Empty = the current year.",
            "items": {
              "type": "string"
            }
          },
          "includeQualificationDraws": {
            "title": "Include qualification draws",
            "type": "boolean",
            "description": "For tournaments by name: also read the singles qualification.",
            "default": false
          },
          "rankings": {
            "title": "Rankings",
            "type": "array",
            "description": "Also save rankings (rowType \"ranking\"): rank, move since the week before, player, country, points. Live rankings: the ranking as it stands during the week (live-tennis.eu, top 1,000) with the points won this week, the current tournament and the points at the next round. Doubles Race: the pairs of the season (Flashscore). Elo: Tennis Abstract's current weekly Elo rating overall and on hard, clay and grass, with the peak.",
            "items": {
              "type": "string",
              "enum": [
                "atp-singles",
                "wta-singles",
                "atp-doubles",
                "wta-doubles",
                "atp-race",
                "wta-race",
                "atp-live",
                "wta-live",
                "atp-doubles-race",
                "wta-doubles-race",
                "atp-elo",
                "wta-elo"
              ],
              "enumTitles": [
                "ATP singles",
                "WTA singles",
                "ATP doubles",
                "WTA doubles",
                "ATP Race (points of the season)",
                "WTA Race",
                "ATP live ranking (during the week)",
                "WTA live ranking (during the week)",
                "ATP doubles Race",
                "WTA doubles Race",
                "ATP Elo ratings (Tennis Abstract)",
                "WTA Elo ratings (Tennis Abstract)"
              ]
            }
          },
          "rankingDate": {
            "title": "Ranking date",
            "type": "string",
            "description": "Ranking of this date (weekly rankings back to 1998; the latest one published on or before it). Empty = the current ranking."
          },
          "rankingDateTo": {
            "title": "Ranking date to",
            "type": "string",
            "description": "With \"Ranking date\": every weekly ranking from that date to this one (at most five years per run; each week is charged as its rows). Empty = one ranking."
          },
          "rankingCountry": {
            "title": "Ranking country",
            "type": "string",
            "description": "Only the players of these countries, in English as TennisExplorer writes them, separated by commas (e.g. usa, italy, czech-republic, great-britain). Empty = all."
          },
          "rankingSort": {
            "title": "Ranking order",
            "enum": [
              "rank",
              "points",
              "name",
              "country",
              "rankChange"
            ],
            "type": "string",
            "description": "Order of the ranking rows.",
            "default": "rank"
          },
          "includeRankingProfiles": {
            "title": "Add profiles of ranked players",
            "type": "boolean",
            "description": "Also save a player profile row for every ranking row saved (one page per player).",
            "default": false
          },
          "maxRank": {
            "title": "Max rank",
            "minimum": 1,
            "maximum": 3000,
            "type": "integer",
            "description": "Ranking rows down to this rank.",
            "default": 100
          },
          "minRank": {
            "title": "Min rank",
            "minimum": 1,
            "maximum": 3000,
            "type": "integer",
            "description": "Ranking rows from this rank on (e.g. 101 with Max rank 200 = ranks 101 to 200). Empty = from 1."
          },
          "onlyMovers": {
            "title": "Only players who moved",
            "type": "boolean",
            "description": "Ranking rows only of players whose rank changed since the ranking before.",
            "default": false
          },
          "calendars": {
            "title": "Tournament calendars",
            "type": "array",
            "description": "Also save the tournaments of the tour's calendar (rowType \"tournament\"): start date, level, category, surface, prize money and currency, draw sizes and the winners. The level, surface and category filters apply.",
            "items": {
              "type": "string",
              "enum": [
                "atp",
                "wta"
              ],
              "enumTitles": [
                "ATP (men)",
                "WTA (women)"
              ]
            }
          },
          "calendarYears": {
            "title": "Calendar years",
            "type": "array",
            "description": "Years of the calendars (e.g. 2024, 2025). Empty = the current year.",
            "items": {
              "type": "string"
            }
          },
          "calendarSearch": {
            "title": "Calendar search",
            "type": "array",
            "description": "Only calendar tournaments whose name has one of these words or names as whole words (e.g. Masters, Open, Halle; \"Halle\" is not every Challenger).",
            "items": {
              "type": "string"
            }
          },
          "bettingRankings": {
            "title": "Betting ranking",
            "type": "array",
            "description": "Also save TennisExplorer's betting ranking (rowType \"ranking\"): how profitable it was to bet on each player in the period (profit or loss of a stake on every match: 100 units as favourite, 50 as outsider), the matches and how often the player was favourite or outsider. Down to \"Max rank\".",
            "items": {
              "type": "string",
              "enum": [
                "season",
                "month",
                "two-weeks"
              ],
              "enumTitles": [
                "Whole season",
                "Last month",
                "Last two weeks"
              ]
            }
          },
          "bettingRankingType": {
            "title": "Betting ranking order",
            "enum": [
              "best",
              "worst"
            ],
            "type": "string",
            "description": "The most profitable or the most loss-making players.",
            "default": "best"
          },
          "bettingRankingYear": {
            "title": "Betting ranking year",
            "type": "string",
            "description": "Season of the betting ranking (e.g. 2025). Empty = the current season."
          },
          "searchPlayers": {
            "title": "Search players",
            "type": "array",
            "description": "Names to look up (e.g. Nadal): one row per player found (rowType \"search\": name, ID, URL, country), the most relevant first, with the one \"Players\" would take marked as chosen. Use it to pick the right player's URL.",
            "items": {
              "type": "string"
            }
          },
          "h2hPairs": {
            "title": "Head-to-head pairs",
            "type": "array",
            "description": "Two players per line, e.g. \"Sinner vs Alcaraz\": their balance, bio and every meeting with the tournament, surface, round and score (rowType \"h2h\").",
            "items": {
              "type": "string"
            }
          },
          "levels": {
            "title": "Tournament levels",
            "type": "array",
            "description": "Only matches of tournaments of these levels. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "grand-slam",
                "tour-finals",
                "main",
                "team",
                "challenger",
                "itf",
                "utr",
                "lower",
                "exhibition"
              ],
              "enumTitles": [
                "Grand Slam",
                "Tour finals (ATP Finals, WTA Finals, Next Gen)",
                "ATP and WTA tour",
                "Team events (Davis Cup, Billie Jean King Cup, United Cup)",
                "Challenger (and WTA 125)",
                "ITF",
                "UTR Pro Tennis Series",
                "All lower levels (Challenger, ITF, UTR...)",
                "Exhibitions"
              ]
            }
          },
          "categories": {
            "title": "Tournament categories",
            "type": "array",
            "description": "Only matches of tournaments of these official categories of their season (from the winner's ranking points; ATP and WTA since 2009, WTA Premier levels by their present names). Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "grand-slam",
                "tour-finals",
                "1000",
                "500",
                "250",
                "125"
              ],
              "enumTitles": [
                "Grand Slam",
                "Tour finals",
                "1000",
                "500",
                "250",
                "WTA 125"
              ]
            }
          },
          "surfaces": {
            "title": "Surfaces",
            "type": "array",
            "description": "Only matches on these surfaces (as TennisExplorer sorts them: indoor hard courts are \"Indoors\"). Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "hard",
                "clay",
                "grass",
                "indoors"
              ],
              "enumTitles": [
                "Hard",
                "Clay",
                "Grass",
                "Indoors"
              ]
            }
          },
          "statuses": {
            "title": "Match status",
            "type": "array",
            "description": "Only matches with these statuses. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "scheduled",
                "finished",
                "retired",
                "walkover",
                "live",
                "cancelled"
              ],
              "enumTitles": [
                "Scheduled",
                "Finished",
                "Finished by retirement",
                "Walkover",
                "In progress (today's list)",
                "Not played (cancelled, no result on a past day)"
              ]
            }
          },
          "tournamentFilter": {
            "title": "Only these tournaments",
            "type": "array",
            "description": "Only matches of these tournaments of the days read (names as TennisExplorer writes them, e.g. Wimbledon, Helsinki challenger, or the tournament URL).",
            "items": {
              "type": "string"
            }
          },
          "playerFilter": {
            "title": "Only these players",
            "type": "array",
            "description": "Only matches of these players (a name or surname, e.g. Sinner, Iga Swiatek, or the player ID sinner-8b8e8).",
            "items": {
              "type": "string"
            }
          },
          "rounds": {
            "title": "Rounds",
            "type": "array",
            "description": "Only these rounds, as TennisExplorer writes them: F, SF, QF, R16, 1R, 2R, 3R, Q1... (tournament and player pages give the round; the lists of days do not).",
            "items": {
              "type": "string"
            }
          },
          "draws": {
            "title": "Singles or doubles",
            "type": "array",
            "description": "Only these draws (useful for players' pages, which list singles, doubles and mixed). Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "singles",
                "doubles",
                "mixed"
              ],
              "enumTitles": [
                "Singles",
                "Doubles",
                "Mixed doubles"
              ]
            }
          },
          "excludeQualification": {
            "title": "Exclude qualification",
            "type": "boolean",
            "description": "Leave out qualification matches.",
            "default": false
          },
          "minOdds": {
            "title": "Min odds",
            "minimum": 1,
            "type": "number",
            "description": "Only matches where at least one player's average odds are at least this (decimal, e.g. 1.5)."
          },
          "maxOdds": {
            "title": "Max odds",
            "minimum": 1,
            "type": "number",
            "description": "Only matches where at least one player's average odds are at most this (e.g. 3.0)."
          },
          "onlyWithOdds": {
            "title": "Only matches with odds",
            "type": "boolean",
            "description": "Save only matches that have odds.",
            "default": false
          },
          "includeMatchDetails": {
            "title": "Add match details",
            "type": "boolean",
            "description": "Players' full names, birth date, age at the match, height, weight, handedness and current rank, the head-to-head before the match, and the odds of every bookmaker with the average, best and opening odds and how much they moved.",
            "default": false
          },
          "includeInjuries": {
            "title": "Add injuries (personal data)",
            "type": "boolean",
            "description": "Player profiles: the injuries and retirements the website lists (dates, tournament, reason such as \"retired - left leg\"). These are health data of a person: you are responsible for processing them lawfully (GDPR). Off by default.",
            "default": false
          },
          "recentFormMatches": {
            "title": "Recent form (matches)",
            "minimum": 0,
            "maximum": 30,
            "type": "integer",
            "description": "With \"Add match details\": each player's last N finished matches before the match (date, tournament, surface, round, opponent, result, score, odds), the form (\"WWLWL\"), the rest days and the load: matches and sets in the 7 and 14 days before and a retirement in the previous match. One page per player and season. Empty = none."
          },
          "h2hLimit": {
            "title": "Head-to-head matches",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "How many earlier meetings of the two players to list (only meetings before the match, safe for prediction models).",
            "default": 10
          },
          "oddsMarkets": {
            "title": "Odds markets",
            "type": "array",
            "description": "Markets whose odds of every bookmaker go to \"Odds lines\" (with \"Add match details\" or \"Add Flashscore odds\"). Every line is graded after the match (won, lost, push, void).",
            "items": {
              "type": "string",
              "enum": [
                "winner",
                "overUnder",
                "handicap",
                "correctScore",
                "oddEven"
              ],
              "enumTitles": [
                "Match winner (home/away)",
                "Over/under (sets and games)",
                "Asian handicap (sets and games)",
                "Correct score (sets)",
                "Odd or even games (Flashscore odds)"
              ]
            },
            "default": [
              "winner"
            ]
          },
          "includeOddsHistory": {
            "title": "Add odds history",
            "type": "boolean",
            "description": "With \"Add match details\": every move of each bookmaker's odds with its time, in \"Odds lines\".",
            "default": false
          },
          "oddsBookmakers": {
            "title": "Bookmakers",
            "type": "array",
            "description": "With \"Add match details\": only these bookmakers (e.g. bet365, Pinnacle, 1xBet; case ignored). The average, best and opening odds are then of these. Empty = all.",
            "items": {
              "type": "string"
            }
          },
          "oddsFormat": {
            "title": "Odds format",
            "enum": [
              "decimal",
              "fractional",
              "american"
            ],
            "type": "string",
            "description": "Also give the main odds in this format, as text next to the decimal numbers (oddsHomeText, oddsAwayText).",
            "default": "decimal"
          },
          "includeFlashscoreOdds": {
            "title": "Add Flashscore odds",
            "type": "boolean",
            "description": "The odds of the bookmakers Flashscore shows in the country below (GB: about 20, such as bet365, Betfred, Paddy Power, Sky Bet, William Hill), also on the 1st and 2nd set and odd or even games, in \"Odds lines\" with source \"flashscore\"; during a match its in-play prices at the time of the run. Charged as \"Flashscore odds\" only for matches with odds.",
            "default": false
          },
          "oddsCountry": {
            "title": "Odds country",
            "enum": [
              "GB",
              "IE",
              "DE",
              "AT",
              "CH",
              "FR",
              "ES",
              "IT",
              "PT",
              "NL",
              "BE",
              "PL",
              "CZ",
              "SK",
              "RO",
              "BG",
              "GR",
              "CY",
              "DK",
              "SE",
              "NO",
              "FI",
              "EE",
              "LV",
              "LT",
              "TR",
              "UA",
              "KZ",
              "GE",
              "AZ",
              "AL",
              "US",
              "US-NJ",
              "US-NY",
              "CA",
              "MX",
              "CO",
              "PE",
              "UY",
              "BR",
              "AU",
              "IN",
              "JP",
              "KR",
              "TH",
              "VN",
              "ID",
              "PH",
              "NG",
              "GH",
              "KE",
              "UG",
              "TZ",
              "ZA",
              "ZM",
              "TN"
            ],
            "type": "string",
            "description": "With \"Add Flashscore odds\": the country whose bookmakers are read (US-NJ and US-NY: a state).",
            "default": "GB"
          },
          "oddsScopes": {
            "title": "Odds periods",
            "type": "array",
            "description": "With \"Add Flashscore odds\": the whole match, the 1st set and the 2nd set (period match, set1, set2 in the odds lines).",
            "items": {
              "type": "string",
              "enum": [
                "FULL_TIME",
                "FIRST_SET",
                "SECOND_SET"
              ],
              "enumTitles": [
                "Whole match",
                "1st set",
                "2nd set"
              ]
            },
            "default": [
              "FULL_TIME",
              "FIRST_SET",
              "SECOND_SET"
            ]
          },
          "minEdgePercent": {
            "title": "Min edge (%)",
            "type": "number",
            "description": "Value bets: every odds line gets its fair price (Pinnacle without margin where Pinnacle has the market, else the bookmakers' consensus without margin), edgePercent and isBestPrice; the row gets bestEdgePercent, valueBetCount and surebetMarginPercent (below 0 = a surebet). With a number here only matches with a line at least this much above its fair price are saved (e.g. 3). Needs \"Add match details\" or \"Add Flashscore odds\". Matches below it are not saved or charged; the odds pages read for them are charged as \"Extra page\". Empty = every match, the lines are rated anyway."
          },
          "includePredictionMarkets": {
            "title": "Add prediction markets",
            "type": "boolean",
            "description": "Singles: the Kalshi and Polymarket prices of the match (probability of each player, bid and ask, volume, Polymarket set and total markets), their average and the edge against the bookmakers. Charged as \"Prediction markets\" only for matches with a market (mostly ATP, WTA and Challenger matches of the last weeks and the next days).",
            "default": false
          },
          "includeMatchStatistics": {
            "title": "Add match statistics",
            "type": "boolean",
            "description": "Finished and live matches of every tour (ATP, WTA, Challenger, ITF; singles and doubles): aces, double faults, first serve in and won, second serve won, break points won and saved, service and return points, winners, unforced errors, net points, total points, for the match and per set (WTA singles also with the duration). Charged as \"Match statistics\" only for matches with statistics.",
            "default": false
          },
          "includePointByPoint": {
            "title": "Add point by point",
            "type": "boolean",
            "description": "Finished and live matches: every game with the score after it, who served, breaks, the points of the game with break, set and match points marked (and counted per game), tie-breaks with their points. Charged as \"Match statistics\" (once per match, also with \"Add match statistics\").",
            "default": false
          },
          "includeLiveState": {
            "title": "Add live state",
            "type": "boolean",
            "description": "Matches in progress: the set being played, who serves, the games of the set and the points of the current game (liveSet, liveServer, liveHomeGames, liveHomePoints...). Free.",
            "default": false
          },
          "includeElo": {
            "title": "Add Elo ratings",
            "type": "boolean",
            "description": "ATP and WTA singles: each player's current Elo rating overall and on the match's surface (Tennis Abstract, weekly; homeEloCurrent, homeSurfaceEloCurrent, eloDate), the win probability from them (overall, surface and their average) and its edge against the bookmakers. Today's rating, not the one at the time of an old match. One page per tour and run.",
            "default": false
          },
          "includeEspn": {
            "title": "Add ESPN data",
            "type": "boolean",
            "description": "Grand Slams, ATP and WTA tour singles: ESPN's match and player IDs, the court and the venue (for joining with ESPN data). One ESPN page per tour and day.",
            "default": false
          },
          "includeRounds": {
            "title": "Add rounds to the matches of days",
            "type": "boolean",
            "description": "The lists of days do not give the round: read it from each tournament's page (one page per tournament and run). Tournament and player pages have it anyway.",
            "default": false
          },
          "includePlayerCountries": {
            "title": "Add players' countries",
            "type": "boolean",
            "description": "Singles: each player's country from the profile (one page per player and run).",
            "default": false
          },
          "includeRankAtMatchTime": {
            "title": "Add rank at the time of the match",
            "type": "boolean",
            "description": "Singles: each player's rank in the official ranking of the week of the match (homeRankAtMatch, awayRankAtMatch, rankDate), not today's rank. Players ranked lower than \"Rank depth\" get null.",
            "default": false
          },
          "rankDepth": {
            "title": "Rank depth",
            "minimum": 50,
            "maximum": 2000,
            "type": "integer",
            "description": "With \"Add rank at the time of the match\": how deep in the ranking to look (300 = the top 300).",
            "default": 300
          },
          "timezone": {
            "title": "Time zone",
            "type": "string",
            "description": "Time zone of the days of the input and of the local start time and match date (e.g. Europe/London, America/New_York). Start times are always also given in UTC.",
            "default": "UTC"
          },
          "outputFields": {
            "title": "Output fields",
            "type": "array",
            "description": "Save only these fields (names as in the output, e.g. homePlayer, awayPlayer, scoreText, oddsHome); id, rowType, url, source and scrapedAt are always kept. Empty = all fields.",
            "items": {
              "type": "string"
            }
          },
          "csvExports": {
            "title": "Match files for models",
            "type": "array",
            "description": "Also save the finished matches as CSV files in the column layouts tennis models read: Jeff Sackmann's match files (MATCHES-SACKMANN.csv) and tennis-data.co.uk (MATCHES-TENNIS-DATA.csv); links in the Output tab. Free. The values are this run's (statistics, ranks and odds only with their options).",
            "items": {
              "type": "string",
              "enum": [
                "sackmann",
                "tennis-data"
              ],
              "enumTitles": [
                "Sackmann layout (winner_*, loser_*, w_ace...)",
                "tennis-data.co.uk layout (W1, L1, B365W, PSW...)"
              ]
            },
            "default": []
          },
          "maxItemsPerSource": {
            "title": "Max matches per URL or day",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum per URL, player season, tournament season or day. Empty = no limit."
          },
          "onlyNewOrChanged": {
            "title": "Monitoring: only new or changed matches",
            "type": "boolean",
            "description": "Return new matches, and matches whose status, score or start time changed, with the previous status and score; ranking rows and profiles whose rank, points or record changed.",
            "default": false
          },
          "monitoringKey": {
            "title": "Monitoring key",
            "type": "string",
            "description": "Name of the remembered state; use a different key for every saved search. Empty = \"default\"."
          },
          "monitorOdds": {
            "title": "Monitoring: odds changes",
            "type": "boolean",
            "description": "Also return matches whose average odds moved, with the previous odds.",
            "default": false
          },
          "minOddsChangePercent": {
            "title": "Monitoring: min odds change (%)",
            "minimum": 0,
            "type": "number",
            "description": "With \"Monitoring: odds changes\": only odds that moved at least this much (default 2 %, 0 = every move).",
            "default": 2
          },
          "onlyOddsAlerts": {
            "title": "Monitoring: only odds alerts",
            "type": "boolean",
            "description": "With \"Monitoring: odds changes\": return only matches whose odds moved at least the minimum change (no new matches, no score changes).",
            "default": false
          },
          "emitExpired": {
            "title": "Monitoring: matches gone from the lists",
            "type": "boolean",
            "description": "Also return scheduled or live matches that were on a list read in full last time and are no longer there (cancelled, withdrawn, moved), once each, with changeType \"expired\".",
            "default": false
          },
          "onlyNew": {
            "title": "Monitoring: only new matches",
            "type": "boolean",
            "description": "Return new matches only, not changed ones.",
            "default": false
          },
          "skipFirstRun": {
            "title": "Monitoring: silent first run",
            "type": "boolean",
            "description": "The first run only remembers the matches and returns nothing; later runs return what changed.",
            "default": false
          },
          "resetMonitoring": {
            "title": "Monitoring: start again",
            "type": "boolean",
            "description": "Forget the remembered matches of this Monitoring key.",
            "default": false
          },
          "telegramBotToken": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "Token of your bot from @BotFather."
          },
          "telegramChatId": {
            "title": "Telegram chat ID",
            "type": "string",
            "description": "Chat, group or channel to send to (e.g. 123456789 or -1001234567890)."
          },
          "slackWebhookUrl": {
            "title": "Slack webhook URL",
            "type": "string",
            "description": "Incoming webhook (https://hooks.slack.com/...)."
          },
          "discordWebhookUrl": {
            "title": "Discord webhook URL",
            "type": "string",
            "description": "Webhook of your Discord channel (https://discord.com/api/webhooks/...). In Discord: channel settings → Integrations → Webhooks → Copy Webhook URL. Stored encrypted."
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "Any HTTPS URL (Zapier, Make, n8n, your server): receives the matches as JSON."
          },
          "whatsappAccessToken": {
            "title": "WhatsApp access token",
            "type": "string",
            "description": "Access token of the WhatsApp Cloud API of your Meta business account, used with \"WhatsApp phone number ID\" and \"WhatsApp recipient number\" (step by step in the README, section \"WhatsApp notifications: setup\"). For scheduled runs use a permanent token of a system user: Business settings → System users → Generate token, with the permissions whatsapp_business_messaging and whatsapp_business_management; the token of WhatsApp → API Setup expires within hours. Stored encrypted."
          },
          "whatsappPhoneNumberId": {
            "title": "WhatsApp phone number ID",
            "type": "string",
            "description": "ID of your WhatsApp business number that sends the message (not the number itself), e.g. 106540352242922. In your Meta app: WhatsApp → API Setup → Phone number ID."
          },
          "whatsappTo": {
            "title": "WhatsApp recipient number",
            "type": "string",
            "description": "Phone number that gets the message, in international format with the country code (e.g. +420601234567); up to 5 numbers separated by commas or new lines, each gets its own message and the notification is charged once per run. A test number of Meta sends only to numbers you added and confirmed under API Setup → To. Stored encrypted."
          },
          "whatsappTemplateName": {
            "title": "WhatsApp template name",
            "type": "string",
            "description": "Name of your approved message template (WhatsApp Manager → Message templates, e.g. apify_results), recommended: WhatsApp delivers a template message at any time. Its body gets the run summary with the first results in {{1}} and the dataset link in {{2}} (a template with only {{1}} gets both in {{1}}). Empty: a plain text message, which WhatsApp delivers only when the recipient wrote to your business number in the last 24 hours, so a scheduled run usually needs a template. Meta charges your business account for template messages (step by step in the README, section \"WhatsApp notifications: setup\")."
          },
          "whatsappTemplateLanguage": {
            "title": "WhatsApp template language",
            "type": "string",
            "description": "Language code of the template exactly as WhatsApp Manager → Message templates shows it next to the template, e.g. en_US, en_GB, cs, sk, pl or de. Used only with \"WhatsApp template name\".",
            "default": "en_US"
          },
          "notificationLimit": {
            "title": "Max matches per notification",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many matches the message lists.",
            "default": 10
          },
          "notifyOnlyChanges": {
            "title": "Notify only when something was found",
            "type": "boolean",
            "description": "No message after a run that saved nothing.",
            "default": true
          },
          "maxRequestsPerMinute": {
            "title": "Max requests per minute",
            "minimum": 10,
            "maximum": 180,
            "type": "integer",
            "description": "How fast the actor reads TennisExplorer (default 90, at most 180).",
            "default": 90
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 6,
            "type": "integer",
            "description": "How many pages the actor reads at the same time (default 4, at most 6).",
            "default": 4
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "No proxy needed. TennisExplorer is not available from the Czech Republic: with your own proxy, use another country. A run through a residential proxy may be charged a little more to cover its traffic.",
            "default": {
              "useApifyProxy": false
            }
          },
          "exportFormats": {
            "title": "Extra export formats",
            "type": "array",
            "description": "Off by default. Printable HTML report: the results as a clean, branded table with the main columns, made for printing, saving as PDF or sending to someone; for working with the data use Excel or CSV, which have every field. Markdown table: the same columns as text for AI tools, docs or GitHub. The Output tab links the files. Each file has the overview columns of every saved row and nothing is left out, so a run with tens of thousands of rows makes a file of tens of MB that can be slow to open; for big runs use the dataset or its Excel export. Excel (XLSX), CSV and JSON are always in the Output tab and under Export, at no extra cost.",
            "items": {
              "type": "string",
              "enum": [
                "html",
                "markdown"
              ],
              "enumTitles": [
                "Printable HTML report",
                "Markdown table"
              ]
            },
            "default": []
          },
          "sendErrorReports": {
            "title": "Send error reports",
            "type": "boolean",
            "description": "When a run fails, send the developer a short error report: the error and your input with secrets left out (tokens, webhooks and e-mails are hidden). Your results are never sent. Reports are deleted after at most 120 hours. Turn off to send nothing.",
            "default": true
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}