Flashscore Tennis Scraper & API | ATP, WTA, ITF Live Scores, Stats, Odds

The deepest Flashscore tennis record on Apify: 54 fields per match, available as a dataset or as a real-time HTTP API.

 

Zen Studio Sports Data   •  Scores, stats and odds across every major source
🎾  Flashscore Tennis ➤ You are here	Bet365 Scores 13 sports, live	Bet365 Sports Data Fixtures, stats, history	DraftKings Odds Lines, props, SGP

 

What you get that a plain Flashscore scrape misses
🎾 Tiebreak scores filled in	A 7-6 set returns 9-7 in the breaker, not an empty placeholder
📊 Point by point	Every point of every game, with break, set and match points marked
💰 Bookmaker odds	Up to 20 books per market, opening and current, best price per selection
🏆 Round and seeding	Final, Semi-finals, 1/8-finals, plus each player's seed and entry route
📅 Past seasons	Whole tournament draws by year, and the actor tells you what each year holds

 

Key Features

📋  54 fields per match Sets with tiebreak points, surface, round, venue, umpire, timing	👤  15 fields per player Country, photo, seed, entry route, singles and doubles ranking
🔴  Live while it plays Current set, game score, who is serving, tiebreak in progress	🌍  Every tour, singles and doubles ATP, WTA, Challenger, ITF, juniors and team events
⚡  Scraper or live API One dataset run, or 10 endpoints on a warm container	🔍  Names, not ids "US Open", "wta", "Final", "2013" all work as filters

 

How to Scrape Flashscore Tennis Data

Basic: today's matches

{
    "dayOffsets": ["0"]
}

Yesterday's ATP and WTA singles results

{
    "dayOffsets": ["-1"],
    "tours": ["atp", "wta"],
    "matchTypes": ["singles"],
    "matchStatuses": ["finished"]
}

One tournament, with odds and full match detail

{
    "dayOffsets": ["-1", "0"],
    "tournaments": ["US Open"],
    "includeOdds": true,
    "oddsMarkets": ["GB"],
    "enrich": ["statistics", "points"]
}

A past season

{
    "tournaments": ["wimbledon"],
    "seasons": ["2024", "2023"]
}

Leave Past seasons empty to collect by day. Fill it in and the run returns completed draws for every tournament you named, one year at a time.

Input Parameters

Parameter	Type	Default	Description
dayOffsets	array	["0"]	Days relative to today, -7 to +7. 0 is today.
matchStatuses	array	["all"]	finished, live, scheduled, or all.
tours	array	all	atp, wta, challenger, itf, juniors, teams.
matchTypes	array	both	singles or doubles.
tournaments	array	all	Keep tournaments whose name contains one of these. Also names which tournaments to collect for past seasons.
startUrls	array	none	Restrict to specific tournament pages. Takes precedence over the name filter.
seasons	array	none	Years to collect, e.g. ["2024"]. Switches the run from day mode to past seasons.
enrich	array	none	summary, statistics, points, h2h, highlights, news, detail.
includeRounds	boolean	true	Round name and player seeding.
includeRankings	boolean	true	ATP or WTA ranking and points. Not applied to past seasons.
includeOdds	boolean	false	Bookmaker odds for every match.
oddsMarkets	array	["GB"]	Which market's bookmakers to return. Bookmakers are country-specific.
maxItems	integer	none	Stop after this many matches.

What Data Can You Extract from Flashscore Tennis?

Every match record carries:

• Identity and timing: match id, link, singles or doubles, start and end time, both as ISO and unix.
• State: status, result type (finished, retired, walkover, awarded, canceled), current set, whether a tiebreak is in play, live game score, who is serving.
• Result: winner, sets won, and per-set games with tiebreak points.
• Players: name, short name, id, nationality, photo, seed, entry route, and singles plus doubles ranking with points and previous rank.
• Tournament: name, category, country, surface, round, ids, and the Flashscore page.
• Betting: which bookmakers are taking live bets, and full odds when requested.

Output Example

