Tsutsei Software
Flashscore Scraper icon

Flashscore Scraper

Live scores, results, statistics and odds across 29 sports

This Flashscore scraper turns flashscore.com into rows you can sort and count, one per match, with the competition, start time, status, live minute and score. Livesport.cz, Soccer24 and Tennis24 show the same data. A single run covers 29 sports, from football, tennis, basketball and ice hockey to darts, snooker, cricket and esports. Pick the sports and days, or paste any Flashscore link you have open.

Try it on Apify Store See examples

Countries
ALL
Output
JSON · CSV · Excel · API
Monitoring
New and changed only
Updated

tsutseisoftware/flashscore-scraperdataset · item 1

rowType"match"
sport"football"
country"England"
competition"Premier League"
round"Round 10"
startTime"2026-11-07T15:00:00Z"
startTimeLocal"2026-11-07T15:00:00+00:00"
matchDate"2026-11-07"

One row per match. Download as JSON, CSV or Excel, or read it through the API.

Overview

What you get from Flashscore

A match row names both sides with their IDs, logos and links, the final score, the score of every half, quarter, period or set, and the winner. The result type tells a normal finish from extra time, penalties, a walkover or a retired player. Start times come in UTC and in your own time zone. Tennis rows add the tour, singles or doubles, the surface and the ATP or WTA ranking of both players.

Match details are optional. Turn them on for goals with scorer and assist, cards, substitutions and VAR by the minute, the referee, venue and attendance, statistics with expected goals (xG), lineups with formations and ratings, injured and suspended players, head-to-head and form, and tennis point by point. In top football competitions every player gets their own line with rating, minutes, passes, duels and over a hundred other numbers. Head-to-head holds only games played before the match, so a prediction model never sees the future.

Days reach a week back and a week ahead, as far as Flashscore lists them. For older matches, paste a competition link and choose one season, the last N seasons or a list of them, with results and fixtures. A team or player link brings the full match history, and you can also find them by name. League tables (overall, home, away, form, over/under), top scorers and tennis rankings come as rows as well.

In detail

Flashscore odds, live scores and alerts

Odds are a separate switch. Each bookmaker Flashscore shows for the country you choose gets its own line, next to the average, best and opening odds of the main market and the probabilities with the bookmaker margin taken out. For one Premier League match seen from Great Britain that meant 20 bookmakers. Keep only the markets you need, such as over/under, both teams to score or Asian handicap, and read the prices as decimal, fractional or American.

Monitoring mode is built for runs every few minutes. Each run returns only matches that are new or whose status, score, period scores or start time moved since the last one, with the old values beside them, and odds moves above your threshold count too. Matches that stayed the same are skipped and not charged. After the run, one message with the scores and what changed can go to Telegram, Slack, Discord, WhatsApp or a webhook. Live scores are as fresh as Flashscore's own lists, which can trail the match page by a minute or two.

Features

Why use this Flashscore scraper

  • One actor for every sport

    29 sports in one run, instead of a separate actor per sport, per feature or per league.

  • Days, competitions, seasons, teams, players, tables, top scorers, rankings and matches

    in one input: today's matches, last week's results, the last ten Premier League seasons, a team's full history (by URL or name), the LaLiga home and away tables, the over/under table, the top scorers or the ATP ranking.

  • The data analysts and bettors need

    xG and all statistics, lineups and ratings, player statistics, missing players, H2H and form, period scores, form and over/under tables, and the odds of every bookmaker with fair probabilities and the margin.

  • Live and monitoring

    "Live" reads every match playing right now (also those that started before midnight); monitoring returns only what changed (goals, status, results, odds moves above your threshold), with alerts.

  • Clean, flat data

    numbers as numbers, ISO dates in UTC and in your time zone, stable IDs and URLs for matches, teams, players and competitions, ready for Excel, a database or a model.

Who uses it

Who uses the Flashscore scraper

  • Sports bettors

    Watch the prices of tomorrow's top football matches and get a message when one moves by more than 5 %.

  • Betting model builders

    Pull a full Premier League season with xG, lineups and closing odds into one table to train and back-test a model.

  • Sports media and fan sites

    Feed live scores, standings and top scorers of the leagues you cover into your own pages or a Telegram channel.

  • Analysts and scouts

    Compare player ratings, xG and duels across a season, or follow one tennis player's matches with ranking and surface.

  • Developers and AI agents

    Call the actor through the Apify API or MCP with a short JSON input, and get stable IDs, ISO dates and real numbers in every row.

