FotMob Football Data Scraper

Extract live and historical football data from FotMob into clean, structured Apify datasets. The Actor supports worldwide matches, league discovery, standings, fixtures, results, seasons, top players, and optional statistics.

No FotMob login or API key is required. The Actor reads FotMob's public JSON endpoints and returns normalized records that are ready for JSON, CSV, Excel, API, and downstream data workflows.

What you can collect

• Matches: one record per fixture, live match, postponed match, or finished result, including teams, scores, kickoff times, status, league context, tournament stage, and a FotMob match URL.
• Leagues: the worldwide FotMob league and competition catalog with league IDs, names, localized names, country codes, categories, and URLs.
• League seasons: one record per league-season with standings, fixtures, results, match IDs, available seasons, top players, and optional player and team statistics.
• Matches and leagues: combine match records and league records in one dataset. Each record includes a recordType field.

Quick start

Choose an operation and start the Actor. The default operation fetches today's matches using the International locale.

Worldwide matches

{
  "operation": "matches",
  "matchStatus": "all",
  "timezone": "UTC",
  "countryCode": "INT"
}

A date range

{
  "operation": "matches",
  "startDate": "2026-08-29",
  "endDate": "2026-09-04",
  "timezone": "Europe/London",
  "matchStatus": "all"
}

League catalog

{
  "operation": "leagues",
  "countryCode": "INT",
  "locale": "en",
  "maxItems": 0
}

Set leagueCountryCodes to filter catalog or match records, for example ["ENG"] or ["ENG", "ESP"].

League season data

{
  "operation": "leagueSeasons",
  "leagueIds": ["47"],
  "seasons": ["2025/2026"],
  "includeStandings": true,
  "includeFixtures": true,
  "includeTopPlayers": true,
  "includeStats": true
}

Use leagueIds from the league catalog. If seasons is empty, the Actor fetches the most recent seasons according to maxSeasons.

Public example Tasks

Run a preconfigured example, review the input, and start it directly from Apify:

• Global matches today
• Upcoming matches today
• England matches today
• Full worldwide league catalog
• England league catalog
• Premier League current season
• Premier League historical season
• English Championship current season

Input reference

Input	Description
operation	matches, leagues, leagueSeasons, or both
startDate, endDate	Match dates in YYYY-MM-DD format. The end date is inclusive.
timezone	IANA timezone used for date grouping and local kickoff times.
countryCode	Three-letter FotMob country or region code used for localization. The default is INT for International.
locale	Locale sent to the league catalog endpoint, such as en.
leagueIds	FotMob league IDs to select or scrape.
leagueCountryCodes	Country codes used to filter match or league records.
seasons	Exact seasons such as 2025/2026.
maxSeasons	Number of recent seasons to fetch when exact seasons are not supplied.
matchStatus	all, live, upcoming, finished, or cancelled.
includeStandings	Include the season table.
includeFixtures	Include every fixture and result plus a flat matchIds list.
includeTopPlayers	Include top players by rating, goals, and assists.
includeStats	Include FotMob player and team statistic categories.
maxItems	Maximum number of output records. Use 0 for the complete result.
includeRaw	Add the original FotMob object under rawData.

Advanced options are available for request delay, retries, date range size, and Apify Proxy configuration.

Output

The default dataset contains one normalized record per match, league, or league-season.

Match records

Match records can include:

• matchId and matchUrl
• homeTeam and awayTeam objects with IDs and names
• scores, status, kickoff time, local time, and Unix timestamp
• leagueId, leagueName, leagueCountryCode, and tournament stage
• query date, timezone, source URL, and scrape timestamp

League records

League records can include:

• leagueId, name, and localizedName
• countryCode and countryName
• catalog sections
• pageUrl and a ready-to-use leagueUrl
• source URL and scrape timestamp

League-season records

League-season records can include:

• league name, short name, color, URL, and selected season
• available seasons and current-season information
• standings with team data and table statistics
• fixtures and results with match IDs
• top players by rating, goals, and assists
• optional player and team statistic categories

Every record includes recordType, scrapedAt, and sourceUrl. The run summary is stored in the default key-value store under RUN_SUMMARY.

Pricing

The Actor uses pay-per-event pricing:

• $0.0025 per match record
• $0.0015 per league record
• $0.008 per league-season record
• $0.00005 per Actor start

Bulk rates apply after 10,000 records in one run. Failed requests are not charged, and Apify's maximum charge setting can be used to control the budget for a run.

Integrate the data

Results can be exported from Apify as JSON, CSV, Excel, or through the Dataset API. The Actor can also be called from the Apify API, JavaScript, Python, Make, Zapier, n8n, or a scheduled workflow.

Typical football-data workflow:

1. Run the full league catalog to discover FotMob league IDs.
2. Pass selected league IDs to leagueSeasons for standings, fixtures, results, and player data.
3. Use the match IDs from the output in a match-details workflow if deeper per-match data is needed.

Disclaimer

This Actor is not affiliated with, endorsed by, or sponsored by FotMob. Use the data responsibly and ensure that your use complies with FotMob's terms and applicable law.