{
  "match_id": "6k4MeS57",
  "match_url": "https://www.flashscore.com/match/tennis/6k4MeS57/",
  "match_type": "singles",
  "match_date": "2026-09-11T19:15:00+00:00",
  "match_end_timestamp": "2026-09-11T22:16:02+00:00",
  "end_timestamp": 1789164962,
  "last_period_timestamp": 1789164962,
  "start_timestamp": 1789154100,
  "match_status": "FINISHED",
  "match_status_code": 3,
  "result_type": "FINISHED",
  "result_type_code": 3,
  "current_set": null,
  "in_tiebreak": false,
  "match_note": null,
  "walkover_note": null,
  "winner": "home",
  "sets_won_home": 3,
  "sets_won_away": 0,
  "sets": [
    {
      "set_number": 1,
      "home": 6,
      "away": 3,
      "tiebreak_home": null,
      "tiebreak_away": null,
      "duration": null,
      "duration_minutes": null
    },
    {
      "set_number": 2,
      "home": 7,
      "away": 6,
      "tiebreak_home": 9,
      "tiebreak_away": 7,
      "duration": null,
      "duration_minutes": null
    },
    {
      "set_number": 3,
      "home": 7,
      "away": 6,
      "tiebreak_home": 8,
      "tiebreak_away": 6,
      "duration": null,
      "duration_minutes": null
    }
  ],
  "current_game_score_home": null,
  "current_game_score_away": null,
  "current_server": null,
  "home_players": [
    {
      "name": "Zverev A.",
      "short_name": "ZVE",
      "slug": "zverev-alexander",
      "id": "dGbUhw9m",
      "team_id": "vejGE316",
      "nationality": "Germany",
      "nationality_id": 81,
      "photo_url": "https://static.flashscore.com/res/image/data/lU8NIJlC-2DqYxEbl.png",
      "seed": 1,
      "entry_status": null,
      "ranking": 2,
      "ranking_points": 7790,
      "previous_ranking": 2,
      "singles_ranking": 2,
      "doubles_ranking": 109
    }
  ],
  "away_players": [
    {
      "name": "Khachanov K.",
      "short_name": "KHA",
      "slug": "khachanov-karen",
      "id": "4bNPtZT5",
      "team_id": "C8lOCsWI",
      "nationality": "World",
      "nationality_id": 8,
      "photo_url": "https://static.flashscore.com/res/image/data/dI1pPHjC-hz8C9Mh1.png",
      "seed": null,
      "entry_status": null,
      "ranking": 50,
      "ranking_points": 1050,
      "previous_ranking": 49,
      "singles_ranking": 50,
      "doubles_ranking": 142
    }
  ],
  "home_team": "Zverev A.",
  "away_team": "Khachanov K.",
  "tournament_name": "US Open (USA)",
  "tournament_short_name": "US Open",
  "tournament_qualifier": null,
  "tournament_header": "ATP - SINGLES: US Open (USA), hard",
  "tournament_id": "65k5lHxU",
  "tournament_stage_id": "tQZGKy9k",
  "tournament_season_id": "IJYwdktC",
  "tournament_url": "https://www.flashscore.com/tennis/atp-singles/us-open/",
  "tournament_logo_url": "https://static.flashscore.com/res/image/data/SS8DFXWI-l6sarjdt.png",
  "category_name": "ATP - Singles",
  "category_id": 9011,
  "tour_id": 5724,
  "stage_type_id": 5,
  "country": "USA",
  "surface": "hard",
  "season": null,
  "round_name": "Semi-finals",
  "round_id": 2,
  "seed_home": 1,
  "seed_away": null,
  "entry_status_home": null,
  "entry_status_away": null,
  "broadcasters": [],
  "live_betting_bookmaker_ids": [],
  "has_live_betting": null,
  "play_dates": [],
  "odds": [
    {
      "market": "GB",
      "bookmakers": [
        {
          "id": 14,
          "name": "10bet"
        },
        {
          "id": 15,
          "name": "William Hill"
        },
        {
          "id": 16,
          "name": "bet365"
        },
        "... 17 more"
      ],
      "markets": [
        {
          "bookmaker_id": 983,
          "bookmaker": "Parimatch.uk",
          "bet_type": "HOME_AWAY",
          "scope": "FIRST_SET",
          "has_live_betting": false,
          "selections": [
            {
              "selection": "home",
              "side": "home",
              "participant_id": "vejGE316",
              "value": 1.36,
              "opening": 1.36,
              "active": true,
              "handicap": null,
              "handicap_type": null,
              "score": null
            },
            {
              "selection": "away",
              "side": "away",
              "participant_id": "C8lOCsWI",
              "value": 2.88,
              "opening": 2.88,
              "active": true,
              "handicap": null,
              "handicap_type": null,
              "score": null
            }
          ]
        },
        "... 122 more"
      ],
      "best": [
        {
          "bet_type": "ASIAN_HANDICAP",
          "scope": "FIRST_SET",
          "selection": "away",
          "handicap": "-1.5",
          "handicap_type": "SETS",
          "value": 4.4,
          "bookmaker": "Unibetuk",
          "bookmaker_id": 625
        },
        {
          "bet_type": "ASIAN_HANDICAP",
          "scope": "FIRST_SET",
          "selection": "away",
          "handicap": "1.5",
          "handicap_type": "SETS",
          "value": 2.03,
          "bookmaker": "Unibetuk",
          "bookmaker_id": 625
        },
        "... 106 more"
      ]
    },
    "... 1 more market"
  ]
}

