Flashscore Scraper
Pricing
from $0.70 / 1,000 match records
Flashscore Scraper
Scrape Flashscore live scores, results, fixtures, match stats, goal scorers and head-to-head across football, tennis, basketball and 20+ sports. HTTP-only, MCP-ready.
Pricing
from $0.70 / 1,000 match records
Rating
5.0
(1)
Developer
Khadin Akbar
Maintained by CommunityActor stats
1
Bookmarked
16
Total users
3
Monthly active users
7 days ago
Last modified
Categories
Features
Share
What is Flashscore Scraper?
Flashscore Scraper turns Flashscore into clean JSON: live scores, results and fixtures for football, tennis, basketball, hockey and 20+ other sports, plus full match detail (statistics, goal scorers and assists, cards, substitutions, head-to-head). It uses Flashscore's public match feed over plain HTTP, so there is no browser to wait for. Runs are fast, cheap and easy to call from code, spreadsheets or AI agents (MCP-ready).
What you get
| You want | You set | You get |
|---|---|---|
| Today's football, tennis, hockey... | sport or sports, dayOffsets | One row per match: teams, score, status, kick-off, league, country, IDs, winner |
| Only certain matches | countries, leagueContains, teamContains, statuses, onlyLive | Just the matches that fit |
| Everything about one match | matchUrls | Statistics, incidents with scorer and assist, head-to-head |
| Rows plus detail together | enrichListWithDetails | Detail nested under each row |
Data fields (list rows): matchId, matchUrl, sport, country, league, tournamentId, homeTeam, awayTeam, team IDs and page links, homeScore, awayScore, status, winner, startTime, lastUpdated, periodScores. Tennis and other set sports also return sets, player nationality, surface and indoor.
Data fields (match detail): statistics by period (including expected goals where Flashscore shows it), incidents (type, minute, player, assisting player, score after each goal), head-to-head meetings, detailAvailable. Lineups are returned only when Flashscore supplies them; in our tests it did not for the matches checked, so do not rely on lineups.
Why use it
- Correct goal data. Scorer and assist are returned as separate fields (this release fixes an older mix-up).
- You only pay for detail that exists. A match that has no statistics, incidents or head-to-head yet (for example, not played) comes back with
detailAvailable: falseand is not charged as match detail. - Fast. Several matches are fetched in parallel and results are saved in batches. 1,000 rows finish in about a minute.
- Safe to leave running. The Actor stops cleanly before the run time limit and reports
PARTIALinstead of timing out, with everything collected so far saved. - Predictable cost.
maxResultscaps what you can be charged, and charges follow what is actually saved.
Pricing
Pay per event. Platform usage (compute) is included for you in the price you see below; there is no separate compute bill.
| Event | When it is charged | Price (Free plan) |
|---|---|---|
| Actor start | Once per run | $0.00005 per GB of memory (default 512 MB) |
| Match record | Per list row saved | $0.001 |
| Match detail | Per match that returns detail data | $0.004 |
Paid Apify plans get volume discounts on both events (Bronze, Silver and Gold tiers; Platinum and Diamond use the Gold price). See the live Pricing tab for exact current rates.
Examples (Free plan): 100 football matches for today cost about $0.10. Ten matches with full detail cost about $0.04. A thousand rows cost about $1.00. If you turn on enrichListWithDetails, each row that has detail adds one match-detail charge; rows with no detail yet add nothing extra.
Input
| Field | Type | Purpose |
|---|---|---|
sport | string | One sport for list mode. Default football. |
sports | array | Several sports in one run, such as ["football","tennis"]. Overrides sport. |
dayOffsets | array | Days relative to today, -7 to 7. 0 = today, -1 = yesterday. |
date | string | One exact day, YYYY-MM-DD, within 7 days of today. |
matchUrls | array | Match URLs or 8-character match IDs for detail mode. |
detailSections | array | summary, stats, incidents, h2h (and lineups when available). |
enrichListWithDetails | boolean | Add detail to every list row. |
countries | array | Keep only these countries or regions. |
leagueContains | string | Keep leagues or tournaments whose name contains this text. |
teamContains | string | Keep matches where a team or player name contains this text. |
statuses | array | Keep only these match states. |
onlyLive | boolean | Keep only matches being played now. |
maxResults | integer | Cap on billable rows or details. |
language | string | Label language such as en, es, de. |
sportId | integer | Advanced: numeric ID for a sport outside the list. |
proxyConfiguration | object | Proxy settings. Apify Proxy by default. |
Example: today's live and finished Premier League matches
{"sport": "football","dayOffsets": [0],"leagueContains": "Premier League","countries": ["England"],"maxResults": 50}
Example: full detail for one match
{"matchUrls": ["https://www.flashscore.com/match/football/2L651Hgn/"],"detailSections": ["summary", "stats", "incidents", "h2h"]}
Example: yesterday's tennis results with set scores
{"sport": "tennis","dayOffsets": [-1],"statuses": ["finished"],"maxResults": 200}
Output
Every dataset row has a recordType: match for a list row, matchDetail for a detail row.
{"recordType": "match","matchId": "2L651Hgn","sport": "football","country": "Argentina","league": "Primera Nacional","homeTeam": "Nueva Chicago","awayTeam": "Atl. Rafaela","homeScore": 0,"awayScore": 0,"status": "finished","winner": "draw","startTime": "2026-06-23T21:30:00.000Z","matchUrl": "https://www.flashscore.com/match/2L651Hgn/"}
An incident row now looks like this (scorer and assist separate):
{"minute": "67'","type": "Goal","player": "Zabiri Y.","relatedPlayer": "Diaz B.","relatedType": "Assistance","scoreAfter": "1-0","team": "home"}
Run outcome
Each run also writes two records to the key-value store:
OUTPUThasoutcome(COMPLETE,PARTIAL,VALID_EMPTY,INVALID_INPUT,UPSTREAM_FAILED), a plain message, counts, and anagentSummaryfor AI agents.RUN_SUMMARYhas the full counters, including exactly how many of each billable event were charged.
If Flashscore blocks every request, the run fails honestly with no data and no match charges.
Use with AI agents (MCP)
Available through Apify MCP as khadinakbar/flashscore-scraper. Example prompt:
Get today's live football matches in Spain, then fetch statistics and goal scorers for the two with the most goals.
Tips for agents: start with a list run (cheap), read agentSummary in OUTPUT, then pass chosen matchUrl values to matchUrls for detail. Set maxResults to keep spend predictable.
Apify API example
import { ApifyClient } from 'apify-client';const client = new ApifyClient({ token: process.env.APIFY_TOKEN });const run = await client.actor('khadinakbar/flashscore-scraper').call({sport: 'football',dayOffsets: [0],onlyLive: true,maxResults: 100,});const { items } = await client.dataset(run.defaultDatasetId).listItems();console.log(items);
What's new in 1.1
- Fixed: scorer and assist were mixed up in incidents.
- Match detail is billed only when the match has data, also when you use list enrichment.
- Filters: countries, league, team, status, live-only. Several sports in one run.
- Richer rows: team IDs and links, winner, tournament, last update, period scores, tennis set scores, surface.
- Faster, with a 512 MB default.
- Stops cleanly before the time limit and reports
PARTIALwith everything collected. - Standings removed: Flashscore's public feed does not carry a league table, so the Actor no longer claims it.
Good to know
- Window: Flashscore's feed covers 7 days back to 7 days ahead.
- Odds are not part of the public feed and are not returned.
- Detail for matches not yet played is usually empty; those rows return
detailAvailable: falseat no match-detail charge. - Language changes labels only, not which matches appear.
Related Actors
- Flashscore Live Matches: focused live-score feed.
- DraftKings Odds + Player Props API: betting odds to pair with scores and results.
FAQ
Can I get live scores and finished results with the same setup?
Yes. Each row has a status. Use onlyLive or statuses to narrow it.
How do I get goal scorers and assists?
Pass the match in matchUrls with incidents in detailSections. Scorer is player, assist is relatedPlayer.
Do I pay for matches with no detail?
No. They come back with detailAvailable: false and no match-detail charge.
Can I get several sports at once?
Yes, use sports, for example ["football","tennis","basketball"].
Is there a league table? Not any more. The public feed has none, so it was removed rather than returning empty data.
Can I use this with an AI agent?
Yes. It is MCP-ready and writes an agentSummary with every run.
Responsible use
Use this Actor for lawful data collection and internal analysis that fit your rights and obligations. Check Flashscore's terms and your local data-protection rules before republishing scraped data.