FotMob Scraper: Match Details, Stats, Lineups & Players

FotMob Scraper turns FotMob into a clean football data API. Get full match details with scores, team stats, goals and cards, lineups with player ratings, shot-by-shot shotmaps with xG, head-to-head history, league tables and fixtures, team squads and player career histories. Paste match links, pull every fixture on a date, or scrape whole leagues, teams and players, then export to JSON, CSV or Excel, or pull the results straight into your app through the API.

Why This Scraper?

• Seven ways to find data. Matches by id, pasted FotMob links, fixtures on any date, whole leagues, teams, players, or the latest news. No need to build URLs by hand.
• Full match depth, rival-beating. Every match record carries scores, team stats, events, lineups, flat player-stat rows, shotmaps, team form and player of the match - a superset of the best-known match-details scraper on the store.
• League, team, player and news surfaces. League tables with fixtures and seasons, team squads with form, player careers with trophies and recent matches, plus the latest football news articles - surfaces a match-only scraper cannot reach.
• Shot-level xG. The shotmap records every shot's coordinates, shooter, body part, situation and expected goals.
• Built for schedules. Incremental mode returns only new and changed records on recurring runs, and a refused run fails loudly instead of returning an empty dataset.
• Simple per-result pricing. Every record bills the same tiered rate (lower per plan tier) — plus a small surcharge only for news articles whose full text was read.

Use Cases

• Who: sports betting and odds researchers - collect team stats, xG shotmaps, head-to-head records and form to build and backtest models.
• Who: live score apps and dashboards - feed fixtures, scores, events and ratings into your own site, bot or alerting tool.
• Who: fantasy sports and scouting teams - track player ratings, positions, squads and career moves across leagues.
• Who: sports analytics and data science teams - build historical datasets of results, xG-bearing stats and lineups for machine learning.
• Who: media and content teams - generate match previews, reports and league tables automatically.

Data You Get

Sample shape: values are illustrative placeholders, not from a live record.

Field	Example
type	"match" (also "league", "team", "player", "news")
matchId / id	4506324
matchName	"Aston Villa-vs-Manchester United_Sun, Oct 6, 2024, 13:00 UTC"
matchUrl	FotMob link to the match
leagueId / leagueName	47 / "Premier League"
round / roundName	"7" / "7"
countryCode	"ENG"
matchTimeUtc	"2024-10-06T13:00:00.000Z"
started / finished	true / true
homeTeam / awayTeam	{"id": 10252, "name": "Aston Villa", "score": 0}
venue	name, city, country, capacity, surface
referee / attendance	"Referee Name" / 42682
playerOfTheMatch	{"playerId": 268375, "name": "Emiliano Martinez", "teamName": "Aston Villa"}
teamStats[]	{group, title, key, home, away} - possession, xG, shots
events[]	{type, minute, minuteLabel, isHome, playerId, playerName, homeScore, awayScore, card, goalType, assist, playersInvolved}
lineups	{home, away: {teamId, teamName, formation, coach, starters[], subs[]}}
playerStats[]	flat per-player rows with ratings, minutes, goals, saves, xG
shotmap	every shot: coordinates, shooter, shotType, situation, expectedGoals
momentum	minute-by-minute win-probability swing for the match
attackingZones	left/center/right attack split per half for both sides
h2h	past meetings between the two teams (when enabled)
leagueTable / fixtures	league records: full table, all fixtures, seasons
transfers	league records: latest transfer rows
squad	team records: players grouped by role (coach, keepers, defenders, midfielders, attackers)
lastMatch / nextMatch	team records: previous and upcoming fixture
history	team records: trophy list with seasons won
careerHistory / trophies / recentMatches	player records
statSeasons / mainLeague	player records: per-season tournaments and current-season headline stats
marketValues / traits	player records: transfer-value history and stat traits vs peers
bodyText / bodyHtml / lead	news records: full article text (FotMob-native articles)
source / scrapedAt	"fotmob" / run timestamp

League records also carry seasons, stats and overview; team records carry form, fixtures and transfers; player records carry position, team, birth date and detailed information; news records carry title, lead, source, image and publish time (and the full article body when enabled).

How to Use

1. Pick a mode: matches (by id), urls (paste links), fixturesByDate (all matches on a date), league, team, player, or news (latest articles).
2. Fill in the fields for that mode, and switch on the match details you need.
3. Set Max items to control run size and cost, then click Start.
4. Download the dataset as JSON, CSV or Excel, or read it through the API.

