⚽ Flashscore Scraper (Live Scores, Results, Stats & Lineups)

Get Flashscore's live scores, fixtures and results for 16 sports as clean rows: teams, score, status, league, start time and logos, with optional match details: period scores, referee, venue and attendance, goals, cards and substitutions, statistics with expected goals (xG), and lineups with player ratings. No browser, so a full day of football with details takes seconds. Export to JSON/CSV/Excel, run on a schedule, call via API, or connect to Make, Zapier or n8n.

What a run costs: $0.0005 per match on the Free plan, $0.00048 on Bronze, $0.00046 on Silver and $0.00044 from Gold up. Match details are $0.001 per match more ($0.00095, $0.0009, $0.00085), only when you switch them on. Plus $0.00005 per run start.

🔎 What is the Flashscore Scraper?

It reads the same data feed Flashscore's own pages load: every match of a sport for one day, seven days back to seven days ahead, and per match the detail tabs (summary, statistics, lineups). Sports: football, tennis, basketball, hockey, American football, baseball, handball, floorball, futsal, volleyball, cricket, darts, badminton, water polo, table tennis, esports.

What data does it extract?

• Match: id, url, sport, startTime, status (scheduled, live, finished, postponed, cancelled, walkover, retired, interrupted, abandoned), stage, homeScore, awayScore, winner, note, updatedAt
• League: league.name, league.country, league.category (for tennis: ATP, WTA, Challenger…), league.fullName, league.url
• Teams or players: home and away with id, name, shortName, slug, country (tennis), logo
• Details (optional):
  • details.info: periods[] (halves, quarters, sets), referee, venue, town, attendance, capacity
  • details.incidents[]: goals with the running score, cards, substitutions, penalties: minute, team, players with links, reason, commentary
  • details.statistics[]: per period and group, every statistic with home and away value (xG, possession, shots, passes, corners…)
  • details.lineups: formation, starters, substitutes and coaches per team, player ratings

⬇️ Input

Field	Type	Description
sports	array	Sports to read (default football)
days	array	Day offsets from today, -7 to 7 (default [0])
status	string	all, live, scheduled or finished
leagues	array	Keep leagues whose name or link contains one of these words (premier league, laliga, atp, nba)
includeDetails	boolean	Add match details (default off)
detailParts	array	Which details: info, incidents, statistics, lineups (default all)
maxItems	integer	Stop after this many matches (default 1000)

Example input

{
  "sports": ["football"],
  "days": [-1],
  "leagues": ["england: premier league", "spain: laliga"],
  "status": "finished",
  "includeDetails": true
}

⬆️ Output

One row per match (shortened, a real Premier League match):

{
  "id": "tW4rOkzg",
  "url": "https://www.flashscore.com/match/football/coventry-GOvB22xg/newcastle-utd-p6ahwuwJ/?mid=tW4rOkzg",
  "sport": "football",
  "league": { "name": "Premier League", "country": "England", "fullName": "ENGLAND: Premier League", "url": "https://www.flashscore.com/football/england/premier-league/" },
  "startTime": "2026-10-12T19:00:00Z",
  "status": "finished",
  "home": { "id": "GOvB22xg", "name": "Coventry", "shortName": "COV", "logo": "https://static.flashscore.com/res/image/data/QHmiKlDN-SSMx8z8I.png" },
  "away": { "id": "p6ahwuwJ", "name": "Newcastle", "shortName": "NEW" },
  "homeScore": 4,
  "awayScore": 1,
  "winner": "home",
  "details": {
    "info": {
      "periods": [{ "home": 1, "away": 0 }, { "home": 3, "away": 1 }],
      "referee": "Brooks J.",
      "venue": "Coventry Building Society Arena",
      "attendance": 30811,
      "capacity": 32753
    },
    "incidents": [
      { "period": "2nd Half", "minute": "48'", "team": "home", "type": "Goal", "score": "2-0", "players": [{ "name": "Cherif S.", "url": "https://www.flashscore.com/player/cherif-sidiki/tSVHHLjn/" }] }
    ],
    "statistics": [
      { "period": "Match", "group": "Top stats", "name": "Expected goals (xG)", "home": "1.43", "away": "1.85" },
      { "period": "Match", "group": "Top stats", "name": "Ball possession", "home": "33%", "away": "67%" }
    ],
    "lineups": {
      "home": { "formation": "1-4-2-3-1", "starters": [{ "name": "Cherif S.", "rating": 6.9 }] }
    }
  }
}

💡 Use cases

• 📊 Sports data products: feed live scores and results into an app, a bot or a betting model.
• 🧮 Analytics: xG, possession and shots per match and half for whole leagues.
• 📰 Media: daily fixtures and results lists for your site or newsletter.
• 🎾 Tennis and more: every ATP, WTA, Challenger and ITF match of the day with player nationality.

🤖 For AI agents

{ "sports": ["football"], "days": [0], "status": "live" }

No credentials. includeDetails: true adds statistics, lineups and incidents.

📏 Limits

• Days: seven days back to seven days ahead, as Flashscore's own day list. Older results need the league pages, which are not read.
• Details depend on the league: top leagues have statistics, xG and lineups; small leagues may only have goals and cards, and some none. Empty parts are returned empty.
• Odds are not included in this version.
• Live data is a snapshot of the moment the run reads it. Schedule the Actor for regular updates.

❓ FAQ

How fast is it? About a second per hundred matches without details; with details, six matches at a time.

Which sports? Football, tennis, basketball, hockey, American football, baseball, handball, floorball, futsal, volleyball, cricket, darts, badminton, water polo, table tennis and esports.

Can I get only one league? Yes, put words of its name in leagues, for example england: premier league.

Am I charged for details I did not ask for? No. Details are a separate charge, only with includeDetails.

Is it legal? It reads data Flashscore shows every visitor. Check the terms of Flashscore and of the competitions for your use, especially for commercial redistribution.

🔗 You might also like

• Football Data Competitions Scraper
• TheSportsDB Scraper

Keywords: Flashscore scraper, live scores API, football results API, soccer scores scraper, tennis results scraper, basketball scores, hockey scores, cricket scores, xG data, match statistics scraper, lineups scraper, sports data API, fixtures and results, Flashscore API alternative