FlashScore Live Scores Scraper

Scrape live and scheduled match scores from FlashScore (flashscore.com). Supports football, basketball, tennis, hockey, baseball, and 10+ other sports. Returns match ID, teams, scores, status, league, country, and start time.

What It Does

This actor fetches match data directly from FlashScore's internal data API (global.flashscore.ninja). No browser is required — it makes lightweight API calls and parses the pipe-delimited response format.

For each match it returns:

• Match ID and URL on flashscore.com
• Home and away team names and IDs
• Current or final score
• Match status (Not Started, In Progress, Finished, Postponed, etc.)
• Tournament/league name, country, and URL
• Start time (Unix timestamp and ISO 8601)
• Sport name
• Optional: statistics (period, group and statistic, each with home and away values) and lineups (per side: formation, starting players, substitutes, coach)

Usage

Input	Description	Default
sport	Sport to fetch (see list below)	football
dateOffset	Day offset: 0 = today, 1 = tomorrow, -1 = yesterday	0
date	A specific day as YYYY-MM-DD (UTC), within 7 days of today. Overrides dateOffset	none
maxItems	Maximum records to return (0 = no limit)	10
liveOnly	Only return matches that are in play right now	false
includeStats	Add per-match statistics (possession, shots, aces, and more, depending on the sport)	false
includeLineups	Add starting lineups, substitutes, formations and coaches	false

Inputs the actor does not recognise are ignored, and the run names them in its log and status message.

Supported Sports

football, basketball, tennis, hockey, baseball, handball, volleyball, rugby, cricket, mma, motorsport, cycling, all

Use all to fetch matches across every supported sport.

Example Output

{
  "match_id": "xkRJ3q4B",
  "sport": "football",
  "country": "England",
  "tournament_name": "Premier League",
  "tournament_id": "cMpZSXr7",
  "tournament_url": "https://www.flashscore.com/football/england/premier-league/",
  "home_team": "Arsenal",
  "away_team": "Chelsea",
  "home_team_id": "G8RJjV2e",
  "away_team_id": "fFbPHtIT",
  "home_score": 2,
  "away_score": 1,
  "status": "Finished",
  "start_timestamp": 1748700000,
  "start_time_iso": "2025-05-31T14:00:00.000Z",
  "match_url": "https://www.flashscore.com/match/football/xkRJ3q4B/",
  "scraped_at": "2025-05-31T16:45:23.412Z"
}

Pricing

Pay per result. A standard match record costs $0.001 (before any plan discount). Match records that come back with the statistics or lineups you asked for are billed as premium records, at the premium rate shown in this actor's pricing panel once it takes effect; until then they are billed at the standard rate. A row is billed as premium only when it actually carries that data. Rows where FlashScore published nothing, and every row from a run with both options off, are billed at the standard rate.

Notes

• Data freshness: The API reflects live scores in near-real-time. Run the actor repeatedly to poll for updates.
• Date range: dateOffset supports -7 to 7. Past dates may have fewer sports available.
• Empty results: Some sports return no data outside their active season or for certain date offsets. The actor handles this gracefully and returns zero records.
• Live matches: liveOnly returns zero records when nothing is in play for that sport and day. That is a correct empty answer.
• Statistics and lineups: coverage depends on the match and sport. Finished football, basketball, hockey and baseball matches usually carry them, tennis carries statistics only, and matches that have not started carry neither. Where FlashScore publishes nothing, the field is null. Turning either on makes a run a little slower.