Flashscore Scraper

Flashscore Scraper extracts fixtures, live scores and final results from flashscore.com for 25 sports (football, basketball, ice hockey, tennis, baseball, American football, cricket, esports and more), with the score of every half, quarter, period or set and, if you want, the bookmaker odds of each match. One request returns a whole day of a sport, so a few hundred matches arrive in seconds, without a browser or a login.

Need tennis in depth? Our Tennis Scraper is the specialised sibling this Actor is built on: it adds ATP / WTA rankings and head-to-head history.

What you get

For every match:

• Sport and competition: sport, country or region, Flashscore category, league / stage name, competition URL and ids.
• Teams or players: names, Flashscore ids, team or player page, logo or photo, and the country of each player in individual sports.
• Time and status: start time (ISO 8601, UTC, plus Unix seconds), date in your timezone, status (scheduled, live, finished, postponed, cancelled, interrupted) and the exact stage (1st half, Half time, 3rd quarter, After penalties, Walkover...).
• Score: current or final score, score after regular time, after extra time / overtime, penalty or shoot-out score, winner (home, away, draw).
• Score by period: an array with every half, quarter, period, set or inning, overtime last; tie-break points in tennis, wickets and overs in cricket, goals and behinds in Aussie rules.
• Extras when the sport has them: red cards (football), hits and errors (baseball), result sentence (cricket), method and round (boxing), Flashscore notes such as "First leg result: 4-0."
• Odds add-on (includeOdds): number of bookmakers, average and best price for home / draw / away on the sport's main market, plus one row per bookmaker, market and selection with current and opening price.

Supported sports: football, basketball, ice hockey, tennis, American football, baseball, handball, volleyball, cricket, esports, rugby union, rugby league, Aussie rules, futsal, floorball, bandy, darts, snooker, boxing, MMA, table tennis, badminton, water polo, field hockey and netball. Racing, golf, cycling and winter sports are not included.

Use cases

• Results databases and dashboards: pull yesterday's results every morning for the leagues you follow.
• Fixture calendars: list the next 7 days of matches for a club, a league or a whole sport.
• Live score widgets: schedule short runs during match days and read status, stage and score.
• Betting and trading models: collect opening vs. current prices from up to 20 UK bookmakers (or US, German, French, Australian books) next to the final score.
• Content and newsletters: generate match previews and recaps from structured data.
• AI agents: give an LLM a clean JSON list of today's matches instead of a web page.

How to use

1. Pick one or more sports and the days you need (today, yesterday, tomorrow, a date such as 2026-10-24, or an offset such as -3). Flashscore keeps 7 days back and 7 days ahead.
2. Optionally narrow by status, countries, leagues or teams (case-insensitive text).
3. Turn on includeOdds if you want bookmaker prices and choose the region.
4. Set maxItems (and maxPerSportDay when you mix sports) and run.

Example input: results of the big European football leagues and the NBA from yesterday, New York time, with UK odds.

{
    "sports": ["football", "basketball"],
    "days": ["yesterday"],
    "statuses": ["finished"],
    "leagues": ["Premier League", "LaLiga", "Serie A", "Bundesliga", "NBA"],
    "timezoneOffset": -5,
    "includeOdds": true,
    "oddsRegion": "gb",
    "oddsMarkets": ["1x2", "home-away", "over-under"],
    "maxItems": 200
}

Output example

A real record (NHL, decided in a shoot-out):

{
    "sport": "hockey",
    "sportName": "Ice hockey",
    "id": "M5bGJxSs",
    "url": "https://www.flashscore.com/match/M5bGJxSs/",
    "date": "2026-10-21",
    "startTime": "2026-10-21T01:40:00.000Z",
    "endTime": "2026-10-21T04:34:33.000Z",
    "status": "finished",
    "statusDetail": "After penalties",
    "country": "USA",
    "league": "NHL",
    "tournamentUrl": "https://www.flashscore.com/hockey/usa/nhl/",
    "homeTeam": "Seattle Kraken",
    "homeTeamUrl": "https://www.flashscore.com/team/seattle-kraken/MibYQ5nU/",
    "awayTeam": "Detroit Red Wings",
    "homeScore": 4,
    "awayScore": 3,
    "homeScoreFullTime": 3,
    "awayScoreFullTime": 3,
    "homeScorePenalties": 2,
    "awayScorePenalties": 1,
    "periods": [
        { "period": 1, "home": 1, "away": 0 },
        { "period": 2, "home": 2, "away": 0 },
        { "period": 3, "home": 0, "away": 3 },
        { "period": 4, "home": 0, "away": 0 }
    ],
    "scoreByPeriod": "1-0, 2-0, 0-3, 0-0",
    "winner": "home",
    "winnerName": "Seattle Kraken"
}