Selecting enrich adds statistics, points, head_to_head, summary, highlights, news and detail blocks to the same record.

Real-Time Tennis API: Query It Live Instead

Switch the actor to Standby and it answers HTTP instead of writing a dataset. The container stays warm between calls, so a listing you already asked for comes back without refetching.

Live data

Endpoint	Method	Description
/matches	GET	Matches for a day, with every filter the scraper has
/live	GET	Only matches in play right now
/match/{matchId}	GET	One match, optionally enriched

Match detail

Endpoint	Method	Description
/match/{matchId}/summary	GET	Set durations, umpire, venue, total match time
/match/{matchId}/stats	GET	Aces, serve percentages, break points, per set
/match/{matchId}/points	GET	Point by point, with break, set and match points
/match/{matchId}/h2h	GET	Head-to-head history for both players
/match/{matchId}/odds	GET	Bookmaker odds with best price per selection

Discovery (free)

Endpoint	Method	Description
/tournaments	GET	Find a tournament by name
/seasons	GET	Every season it has, and what one season actually holds
/draw	GET	The bracket: rounds, entrants, and who received a bye
/match/{matchId}/available	GET	Which detail a match has before you ask for it
/health	GET	Health check

Past seasons

Endpoint	Method	Description
/history	GET	A whole past season of matches. Billed per match returned.

Quick Start

Find a tournament, see its seasons, pull a year:

curl "https://zen-studio--flashscore-tennis-api.apify.actor/tournaments?q=wimbledon" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN"

curl "https://zen-studio--flashscore-tennis-api.apify.actor/seasons?tournament=wimbledon&season=2013" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN"

curl "https://zen-studio--flashscore-tennis-api.apify.actor/history?tournament=wimbledon&season=2013&round=Final" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN"

Today's ATP matches with odds:

curl "https://zen-studio--flashscore-tennis-api.apify.actor/matches?tour=atp&odds=true&oddsMarkets=GB" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN"

Response Format

{
    "success": true,
    "count": 42,
    "total": 130,
    "matches": [ ]
}

count is what came back, total is how many matched before the page limit.

Error Codes

Code	Meaning	What to do
400	A parameter value is not valid	The message names the parameter and the accepted values
402	Free plan allowance reached	Upgrade your Apify plan
404	Match, tournament or season not found	For older matches use /history, or pass day=
503	Tennis data is temporarily unavailable	Retry

Advanced Usage

Ready-made configurations for live score tracking, betting model inputs, historical backfill, and doubles analysis.

Live scoreboard, refreshed on a schedule

{
    "dayOffsets": ["0"],
    "matchStatuses": ["live"],
    "includeRankings": true
}

Odds across several markets

{
    "dayOffsets": ["0", "1"],
    "includeOdds": true,
    "oddsMarkets": ["GB", "DE", "US"]
}

Bookmakers are country-specific: most operate in exactly one market, so pick the markets you can actually bet in. Best prices are computed inside each market, because a price you cannot act on is not a comparison.

Historical backfill for one tournament

{
    "tournaments": ["french open"],
    "seasons": ["2024", "2023", "2022", "2021", "2020"]
}

Doubles only, with head-to-head

{
    "dayOffsets": ["-1"],
    "matchTypes": ["doubles"],
    "enrich": ["h2h"]
}

Run it on a schedule to keep a dataset current: hourly during a Grand Slam, daily otherwise. Results flow into Google Sheets, Make, Zapier or your own webhook through Apify's integrations.

How to run the scraper and put it on a schedule (official Apify videos):

Pricing: Pay Per Event

You pay for what a run produces, not for time. Prices below are the standard rate; higher Apify plans get an automatic volume discount on every event.

Running it as a scraper

Event	Per unit	Per 1,000
Match in the dataset	$0.002	$2.00
Bookmaker odds, per match per market	$0.005	$5.00
Extra match detail, per match per section	$0.006	$6.00
Run start	$0.005	one per run

A day of ATP and WTA singles, about 20 matches, costs around $0.05. The same day with odds is about $0.15.

Querying it as an API

Event	Per unit	Per 1,000
Listing call (/matches, /live)	$0.010	one per call
Match returned by a listing	$0.002	$2.00
Match returned from a past season (/history)	$0.002	$2.00
Bookmaker odds, per match per market	$0.005	$5.00
One match section (/match/{id}/...)	$0.006	$6.00