Latest football news (the default — at least 20 results out of the box):

{
 "mode": "news",
 "newsPages": 2,
 "maxItems": 20
}

One match by id:

{
 "mode": "matches",
 "matchIds": ["4506324"],
 "maxItems": 1
}

Every Premier League fixture on a date:

{
 "mode": "fixturesByDate",
 "date": "2026-08-29",
 "daysAhead": 0,
  "leagueIds": ["47"],
  "maxItems": 20
}

Paste links (match, team, player, league):

{
 "mode": "urls",
 "urls": [
  "https://www.fotmob.com/match/4506324",
  "https://www.fotmob.com/teams/10252/overview/aston-villa",
  "https://www.fotmob.com/players/268375/emiliano-martinez",
  "https://www.fotmob.com/leagues/47/overview/premier-league"
 ]
}

Run it from your code

Python:

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("abotapi/fotmob-scraper").call(run_input={"mode": "matches", "matchIds": ["4506324"]})
for match in client.dataset(run["defaultDatasetId"]).iterate_items():
 print(match["matchName"], match["homeTeam"], match["awayTeam"])

JavaScript:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('abotapi/fotmob-scraper').call({ mode: 'matches', matchIds: ['4506324'] });
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Or connect it to Make, Zapier, n8n, Google Sheets or webhooks from the Integrations tab.

Resume and recurring updates

• Resume (resumeFromRunId) continues one interrupted run: paste its run or dataset ID and the actor skips everything already collected there, so you don't pay twice.
• Incremental mode (incrementalMode) is for scheduled runs over the same scope. Each record is classified NEW, UPDATED (with changedFields), UNCHANGED (suppressed and not billed unless emitUnchanged is on), REAPPEARED or EXPIRED (only after a run that scanned the whole scope, and only with emitExpired). stateKey names or shares the stored state. With incremental mode off, output is exactly as before.

Send results into your apps (MCP connectors)

Optionally pipe the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. This is an extra delivery step after the scrape: the Apify dataset is never changed.

What gets written to the connector: a condensed, human-readable summary of each record, not the full JSON. Each item becomes one entry with a title and its key fields flattened to plain text. The complete record always stays in the Apify dataset.

