FotMob Match Details Scraper

Turn any FotMob match into clean, structured JSON or CSV: final score, both teams' formations and lineups, per-player statistics and ratings, a goal / card / substitution timeline, head-to-head team-stat comparison (possession, shots, xG, passing, duels…), plus venue, referee, attendance, and player of the match — one normalized record per match.

Give it one or more match ids (or match URLs), toggle which sections you need, and download results from the Dataset tab.

Features

• Score, status, league, venue, referee, attendance, player of the match
• Optional lineups (formation, starters, subs, coach)
• Optional events timeline (goals, cards, substitutions)
• Optional team-stat comparison (possession, shots, xG, …)
• Optional per-player stats and ratings (flat, analysis-ready)
• Optional head-to-head history between the two teams
• Optional full raw payload under rawData
• Accepts numeric ids or FotMob match URLs
• Failed lookups are reported in Key-value store SUMMARY and not written to the dataset

Input

Field	Type	Default	Description
matchIds	array	["4506324"]	FotMob match ids or match URLs
includePlayerStats	boolean	true	Per-player stats and ratings
includeEvents	boolean	true	Goal / card / substitution timeline
includeLineups	boolean	true	Formations, starters, subs, coach
includeTeamStats	boolean	true	Team-stat comparison
includeH2H	boolean	false	Previous meetings
includeRawData	boolean	false	Full raw payload under rawData
maxConcurrency	integer	5	Parallel requests (1–20)
requestDelaySecs	integer	1	Delay before each request (0–10)
maxItems	integer	0	Cap successful records (0 = no limit)
proxyConfiguration	object	—	Optional Apify proxy

Input example

{
  "matchIds": ["4506324"],
  "includePlayerStats": true,
  "includeEvents": true,
  "includeLineups": true,
  "includeTeamStats": true,
  "includeH2H": false,
  "maxConcurrency": 5,
  "requestDelaySecs": 1
}

Output

One Dataset item per successful match:

Field	Description
matchId	FotMob numeric match id
matchName / matchUrl	Label and absolute match URL
leagueId / leagueName / round / countryCode	Competition context
matchTimeUtc	Kickoff (ISO 8601 UTC)
started / finished	Match status flags
homeTeam / awayTeam	{ id, name, score }
venue / referee / attendance	Match info box
playerOfTheMatch	{ playerId, name, teamName } when awarded
teamStats	Optional head-to-head stats
events	Optional timeline
lineups	Optional { home, away } formations
playerStats	Optional flat per-player stats
h2h	Optional previous meetings
source / scrapedAt	Provenance

Example (trimmed)

{
  "matchId": 4506324,
  "matchName": "Aston Villa-vs-Manchester United_Sun, Oct 6, 2024, 13:00 UTC",
  "matchUrl": "https://www.fotmob.com/match/4506324",
  "leagueId": 47,
  "leagueName": "Premier League",
  "round": "7",
  "countryCode": "ENG",
  "matchTimeUtc": "2024-10-06T13:00:00.000Z",
  "started": true,
  "finished": true,
  "homeTeam": { "id": 10252, "name": "Aston Villa", "score": 0 },
  "awayTeam": { "id": 10260, "name": "Manchester United", "score": 0 },
  "venue": "Villa Park",
  "referee": "Robert Jones",
  "attendance": 42682,
  "playerOfTheMatch": {
    "playerId": 268375,
    "name": "Emiliano Martínez",
    "teamName": "Aston Villa"
  },
  "source": "fotmob-match-details-scraper",
  "scrapedAt": "2026-10-26T12:00:00.000Z"
}

Notes

• Per-player stats are only available for matches that have started.
• Keep concurrency moderate and use a small request delay for large batches.
• Residential proxies are recommended for production / high-volume runs.
• This project is not affiliated with FotMob. Use responsibly and comply with applicable terms and law.