Output fields

What data can you get

FieldExample
Matchid Eyc1EfPH, url, sport football, country England, competition Premier League, round "Round 10"
TimestartTime 2026-11-07T15:00:00Z, startTimeLocal (your time zone), matchDate 2026-11-07
Statusstatus finished (scheduled, live, postponed, cancelled, interrupted, abandoned, delayed), statusText "After penalties", liveMinute "67'"
Teams or playershomeTeam Arsenal, awayTeam Hull, IDs, short codes, URLs, logos; tennis: country of the player and ATP/WTA ranking
ScorehomeScore 1, awayScore 0, homePeriodScores [0, 1], periodScoresText "0-0, 1-0" (extra time last), winner home, resultType normal, regular-time score after extra time, penalty shoot-out score
TennistennisTour atp, tennisDraw singles, surface indoor hard, tie-breaks in the set scores ("7-6(4)"), point by point with every game, the tie-break points and break, set and match points marked
Match summaryincidents (goal, own goal, penalty goal, missed penalty, cards, substitution, VAR, penalty shoot-out kicks: minute, side, player, assist, score), referee, venue, city, capacity, attendance
Statisticsevery statistic by period; football as columns: homeXg 1.26, awayXg 0.36, possession, shots, shots on target, big chances, corners, cards, fouls, offsides, saves
Lineupsformations, starting XI and substitutes with numbers, captain, goalkeeper, ratings and average rating, coaches, missing players with the reason
Player statisticsplayerStatistics: every player's rating, minutes, goals, assists, shots, xG, xA, passes, touches, tackles, duels, saves, cards and 100+ more (top football competitions)
Head-to-headlast matches of both sides, earlier meetings, form "WWDLW", meetings won by each side
OddsoddsHome 1.14, oddsDraw 8.0, oddsAway 18.2, best and opening odds, probabilityHome 83 %, oddsMarginPercent 5.9, bookmakers 20, every bookmaker's line (1X2, home/away, over/under, Asian and European handicap, both teams to score, double chance, draw no bet, correct score, half/full time, odd/even); only the bookmakers and lines you choose, only matches with odds; also as fractional (1/7) or American (-714) text
Tables and rankingsrowType standing or ranking: rank, team or player, matches, wins, draws, losses, goals, points, form, qualification zone; home, away, form (last 5 and 10) and over/under tables (matches over and under each goal line, goals per match); ranking points
Top scorersrowType topScorer: rank, scorer, nationality, position, team, goals, assists
Raw data (option)rawData: the match as Flashscore's list gives it
MonitoringchangeType new or updated, changedFields, previous status, score and odds

Extra export formats: a printable HTML report or a Markdown table, besides Excel, CSV and JSON. Output fields keeps only the fields you list.

Step by step

How to scrape Flashscore

  1. Choose the sports and the days (or paste Flashscore URLs, or match IDs).
  2. Add filters if you want (status, countries, competitions, teams, top competitions only, tennis tours).
  3. Turn on the match details and odds you need.
  4. Run it, or schedule it in monitoring mode. Download the data as Excel, CSV or JSON, or connect it to your tools.

Try it on Apify Store

Examples

Ready-made inputs

Copy an input into the JSON tab of the actor in Apify Console and run it, or change it to your needs.

01Today's football in the top leagues, with odds

InputJSON

{
  "sports": ["football"],
  "dateFrom": "today",
  "topLeaguesOnly": true,
  "includeOdds": true,
  "oddsCountry": "GB",
  "maxItems": 200
}
02Live scores of several sports, every few minutes, with alerts on goals

InputJSON

{
  "sports": ["football", "hockey", "basketball"],
  "statuses": ["live"],
  "competitions": ["England: Premier League", "USA: NHL", "USA: NBA"],
  "onlyNewOrChanged": true,
  "monitoringKey": "live-big-leagues",
  "telegramBotToken": "123456789:AA...",
  "telegramChatId": "123456789",
  "maxItems": 0
}
03A whole season for a betting model: results with xG, lineups and odds

InputJSON

