Football (Soccer) Match Scraper — Scores & Fixtures (+ Match Intel)

Daily football scores and fixtures from Flashscore, structured for automation and AI agents.

Match Intel — the full picture per match (flag enrich: true). Turn any match into a complete report: event timeline (goals, own goals, cards, substitutions — with minute and score at the moment), 30+ live match statistics (xG, possession, shots, corners, passes, duels…), lineups with per-player statistics, recent form & head-to-head, competition standings when available, venue/city/capacity/referee/TV — and optional bookmaker odds comparison per market (1X2, Over/Under, Asian Handicap, Double Chance…) for scheduled & live matches. All merged into one clean JSON row per match.

One run returns every match of a day (default: today) across 200+ competitions — Premier League, Ligue 1, Bundesliga, Serie A, LaLiga, Champions League, MLS, Brasileirão, J.League and more — as clean JSON rows. Browse ±3 days, filter by league or status.

What you get per match

Field	Example
match_id	lAhFP7mo
home / away	Everton / Manchester Utd
home_team_id / away_team_id	KluSTr9s / ppjDR086 (stable ids — join records across days)
status	SCHEDULED · LIVE · FINISHED · POSTPONED · ABANDONED …
minute (live)	23 · 45+2 · HT · ET
kickoff (scheduled)	13:00
home_score / away_score	1 / 0 (once started)
status_detail	AET · PEN · AWD when decisive
country / league / league_slug	england / Premier League / premier-league
match_url	direct Flashscore link

Example input

{
  "date": "2026-09-06",
  "matchStatuses": ["finished", "live"],
  "leagues": ["premier league", "champions", "france"],
  "maxMatches": 1000
}

Example record

{
  "match_id": "lAhFP7mo",
  "match_url": "https://www.flashscore.com/match/football/everton-KluSTr9s/manchester-united-ppjDR086/?mid=lAhFP7mo",
  "match_date": "2026-09-06",
  "home": "Velez Sarsfield",
  "away": "Estudiantes L.P.",
  "home_slug": "velez-sarsfield",
  "home_team_id": "UsCR8gFd",
  "away_slug": "estudiantes-l-p",
  "away_team_id": "p2SkCHXs",
  "status": "FINISHED",
  "status_detail": null,
  "minute": null,
  "kickoff": null,
  "home_score": 1,
  "away_score": 0,
  "country": "argentina",
  "league": "Liga Profesional - Clausura",
  "league_slug": "liga-profesional"
}

Use cases

• Fixtures & results monitoring for any league set
• Football schedule feeds for apps, newsletters, bots
• Score aggregation into analytics / betting research pipelines
• Ground-truth data for AI agents (real-time, no hallucination)

Inputs

• Anchor date + dayOffsets — browse any day within ±3 of it (empty = today)
• Match statuses — finished / live / scheduled / postponed / abandoned / cancelled / interrupted / awarded
• Leagues — free-text filter on league name or country ("premier", "champions", "brazil")
• Max matches — output cap (the full day is always parsed)

Pricing & notes

• Pay-per-event, billed per returned match: one run lists every match of a day as one dataset row per match — a 500-match day ≈ 500 match-listed events ≈ $0.50. No subscription, no per-run fee.
• Live matches report the current minute and score at scrape time.
• Status normalization covers Finished (pen), After ET, After Pen., Abandoned, Postponed, Cancelled…
• Enrichment tier (optional): set enrich: true to merge per match a full context report — timeline of events (goals/own goals/cards/subs with minute and score at the moment), complete match statistics (xG, possession, shots, corners, passes…), recent form + head-to-head, competition standings when available, venue/city/capacity/referee/TV. Odds comparison (opt-in via odds: true): per-market bookmaker odds for scheduled/live matches — default markets 1X2, Over/Under and Asian Handicap (the decision markets for live betting); more markets (Double Chance, BTTS, Correct Score…) selectable via oddsMarkets. Bookmaker ids, handicap lines and odds movement included — best-effort: availability varies by market and region. Billed as match-intel ($0.007/match) per enriched match.
• List tier = scores & fixtures only.

Call it from an AI agent (MCP)

Use the MCP server: mcp.apify.com?tools=<username>/football-soccer-scores

Ask: "What are today's Premier League results?" — the agent runs the actor and reads the dataset.

Legal

This actor scrapes publicly available data. Use it in compliance with the target website's terms and your local regulations.