Flashscore Scraper avatar

Flashscore Scraper

Pricing

from $0.70 / 1,000 match records

Go to Apify Store
Flashscore Scraper

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

Khadin Akbar

Maintained by Community

Actor stats

1

Bookmarked

16

Total users

3

Monthly active users

7 days ago

Last modified

Features

Limited permissions

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 wantYou setYou get
Today's football, tennis, hockey...sport or sports, dayOffsetsOne row per match: teams, score, status, kick-off, league, country, IDs, winner
Only certain matchescountries, leagueContains, teamContains, statuses, onlyLiveJust the matches that fit
Everything about one matchmatchUrlsStatistics, incidents with scorer and assist, head-to-head
Rows plus detail togetherenrichListWithDetailsDetail 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: false and 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 PARTIAL instead of timing out, with everything collected so far saved.
  • Predictable cost. maxResults caps 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.

EventWhen it is chargedPrice (Free plan)
Actor startOnce per run$0.00005 per GB of memory (default 512 MB)
Match recordPer list row saved$0.001
Match detailPer 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

FieldTypePurpose
sportstringOne sport for list mode. Default football.
sportsarraySeveral sports in one run, such as ["football","tennis"]. Overrides sport.
dayOffsetsarrayDays relative to today, -7 to 7. 0 = today, -1 = yesterday.
datestringOne exact day, YYYY-MM-DD, within 7 days of today.
matchUrlsarrayMatch URLs or 8-character match IDs for detail mode.
detailSectionsarraysummary, stats, incidents, h2h (and lineups when available).
enrichListWithDetailsbooleanAdd detail to every list row.
countriesarrayKeep only these countries or regions.
leagueContainsstringKeep leagues or tournaments whose name contains this text.
teamContainsstringKeep matches where a team or player name contains this text.
statusesarrayKeep only these match states.
onlyLivebooleanKeep only matches being played now.
maxResultsintegerCap on billable rows or details.
languagestringLabel language such as en, es, de.
sportIdintegerAdvanced: numeric ID for a sport outside the list.
proxyConfigurationobjectProxy 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:

  • OUTPUT has outcome (COMPLETE, PARTIAL, VALID_EMPTY, INVALID_INPUT, UPSTREAM_FAILED), a plain message, counts, and an agentSummary for AI agents.
  • RUN_SUMMARY has 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 PARTIAL with 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: false at no match-detail charge.
  • Language changes labels only, not which matches appear.

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.