{
  "startUrls": [{ "url": "https://www.flashscore.com/football/england/premier-league-2025-2026/results/" }],
  "includeSummary": true,
  "includeStatistics": true,
  "includeLineups": true,
  "includeOdds": true,
  "oddsMarkets": ["HOME_DRAW_AWAY", "OVER_UNDER", "BOTH_TEAMS_TO_SCORE"],
  "maxItems": 0
}
04ATP and WTA matches of the week with rankings, H2H and statistics

InputJSON

{
  "sports": ["tennis"],
  "dateFrom": "-7",
  "dateTo": "today",
  "tennisTours": ["atp", "wta"],
  "tennisDraw": "singles",
  "statuses": ["finished"],
  "includeStatistics": true,
  "includeH2H": true,
  "maxItems": 500
}
05Ten seasons of a league with tables and top scorers

InputJSON

{
  "startUrls": [{ "url": "https://www.flashscore.com/football/germany/bundesliga/results/" }],
  "pastSeasons": 9,
  "includeStandings": true,
  "standingsViews": ["overall", "home", "away", "overUnder"],
  "includeTopScorers": true,
  "maxItems": 0
}
06A team's matches by name, with player statistics

InputJSON

{
  "searchTeams": ["Arsenal (football)", "Real Madrid (football)"],
  "statuses": ["finished"],
  "includePlayerStats": true,
  "maxItemsPerSource": 20,
  "maxItems": 0
}
07A team's history, a table and a ranking

InputJSON

{
  "startUrls": [
    { "url": "https://www.flashscore.com/team/arsenal/hA1Zm19f/" },
    { "url": "https://www.flashscore.com/football/spain/laliga/standings/" },
    { "url": "https://www.flashscore.com/tennis/rankings/atp/" }
  ],
  "maxItemsPerSource": 100,
  "maxItems": 0
}
08Odds movements before kick-off

InputJSON

{
  "sports": ["football"],
  "dateFrom": "today",
  "dateTo": "tomorrow",
  "statuses": ["scheduled"],
  "topLeaguesOnly": true,
  "includeOdds": true,
  "onlyNewOrChanged": true,
  "monitorOdds": true,
  "minOddsChangePercent": 5,
  "monitoringKey": "odds-moves",
  "maxItems": 0
}

Output

Output example

Dataset itemJSON

{
  "id": "Eyc1EfPH",
  "rowType": "match",
  "source": "flashscore",
  "url": "https://www.flashscore.com/match/football/arsenal-hA1Zm19f/hull-city-S66R0t75/?mid=Eyc1EfPH",
  "sport": "football",
  "country": "England",
  "competition": "Premier League",
  "competitionId": "dYlOSQOD",
  "seasonId": "SY30SsKF",
  "competitionUrl": "https://www.flashscore.com/football/england/premier-league/",
  "round": "Round 10",
  "startTime": "2026-11-07T15:00:00Z",
  "startTimeLocal": "2026-11-07T15:00:00+00:00",
  "matchDate": "2026-11-07",
  "status": "finished",
  "statusText": "Finished",
  "homeTeam": "Arsenal",
  "awayTeam": "Hull",
  "homeTeamId": "hA1Zm19f",
  "awayTeamId": "S66R0t75",
  "homeScore": 1,
  "awayScore": 0,
  "homePeriodScores": [0, 1],
  "awayPeriodScores": [0, 0],
  "periodScoresText": "0-0, 1-0",
  "winner": "home",
  "resultType": "normal",
  "detailsIncluded": true,
  "incidents": [{ "period": "2nd Half", "minute": "72'", "side": "home", "type": "goal", "player": "Odegaard M.", "playerId": "ID32TGhp", "score": "1-0" }],
  "referee": "Hallam F.",
  "venue": "Emirates Stadium",
  "attendance": 60285,
  "homeXg": 1.26,
  "awayXg": 0.36,
  "homePossession": 67,
  "awayPossession": 33,
  "homeShotsOnTarget": 10,
  "awayShotsOnTarget": 2,
  "homeFormation": "4-2-3-1",
  "awayFormation": "5-3-2",
  "homeForm": "WWLWD",
  "awayForm": "DDLDL",
  "oddsIncluded": true,
  "oddsCountry": "GB",
  "oddsMarket": "HOME_DRAW_AWAY",
  "oddsHome": 1.138,
  "oddsDraw": 8.0,
  "oddsAway": 18.211,
  "probabilityHome": 83.0,
  "probabilityDraw": 11.8,
  "probabilityAway": 5.2,
  "oddsMarginPercent": 5.86,
  "oddsBookmakers": 20,
  "scrapedAt": "2026-11-18T10:00:00Z"
}