A match costs the same whether you scrape it or request it, so neither mode is the cheap way to get the same data. The listing call fee applies to every call, including one that matches nothing, so filter server-side rather than polling speculatively.

Free: /tournaments, /seasons, /draw, /match/{id}/available and /health. Find what exists and what a season holds before you pay for any of it.

API usage also consumes Apify platform credit for the time the server is running, billed by Apify at your plan's rate and separate from the events above. It shuts down after a few idle minutes, so you pay for the time you actually use. If you query it only occasionally, running it as a scraper on a schedule is cheaper.

FAQ

What is Flashscore? Flashscore is a live-score service covering tennis alongside dozens of other sports, publishing scores, draws, statistics and bookmaker odds. This actor covers its tennis side: ATP, WTA, Challenger, ITF, juniors and team events, singles and doubles.

Does this include ATP and WTA? Yes, plus ATP Challenger, ITF men's and women's, junior events (boys and girls) and team competitions. Filter with tours.

Can I get live tennis scores in real time? Yes. A live match returns the current set, the game score, who is serving, and whether a tiebreak is in play. Note that during a tiebreak the game score holds tiebreak points rather than 0/15/30/40.

Does it return set-by-set scores and tiebreaks? Yes, both. Every set returns games for each player and the tiebreak points where one was played, so a 7-6 set shows the breaker as 9-7 rather than leaving it blank.

Can I get bookmaker odds for tennis matches? Yes, with includeOdds. You get match winner, over/under, handicap, correct score and odd/even, with opening and current prices, plus the best available price for every selection. Choose the market with oddsMarkets.

How far back does the historical tennis data go? It depends on the tournament and on which data you want, so the actor reports it rather than promising a single year. Grand Slams reach much further back than Challengers, and statistics and point-by-point start much later than results do. Ask /seasons?tournament=X&season=Y and it tells you exactly what that season holds before you commit to it.

Does it cover doubles as well as singles? Yes. A doubles record carries both players per side with their own ids, nationalities and doubles rankings, and the pair's shared seed at match level.

Can I get point-by-point data? Yes, via enrich: ["points"] or the /match/{id}/points endpoint. Break points, set points and match points are marked on the points where they occurred.

How do I get tennis data as an API instead of a dataset? Use Standby mode. The actor runs as an HTTP server with 10 endpoints and answers requests directly. See the Standby tab for the hostname.

What's Standby mode? The actor runs as an HTTP server instead of a queued job, so a request is answered directly rather than waiting for a run to start. Apify keeps the container warm while you keep using it and shuts it down after a few idle minutes; the next request after that takes a few seconds while it wakes.

Do I need a proxy? No. There is no proxy option because none is needed, and adding one would only slow your runs down.

How do I export the data? JSON, CSV, Excel, XML or HTML from the run's Storage tab, or through the Apify API. JSON preserves the nested players, sets and odds structures; CSV flattens them.

Is it legal to scrape Flashscore tennis data? This actor extracts publicly available data only, nothing behind a login. You are responsible for complying with Flashscore's terms and with data protection law (GDPR, CCPA). Player names are personal data, so handle them accordingly.

Can I get football or basketball scores here? Not in this actor; it is tennis only. For other sports use Bet365 Live Scores for 13 sports, or Bet365 Sports Data for fixtures and history.

More Zen Studio scrapers for sports betting

🏟️ Sportsbook odds

• FanDuel
  • FanDuel Odds API
• DraftKings
  • DraftKings Odds API
• BetMGM
  • BetMGM Odds API
• Bet365
  • Bet365 Real-Time Odds API
  • Bet365 Sports Data Scraper

🎯 Daily fantasy & player props

• Player Props Aggregator
  • Player Props Line Shopping
• PrizePicks
  • PrizePicks Player Props Scraper
• Underdog Fantasy
  • Underdog Fantasy Player Props API
• Sleeper
  • Sleeper Player Props
• DraftKings Pick6
  • DraftKings Pick6 Player Props
• Bet365
  • Bet365 Player Props API

🎾 Live scores & match data

• Bet365
  • Bet365 Live Scores API

Support

• Bugs: Issues tab
• Features: Issues tab

Legal Compliance

Extracts publicly available data. Users must comply with Flashscore terms and data protection regulations (GDPR, CCPA).

---

Tennis match data from Flashscore: ATP, WTA, Challenger and ITF scores, statistics, point by point, rankings and bookmaker odds, as a dataset or a live API.