1. Authorize a connector once under Apify → Settings → Integrations (Notion, Linear, Airtable, or Apify).
2. Select it in the "Pipe results into your apps" input field. (If the picker is empty, you haven't authorized a connector yet.)
3. For Notion, also set notionParentPageUrl to the page where items should be created.

The connection is mediated by Apify's MCP proxy, so this actor never sees your third-party credentials. Leave the field empty to skip.

Input Parameters

Parameter	Type	Default	Description
mode	string	news	news, matches, urls, fixturesByDate, league, team, or player.
matchIds	array	["4506324"]	Match ids or match URLs (matches mode).
urls	array	sample	FotMob match/team/player/league links (url mode).
date	string	2026-08-29	YYYY-MM-DD for fixtures mode.
daysAhead	integer	0	Extra days after date.
leagueIds	array	["47"]	League ids or names (league mode, fixtures scoping).
season	string	(current)	Season label for league mode.
teamIds	array	["10252"]	Team ids or names (team mode).
playerIds	array	["268375"]	Player ids or names (player mode).
newsPages	integer	2	Listing pages to walk, 20 articles each (news mode).
includePlayerStats	boolean	true	Flat per-player stat rows + top players.
includeEvents	boolean	true	Goals, cards, subs + shotmap.
includeLineups	boolean	true	Starters, subs, formations, coach.
includeTeamStats	boolean	true	Possession, shots, xG groups.
includeH2H	boolean	false	Head-to-head + league table snapshot.
includeRawData	boolean	false	Full embedded page payload.
includeNewsBody	boolean	true	Full article text as bodyHtml + plain-text bodyText (news mode; FotMob-native articles only — syndicated embeds carry no body).
maxItems	integer	20	Stop after this many records (0 = no limit).
resumeFromRunId	string	(none)	Continue one interrupted run.
incrementalMode	boolean	false	Return only new and changed records on scheduled runs.
stateKey	string	(none)	Name or share an incremental-mode state.
emitUnchanged	boolean	false	Also return (and bill) unchanged records.
emitExpired	boolean	false	Also return (and bill) expired records.
ignoreFieldsForChanges	array	(none)	Fields that never mark a record UPDATED.
proxy	object	Apify Proxy	Connection settings.
mcpConnectors	array	(none)	Optional: send a summary of each record to apps you authorized under Integrations.
notionParentPageUrl	string	(none)	Notion connector only: page under which records are created.
maxNotifyListings	integer	50	Cap on items written to each connector per run.

Output Example

Sample shape: values are illustrative placeholders, not from a live record.

Match record for Aston Villa vs Manchester United (illustrative values):

{
 "type": "match",
 "id": 4506324,
 "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",
 "roundName": "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": {"name": "Villa Park", "city": "Birmingham", "capacity": 42788},
 "referee": "Robert Jones",
 "attendance": 42682,
 "playerOfTheMatch": {"playerId": 268375, "name": "Emiliano Martinez", "teamName": "Aston Villa"},
 "teamStats": [{"group": "Top stats", "title": "Ball possession", "key": "BallPossesion", "home": 54, "away": 46}],
 "events": [{"type": "Card", "minute": 3, "minuteLabel": "3", "isHome": false, "playerName": "Christian Eriksen", "card": "Yellow"}],
 "lineups": {"home": {"teamName": "Aston Villa", "formation": "4-4-1-1", "coach": "Unai Emery"}},
 "playerStats": [{"playerId": 268375, "playerName": "Emiliano Martinez", "rating_title": 8.14}],
 "source": "fotmob",
 "scrapedAt": "2024-10-06T00:00:00Z"
}

Plan Requirement

The default proxy setting works out of the box, and the actor rotates connections automatically when one is refused. For large or frequent runs, the residential proxy group gives more headroom; pick it under Connection. If your Apify plan does not include proxy access, the run fails with a clear message instead of returning an empty result; a paid plan with proxy access is required.

FAQ

How much does it cost?

You pay a tiered rate per result returned (the Pricing tab shows the per-plan rates). News articles whose full text was read bill one small enrichment surcharge each. Use Max items to cap the cost of any run.

Is it legal to scrape FotMob?

This actor collects only publicly available football data. You are responsible for how you use it: follow FotMob's terms and the laws that apply to you, and get legal advice if you plan commercial redistribution. Match results and statistics are generally facts, but logos, photos and shot data may be subject to third-party rights.

Can I get only new or changed matches on a schedule?

Yes. Schedule the actor from the Schedules tab and turn on Incremental mode. Each run then returns only new and updated records, and unchanged ones are not billed.

Why did a fixtures run return fewer matches than the full day?

Fixtures mode discovers matches through the tracked leagues' fixtures (leagueIds, default Premier League). Add more league ids to widen the day, and raise Max items so nothing is cut off.

Do I need to know FotMob's numeric ids?

No. leagueIds, teamIds and playerIds also accept names (e.g. "Arsenal", "Lionel Messi", "Premier League") and are resolved to the right id automatically. An unresolvable name is skipped with a warning rather than silently guessed.

Why did my run fail instead of returning an empty dataset?

If the site refuses every request, the run stops with a clear message so "no matches today" is never confused with "nothing could be read". Run it again in a few minutes. If only some targets could be read, you still get what was found.

Can I use it with AI agents or MCP?

Yes. Call it from any Apify integration or MCP client, and use the connector field to push results into Notion, Linear or Airtable.

🔗 Want more sports data?

Pair this actor with these related scrapers from the same team:

⚽ SofaScore Scraper ⚽ Live Scores, Stats, Players & Odds From $1/1K. Pull structured sports data from SofaScore across football, basketball...	⚽ OneFootball Scraper Scrape public OneFootball data including football news, upcoming fixtures, match results...
⚽ Sportsbook Odds Scraper (1xBet, Melbet, Linebet, Paripulse) Collect live and prematch betting odds from 1xBet, Melbet, Linebet and Paripulse. Give it...	⚽ Globo Esporte Scraper Scrape public sports content from ge.globo.com, including news, videos, matches and feed...
⚽ Eventim Scraper Scrape CTS Eventim Germany and EU event catalogue: concerts, festivals, comedy, sports...	⚽ BookMyShow Scraper Scrape BookMyShow movies and live events by city, category or URL. Extract genres...

👉 Browse all abotapi scrapers

💬 Support

• 🐞 Found a bug or a missing field? Open a ticket on the Issues tab. We usually reply within hours.
• 🛠️ Need another site, extra fields or a private build? Email contact@abotapi.com.
• ⭐ Enjoying it? A quick review on the actor page helps other users find it.