With includeOdds a match also carries (real values for a Champions League fixture, UK region):

{
    "oddsRegion": "gb",
    "oddsMainMarket": "1x2 (full-time)",
    "oddsBookmakers": 20,
    "oddsHomeAvg": 2.36,
    "oddsDrawAvg": 3.74,
    "oddsAwayAvg": 2.72,
    "oddsHomeBest": 2.45,
    "oddsDrawBest": 3.8,
    "oddsAwayBest": 3,
    "odds": [
        { "bookmaker": "BetVictor", "market": "1x2", "period": "full-time", "selection": "home", "line": null, "odds": 2.38, "openingOdds": 2.25, "active": true }
    ]
}

Prices are decimal odds. Home / away sports (basketball, tennis, baseball...) use the moneyline, including overtime when bookmakers price it that way, and have no draw.

Pricing

Pay per event:

Event	When
Match saved (match-result)	each match saved
Odds add-on (match-odds)	only for matches that have odds

See the Pricing tab for current prices; paid Apify plans get lower rates. Platform usage is minimal because one request covers a whole day of a sport. Your max-charge limit is respected: the run stops (or skips odds) before going over it.

How it compares

Most Flashscore Actors in the Store cover a single sport, often tennis. This one covers 25 sports in one schema, adds period scores and an optional multi-bookmaker odds comparison. For ATP / WTA rankings and head-to-head use the Tennis Scraper. It does not extract lineups, match statistics, incidents or past seasons.

Integrations

Use the dataset through the Apify API (JSON, CSV, Excel), schedule runs in Apify, or connect it to n8n, Make, Zapier, Google Sheets and webhooks. AI agents can call it through the Apify MCP server and read the clean match records directly.

FAQ

Is it legal? The Actor reads public match information that Flashscore shows to every visitor, at a polite pace. Names of athletes are part of public sports results; no private data is collected. Check Flashscore's terms before republishing the data commercially.

Do I need a proxy? Usually not. The Actor connects directly and, only if Flashscore blocks, moves by itself to Apify datacenter and then residential proxies.

How fresh are live scores? Each run is a snapshot of Flashscore at that moment. Schedule frequent short runs (a few seconds each) for live tracking.

How far back can I go? 7 days back and 7 days ahead, as on the site. Older seasons are not available here.

Which bookmakers? It depends on oddsRegion, as on the site: about 20 in the United Kingdom, 5 to 8 in the USA (New Jersey), Germany and France, 2 in Australia. Some smaller leagues have no odds; those matches are not charged for the add-on.

Changelog

• 0.1 (2026-10-21): first release: 25 sports, 7 days back / 7 ahead, period scores, filters, odds add-on in 5 regions.

En español

Flashscore Scraper extrae de flashscore.com el calendario, los resultados en vivo y los resultados finales de 25 deportes (fútbol, básquetbol, hockey sobre hielo, tenis, béisbol, fútbol americano, críquet, esports y más), con el marcador de cada tiempo, cuarto, período o set y, si lo pides, las cuotas de las casas de apuestas de cada partido. Elige deportes y días (de 7 días atrás a 7 adelante), filtra por estado, país, liga o equipo y descarga JSON, CSV o Excel. Consulta la pestaña Pricing para ver los precios actuales; los planes de pago de Apify tienen tarifas más bajas. Para tenis en profundidad (rankings ATP / WTA y head-to-head) usa el Tennis Scraper.