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

Usage

Input	Description	Default
sport	Sport to fetch (see list below)	football
dateOffset	Day offset: 0 = today, 1 = tomorrow, -1 = yesterday	0
maxItems	Maximum records to return (0 = no limit)	10

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"
}

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.
• Rate limits: This actor makes one API request per sport. It is lightweight and does not require proxies.