API Reference
Use Crawlora's FotMob API endpoints to extract supported public FotMob data as structured JSON. This documentation covers 31 active endpoints including FotMob matches with audio commentary, FotMob FIFA ranking period directory, FotMob FIFA national-team rankings, FotMob latest football news, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as gender, period_id, league_id, player_ids, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/fotmob/matches" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/fotmob/audio-matchesapiKey1 credit/requestReturns FotMob's current match-to-audio-language availability index. Match ids are open-ended and can be passed to /fotmob/match. The list is independent of a selected match date and may include matches outside the current fixtures feed.
Required params: None
/fotmob/fifa-ranking-periodsapiKey1 credit/requestReturns every ranking period currently offered by FotMob for the selected gender. Use a returned periodId with /fotmob/fifa-rankings.
Required params: gender:query
/fotmob/fifa-rankingsapiKey2 credits/requestReturns ranked national-team points and rank changes for one period. Discover valid periodId values for the selected gender from /fotmob/fifa-ranking-periods.
Required params: gender:query, period_id:query
/fotmob/latest-newsapiKey1 credit/requestReturns the global English latest-news feed. Items are article previews; the upstream response contains up to 20 items per offset. Use start_index increments of 20 to page without overlap.
Required params: None
/fotmob/leagueapiKey2 credits/requestReturns FotMob's public league page payload, including available tabs, overview, table, fixtures, statistics, transfers, and seasons where supplied by the league. Discover valid season values with /fotmob/seasons. shotmap=true includes the optional, larger overview shot-map payload.
Required params: league_id:query
/fotmob/leaguesapiKey1 credit/requestReturns FotMob's full public league directory grouped into popular, international, and country collections. Use league ids with other FotMob endpoints.
Required params: None
/fotmob/lineup-builder-playersapiKey1 credit/requestReturns public metadata for 1 to 11 selected lineup players. Player ids are open-ended and can be discovered through /fotmob/search or /fotmob/lineup-builder-team. Unknown ids without complete public metadata return 404.
Required params: player_ids:query
/fotmob/lineup-builder-teamapiKey2 credits/requestReturns the public lineup builder's prefilled formation, starting lineup, and squad for a team id. Discover open-ended team ids with /fotmob/search. Some teams legitimately have no squad list.
Required params: team_id:query
/fotmob/match-mediaapiKey1 credit/requestReturns the public highlight-video and media metadata for one match. The request uses FotMob's English United States variant; unavailable media is represented by null source fields.
Required params: id:query
/fotmob/matchapiKey2 credits/requestReturns FotMob's public match-details payload, including available facts, events, statistics, lineups, shot map, momentum, table and head-to-head sections. The data field preserves the upstream JSON shape; individual sections may be absent for a match.
Required params: id:query
/fotmob/matchesapiKey1 credit/requestReturns FotMob's public match payload for a calendar date and IANA timezone. The data field preserves the upstream JSON shape.
Required params: date:query
/fotmob/news-articleapiKey1 credit/requestReturns the full article body for a FotMob-authored top-news story. Pass the complete id-and-slug value from the public /topnews/<id> URL. News previews from external publishers remain external and are not fetched.
Required params: id:query
/fotmob/newsapiKey1 credit/requestReturns a page of FotMob news items for one league. League ids are discoverable from /fotmob/leagues; start_index is a zero-based offset.
Required params: league_id:query
/fotmob/player-match-statsapiKey2 credits/requestReturns the public per-match stat rows for one player, including the available stat key, value, and translated label. Discover player ids through fotmob/search and match ids through fotmob/match or fotmob/player-matches.
Required params: player_id:query, match_id:query
/fotmob/player-matchesapiKey2 credits/requestReturns one page of player match history. The player's matchFilters and permitted league/team pairs are discovered from /fotmob/player. For another page, copy the numeric before timestamp from the upstream previous URL.
Required params: player_id:query
/fotmob/player-statsapiKey2 credits/requestReturns deep statistics, shot map, heatmap, and goalkeeper shot map for one player-specific season entry. Discover valid season_id values and hasDeepStats from /fotmob/player statSeasons; entry ids vary by player and season.
Required params: player_id:query, season_id:query
/fotmob/playerapiKey2 credits/requestReturns a public FotMob player profile, including current team, injuries, recent matches, career history, trophies, market values, and the player-specific season identifiers needed for deeper statistics. Discover player ids through /fotmob/search. Market values are included by default.
Required params: id:query
/fotmob/searchapiKey1 credit/requestReturns public search suggestions for FotMob leagues, teams, players, and matches. term must contain 1 to 50 characters. Suggestions preserve the upstream JSON shape.
Required params: term:query
/fotmob/seasonsapiKey1 credit/requestReturns the complete list of season values accepted by the FotMob league endpoint for one competition.
Required params: league_id:query
/fotmob/stats-categoriesapiKey1 credit/requestReturns FotMob's current stat catalog and available seasons for a league. With season_id omitted, the response exposes the season list and initial top-stat choices; pass a returned season id to retrieve that season's full player or team stat catalog.
Required params: league_id:query, type:query
/fotmob/statsapiKey2 credits/requestReturns ranked player or team statistics for a stat id discovered from /fotmob/stats-categories. The accepted stat ids vary by league, season, and type. team_id optionally restricts player statistics to one team. position filters player results client-side.
Required params: league_id:query, type:query, stat:query
/fotmob/tableapiKey1 credit/requestReturns the league standings and the upstream table views, including all, home, away, form, and expected-goals tables. League ids are discoverable from /fotmob/leagues.
Required params: league_id:query
/fotmob/team-fixturesapiKey2 credits/requestReturns one page of older team matches. Start with the fixtures.previousFixturesUrl cursor from /fotmob/team, then pass each response's previous value as cursor until it is empty or null. Team ids are open-ended numeric ids discoverable through /fotmob/search.
Required params: team_id:query, cursor:query
/fotmob/team-newsapiKey1 credit/requestReturns the paginated article feed shown on a public FotMob team news page. Team ids can be found with /fotmob/search or /fotmob/team.
Required params: team_id:query
/fotmob/teamapiKey2 credits/requestReturns public team data and the sections currently available for that team, such as overview, table, fixtures, squad, stats, transfers, and history. Team ids can be found with /fotmob/search. The upstream section set varies by team. For older fixtures, pass fixtures.previousFixturesUrl to /fotmob/team-fixtures.
Required params: id:query
/fotmob/transfersapiKey2 credits/requestReturns confirmed transfers, rumours, or popular transfers with the public transfer-center filters. Fee values are in EUR. Use fotmob/leagues and fotmob/search to discover league and team ids. The upstream returns 50 rows per page and caps its hit count at 10,000.
Required params: None
/fotmob/trending-newsapiKey1 credit/requestReturns the five-story Trending shelf shown on FotMob's public News page. Items are curated previews and may overlap the global latest-news feed; the upstream list is dynamic. No locale or country parameter is exposed because the complete accepted value space is not pinned.
Required params: None
/fotmob/trending-searchesapiKey1 credit/requestReturns FotMob's current grouped trending suggestions for all entities, players, teams, and leagues. The feed is dynamic and may vary by the upstream's inferred region; no region or category parameter is exposed.
Required params: None
/fotmob/tv-guide-channelsapiKey1 credit/requestDiscovers channels attached to matches in the selected country's current seven-day public TV guide window. Use the country directory to discover the complete country code set.
Required params: country:query
/fotmob/tv-guide-countriesapiKey1 credit/requestLists all country codes exposed by FotMob's public football TV guide country selector.
Required params: None
/fotmob/tv-guideapiKey1 credit/requestReturns the public seven-day football broadcast schedule for a country, with local schedule times. Discover all accepted country codes from /fotmob/tv-guide-countries. Timezone defaults to UTC.
Required params: country:query
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| FotMob matches with audio commentary | /fotmob/audio-matches | GET | 1 credit/request | None | View docs | Try endpoint |
| FotMob FIFA ranking period directory | /fotmob/fifa-ranking-periods | GET | 1 credit/request | gender:query | View docs | Try endpoint |
| FotMob FIFA national-team rankings | /fotmob/fifa-rankings | GET | 2 credits/request | gender:query, period_id:query | View docs | Try endpoint |
| FotMob latest football news | /fotmob/latest-news | GET | 1 credit/request | None | View docs | Try endpoint |
| FotMob league details and sections | /fotmob/league | GET | 2 credits/request | league_id:query | View docs | Try endpoint |
| FotMob competition directory | /fotmob/leagues | GET | 1 credit/request | None | View docs | Try endpoint |
| FotMob lineup builder player metadata | /fotmob/lineup-builder-players | GET | 1 credit/request | player_ids:query | View docs | Try endpoint |
| FotMob lineup builder team data | /fotmob/lineup-builder-team | GET | 2 credits/request | team_id:query | View docs | Try endpoint |
| FotMob match videos and media metadata | /fotmob/match-media | GET | 1 credit/request | id:query | View docs | Try endpoint |
| FotMob match details | /fotmob/match | GET | 2 credits/request | id:query | View docs | Try endpoint |
| FotMob matches for a date | /fotmob/matches | GET | 1 credit/request | date:query | View docs | Try endpoint |
| FotMob full top-news article | /fotmob/news-article | GET | 1 credit/request | id:query | View docs | Try endpoint |
| FotMob league news | /fotmob/news | GET | 1 credit/request | league_id:query | View docs | Try endpoint |
| FotMob player match stats | /fotmob/player-match-stats | GET | 2 credits/request | player_id:query, match_id:query | View docs | Try endpoint |
| FotMob player match history | /fotmob/player-matches | GET | 2 credits/request | player_id:query | View docs | Try endpoint |
| FotMob player season statistics | /fotmob/player-stats | GET | 2 credits/request | player_id:query, season_id:query | View docs | Try endpoint |
| FotMob player profile | /fotmob/player | GET | 2 credits/request | id:query | View docs | Try endpoint |
| Search FotMob entities | /fotmob/search | GET | 1 credit/request | term:query | View docs | Try endpoint |
| FotMob league season discovery | /fotmob/seasons | GET | 1 credit/request | league_id:query | View docs | Try endpoint |
| FotMob league stat categories and seasons | /fotmob/stats-categories | GET | 1 credit/request | league_id:query, type:query | View docs | Try endpoint |
| FotMob league player or team statistics | /fotmob/stats | GET | 2 credits/request | league_id:query, type:query, stat:query | View docs | Try endpoint |
| FotMob league table | /fotmob/table | GET | 1 credit/request | league_id:query | View docs | Try endpoint |
| FotMob paginated team fixtures | /fotmob/team-fixtures | GET | 2 credits/request | team_id:query, cursor:query | View docs | Try endpoint |
| FotMob team news | /fotmob/team-news | GET | 1 credit/request | team_id:query | View docs | Try endpoint |
| FotMob team details | /fotmob/team | GET | 2 credits/request | id:query | View docs | Try endpoint |
| FotMob transfer center | /fotmob/transfers | GET | 2 credits/request | None | View docs | Try endpoint |
| FotMob trending football news | /fotmob/trending-news | GET | 1 credit/request | None | View docs | Try endpoint |
| FotMob trending search suggestions | /fotmob/trending-searches | GET | 1 credit/request | None | View docs | Try endpoint |
| FotMob TV guide channels | /fotmob/tv-guide-channels | GET | 1 credit/request | country:query | View docs | Try endpoint |
| FotMob TV guide country directory | /fotmob/tv-guide-countries | GET | 1 credit/request | None | View docs | Try endpoint |
| FotMob football TV guide | /fotmob/tv-guide | GET | 1 credit/request | country:query | View docs | Try endpoint |