API

For AI agents and API users

Call the actor with the Apify API or MCP server and a small JSON input (see the use cases); every row has rowType, stable id and url, ISO dates and numbers as numbers. Use startUrls for anything you can open on Flashscore, matchIds for known matches, statuses: ["live"] for live scores, and onlyNewOrChanged for repeated calls. The dataset also has the views "Odds lines" and "Incidents" with one row per bookmaker line or incident.

curl -X POST "https://api.apify.com/v2/acts/tsutseisoftware~flashscore-scraper/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"sports": ["football"], "statuses": ["live"], "maxItems": 50}'
from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("tsutseisoftware/flashscore-scraper").call(run_input={
    "sports": ["tennis"], "dateFrom": "today", "tennisTours": ["atp", "wta"], "includeOdds": True})
for match in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(match["homeTeam"], match["scoreText"], match["awayTeam"], match["oddsHome"], match["oddsAway"])

FAQ

Questions about the Flashscore Scraper

Is it legal to scrape Flashscore?

The actor reads only data Flashscore shows to every visitor without logging in: match results, fixtures, statistics and odds, which are facts about public sports events. It saves no personal data beyond the names of players, coaches and referees as they appear in public match reports. You are responsible for how you use the data, including the terms of Flashscore and the laws of your country. This actor is not affiliated with Flashscore or Livesport.

How is it different from other Flashscore scrapers?

It covers 29 sports in one run, reads days, competitions of any season, teams, players, tables, tennis rankings and single matches, adds xG, lineups, missing players, H2H, point by point and the odds of every bookmaker with fair probabilities, and monitors goals, results and odds moves with alerts, for less than most single-sport scrapers.

Do I need a proxy?

No. The default works without a proxy.

How fresh are live scores?

As fresh as on Flashscore when the run reads them. For live scores schedule the actor every 1 to 5 minutes in monitoring mode, so each run returns and charges only the matches whose score or status changed.

Can I get historical data?

Yes, through competition URLs: open a past season on Flashscore (Archive), copy the URL of its results and paste it. Team and player URLs give their match history.

Which bookmakers are included?

The bookmakers Flashscore shows for the chosen odds country (for GB e.g. bet365, William Hill, Betfair, Paddy Power, Ladbrokes, Coral, Betfred, Betway, BetVictor, Sky Bet and others, 20 for a Premier League match); each line has the bookmaker's name.

This actor is also known as a Flashscore API, Flashscore live score scraper, Flashscore odds scraper, Livesport scraper (Czech: "výsledky Livesport", "živé výsledky") and Soccer24 or Tennis24 scraper.

Changelog

What changed in the Flashscore Scraper

  • 2026-11-19 · Fixed: Tennis point by point now tells break points, set points and match points apart (all were marked as break points before), with flags on every point (isBreakPoint, isSetPoint, isMatchPoint) and their counts per game.
  • 2026-11-18 · Improved: Fractional odds equal the decimal odds (31/10, 7/5, 6/4 as bookmakers write it); Past seasons and Seasons work with table URLs too; raw data stays with Output fields; a table view a competition does not have and matches without player statistics are no longer reported as read errors.
  • 2026-11-18 · Fixed: Search teams or players looks in every sport (the default sport no longer turns "Lakers" into a football club); add the sport in brackets to narrow it, like "Lakers (basketball)".
  • 2026-11-18 · Fixed: Top scorers of tournaments and split leagues count the whole tournament or season (Euro play-offs, the championship group), group tables have the group name, and the tables of the later stages are added.
  • 2026-11-18 · Fixed: In monitoring, Max results also limits table, top scorer and ranking rows; Max matches per URL or day no longer leaves out the table and the top scorers of a competition URL (they have the same limit of their own), and Max matches per competition counts each season apart.

Support

Missing a field or a filter?

We read every message and usually answer the same day. Small changes to an actor are free; a custom scraper gets a fixed quote.