API Reference
Collect FotMob sports and competition data through 17 documented Crawlora endpoints. Covers football fixtures, scores, teams, players, tables, and transfers. 31 endpoints documented below.
curl "https://api.crawlora.net/api/v1/fotmob/matches?date=20260925&timezone=UTC" \
-H "x-api-key: $CRAWLORA_API_KEY"FotMob is football-specific. Use league and fixture routes to establish context, then match, team, player, and statistics routes for analysis. FotMob's football-only routes cover leagues, fixtures, matches, teams, players, tables, statistics, and transfers. On 2026-09-26 its matches route listed England versus Spain and Czechia versus Croatia in UEFA Nations League A Group 3. Keep the competition and season identifier when joining match data to league tables. Store the request time for live fixtures, and use stable match or player IDs instead of names alone because the same player name can occur on different teams. A pull on 2026-10-27 showed the league directory split into popular leagues (Premier League id 47 first) and an international group of 127 leagues, a 20-item latest-news feed, and 351 FIFA ranking periods.
Use leagues, league, and matches to locate competitions and fixtures.
Use team, player, tables, player stats, and player match stats for football context.
Use transfers, team news, league news, and match routes to monitor changes.
leagues returned a popular group of 10 leagues, led by the Premier League (id 47, country code ENG, page /leagues/47/overview/premier-league), and an international group containing 127 leagues.
fifa-ranking-periods for men returned 351 periods, the first period listed, periodId 20261007 (07.10.2026). Pass a periodId to the rankings route.
latest-news returned 20 items with a gmtTime (2026-10-27T03:00:00.000Z for the first), source name and image.
/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.
Takes no parameters.
Sampled 14 Oct 2026: 190 items. Filled in every item: id, langs. In the sample: langs: median 1 entry.
/fotmob/fifa-ranking-periodsapiKey1 credit/requestLists the FIFA ranking periods FotMob currently offers for the required `gender` (`men` or `women`). Each period has a `periodId` and a `periodName` date label. Pass a `periodId` to the FotMob FIFA rankings endpoint; the ids change over time and are not a fixed set.
Required: gender (2 allowed values: men, women).
Sampled 14 Oct 2026: 351 items. Filled in every item: periodId, periodName. In the sample: periodId: 19,921,231 to 20,261,007, median 20,090,211; periodName: “07.10.2026” and 350 other values.
/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: gender (2 allowed values: men, women), period_id.
Sampled 14 Oct 2026: 211 items. Filled in every item: name, id, rank, totalPoints, previousPoints, pointsDiff, gainedRank, lostRank. In the sample: rank: 1 to 211, median 106; name: “Spain” and 210 other values; gainedRank: true in 37 of 211; totalPoints: 721 to 1,996, median 1,192; previousPoints: 721 to 1,877, median 1,192; pointsDiff: -61 to 121, median 0; lostRank: true in 27 of 211.
/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.
Optional: start_index.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, imageUrl, title, gmtTime, sourceStr, sourceIconUrl, page, language. Not in every item: lead (10). In the sample: gmtTime: 2026-10-13; sourceStr: FotMob (10), SI (9), The Analyst (1); imageUrl: images2.minutemediacdn.com and 3 other hosts; title: median 70 characters; sourceIconUrl: images.fotmob.com; lead: median 127 characters.
/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: league_id. Optional: season, shotmap.
Sampled 14 Oct 2026: 380 items. Filled in every item: id, pageUrl, opponent, home, away, displayTournament, notStarted, tournament and 1 more. In the sample: pageUrl: “/matches/coventry-city-vs-arsenal/2tttz6#5795363” and 379 other values; displayTournament: true in 380 of 380; notStarted: true in 320 of 380.
/fotmob/leaguesapiKey1 credit/requestReturns FotMob's full public league directory grouped into popular, international, and country collections. Use league ids with other FotMob endpoints.
Takes no parameters.
Sampled 14 Oct 2026: 94 items. Filled in every item: ccode, name, leagues, localizedName. In the sample: ccode: “ALB” and 93 other values; leagues: median 4 entries; name: “Albania” and 93 other values; localizedName: “Albania” and 93 other values.
/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: player_ids.
Sampled 14 Oct 2026: 1 fields returned with a value.
/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: team_id.
Sampled 14 Oct 2026: 24 items. Filled in every item: id, name, position, teamId, teamName. In the sample: position: 0 to 3, median 2; name: “David Raya” and 23 other values.
/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: id.
Sampled 14 Oct 2026: 2 items. Filled in every item: id, eventId, title, image, url, source, eventType. Not in every item: elapsed (0). In the sample: title: “Brighton v. Arsenal | PREMIER LEAGUE HIGHLIGHTS | 9/19/2026…” and 1 other value; image: i.ytimg.com; url: youtube.com; source: “www.youtube.com”.
/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: id.
/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: date. Optional: timezone.
Sampled 14 Oct 2026: 61 items. Filled in every item: ccode, id, primaryId, name, matches, internalRank, simpleLeague. Not in every item: isGroup (20), groupName (20), parentLeagueId (56), parentLeagueName (20), localRank (5). In the sample: parentLeagueName: Africa Cup of Nations Qualifica… (8), CONCACAF Nations League (4), UEFA Nations League B (2) and 5 more; primaryId: 111 to 13,287, median 9,091; groupName: “1” and 11 other values; isGroup: true in 20 of 20; matches: median 2 entries; ccode: “INT” and 19 other values; name: “UEFA Nations League A Grp. 1” and 59 other values; parentLeagueId: 114 to 13,287, median 9,134.
/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: id.
Sampled 14 Oct 2026: 12 fields returned with a value, 2 empty (data.subtitle, data.related). In the sample: data.time: 2022-10-11; data.dataStr: “about 4 years ago”; data.imageUrl: latest.fotmob.com; data.topNews: true; data.title: 31 characters; data.embedded: false; data.updated: 2022-10-11; data.html: 1,410 characters.
/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: league_id. Optional: start_index.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, imageUrl, title, gmtTime, sourceStr, sourceIconUrl, page, language. Not in every item: lead (2). In the sample: gmtTime: 2026-10-13; sourceStr: Sky Sports (10), SI (4), talkSPORT (3) and 2 more; imageUrl: e2.365dm.com and 7 other hosts; title: median 71 characters; sourceIconUrl: images.fotmob.com; lead: median 127 characters.
/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: player_id, match_id.
Sampled 14 Oct 2026: 37 items. Filled in every item: statKey, statValue, statKeyTranslated. In the sample: statKey: “minutes_played” and 36 other values; statValue: “81” and 19 other values; statKeyTranslated: “Minutes played” and 36 other values.
/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: player_id. Optional: league_id, team_id, before.
Sampled 14 Oct 2026: 20 items. Filled in every item: teamId, teamName, opponentTeamId, opponentTeamName, isHomeTeam, id, matchDate, matchPageUrl and 13 more. Not in every item: stage (6), lineupPositionId (13). In the sample: teamName: England (11), Arsenal (9); teamId: 8,491 to 9,825, median 8,491; opponentTeamName: “Leeds United” and 18 other values; isHomeTeam: true in 9 of 20; opponentTeamId: 5,922 to 10,252, median 8,463; matchPageUrl: “/matches/leeds-united-vs-arsenal/2rkmmx#5795465” and 19 other values; leagueId: 42 to 9,806, median 77; leagueName: World Cup (7), Premier League (6), UEFA Nations League A (4) and 3 more.
/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: player_id, season_id.
Sampled 14 Oct 2026: 57 items. Filled in every item: x, y.
/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: id. Optional: include_market_values.
Sampled 14 Oct 2026: 70 items. Filled in every item: teamId, teamName, opponentTeamId, opponentTeamName, isHomeTeam, id, matchDate, matchPageUrl and 13 more. Not in every item: stage (14), lineupPositionId (46). In the sample: teamName: Arsenal (55), England (15); teamId: 8,491 to 9,825, median 9,825; opponentTeamName: “Leeds United” and 45 other values; isHomeTeam: true in 34 of 70; opponentTeamId: 5,922 to 10,261, median 8,602; matchPageUrl: “/matches/leeds-united-vs-arsenal/2rkmmx#5795465” and 69 other values; leagueId: 42 to 10,195, median 47; leagueName: “Premier League” and 8 other values.
/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: term.
Sampled 14 Oct 2026: 2 items. Filled in every item: title, suggestions. In the sample: suggestions: median 21 entries.
/fotmob/seasonsapiKey1 credit/requestLists the season values FotMob offers for one league, identified by the required numeric `league_id` (from the FotMob leagues endpoint). The response has the league id, name and a `seasons` list such as `2026/2027`. Pass a season to the FotMob league endpoint; the list varies by league.
Required: league_id.
/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: league_id, type (2 allowed values: players, teams). Optional: season_id.
Sampled 14 Oct 2026: 11 items. Filled in every item: id, name, leagueName, leagueId. In the sample: name: “2026/2027” and 10 other values.
/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: league_id, type (2 allowed values: players, teams), stat. Optional: season_id, team_id, position (7 allowed values: all, striker, winger, attackingMidfielder, midfielder, fullback, centerBack).
Sampled 14 Oct 2026: 112 items. Filled in every item: id, teamId, name, position, substatValue, statValue, rank, type. In the sample: teamId: 8,455 to 10,261, median 9,826; name: “Erling Haaland” and 111 other values; position: 32 to 115, median 85; rank: 1 to 109, median 36.
/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: league_id.
Sampled 14 Oct 2026: 1 item. Filled in every item: data, tableFilterTypes, teamForm, nextOpponent, tableHeader. In the sample: tableFilterTypes: median 5 entries.
/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: team_id, cursor.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, pageUrl, opponent, home, away, displayTournament, result, notStarted and 2 more. In the sample: result: -1 to 1, median 1; pageUrl: “/matches/chelsea-vs-arsenal/2rhhrp#4813646” and 19 other values; displayTournament: true in 20 of 20; notStarted: true in 0 of 20.
/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: team_id. Optional: start_index.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, imageUrl, title, gmtTime, sourceStr, sourceIconUrl, page, language. Not in every item: lead (6). In the sample: gmtTime: 2026-10-12 to 2026-10-13; sourceStr: SI (6), Sky Sports (6), FotMob (6) and 1 more; imageUrl: images2.minutemediacdn.com and 6 other hosts; title: median 70 characters; sourceIconUrl: images.fotmob.com; lead: median 135 characters.
/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: id.
Sampled 14 Oct 2026: 53 items. Filled in every item: id, pageUrl, opponent, home, away, displayTournament, notStarted, tournament and 1 more. Not in every item: result (13). In the sample: result: -1 to 1, median 1; pageUrl: “/matches/girona-vs-arsenal/2jrtag#5874664” and 52 other values; displayTournament: true in 15 of 53; notStarted: true in 40 of 53.
/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.
Optional: mode (3 allowed values: all, rumours, popular), page, last (4 allowed values: 6months, 1year, 2years, 3years), direction (3 allowed values: all, in, out), min_fee, max_fee, league_ids, team_ids, order_by (6 allowed values: lastModified, fee, date, name, fromClubName, toClubName), exclude_extensions, likely_only.
Sampled 14 Oct 2026: 50 items. Filled in every item: name, playerId, transferDate, transferText, fromClub, fromClubFullName, fromClubId, fromClubColors and 8 more. Not in every item: position (49), fee (48), amountEuroEstimated (9), toDate (34), marketValue (43). In the sample: transferDate: 2026-09-26 to 2026-10-13; playerId: 45,220 to 1,804,987, median 891,870; name: “Daniel Carvajal” and 48 other values; contractExtension: true in 0 of 50; transferText: median 3 entries; fromClub: “Free agent” and 28 other values; fromClubFullName: “Free agent” and 28 other values; fromClubId: 2 to 583,944, median 8,304.
/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.
Takes no parameters.
Sampled 14 Oct 2026: 5 items. Filled in every item: id, imageUrl, title, gmtTime, sourceStr, sourceIconUrl, page. In the sample: gmtTime: 2026-10-13; sourceStr: SI (3), FotMob (2); imageUrl: latest.fotmob.com and 2 other hosts; title: median 75 characters; sourceIconUrl: images.fotmob.com.
/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.
Takes no parameters.
Sampled 14 Oct 2026: 4 items. Filled in every item: title, suggestions. In the sample: suggestions: median 2 entries.
/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: country (81 allowed values, including us, se, gb, de, no, es, mx, ar, bo, cl, co, cr, ec, gt, hn, ni, pa, py, pe, uy, ve, da, ca, au, at, be, bg, hr, cy, cz, ee, fi, fr, gr, hu, is, ie, il, it, nl).
Sampled 14 Oct 2026: 65 items. Filled in every item: name, match_count. In the sample: match_count: 1 to 95, median 4.
/fotmob/tv-guide-countriesapiKey1 credit/requestLists the countries in FotMob's football TV guide country selector, each with a country `code` (such as `us`, `gb`, `de` or `jp`) and a name. Use a code with the FotMob TV guide and TV guide channels endpoints. It takes no parameters.
Takes no parameters.
Sampled 14 Oct 2026: 81 items. Filled in every item: code, name. In the sample: name: “USA” and 80 other values.
/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: country (81 allowed values, including us, se, gb, de, no, es, mx, ar, bo, cl, co, cr, ec, gt, hn, ni, pa, py, pe, uy, ve, da, ca, au, at, be, bg, hr, cy, cz, ee, fi, fr, gr, hu, is, ie, il, it, nl). Optional: timezone.
Sampled 14 Oct 2026: 28 items. Filled in every item: key, leagueId, leagueName, leagueStage, leagueCcode, matches. In the sample: leagueId: 47 to 10,699, median 113; leagueName: “Major League Soccer” and 26 other values; matches: median 2 entries; leagueStage: “30” and 13 other values; leagueCcode: “USA” and 15 other values.
Results from the 7 days to 14 Oct 2026. Current status
| Endpoint | Request | Checks passed | Median response |
|---|---|---|---|
| FotMob league details and sections | GET /fotmob/league?league_id=47 | 100% | 2.70 s |
| FotMob competition directory | GET /fotmob/leagues | 100% | 1.44 s |
| FotMob lineup builder player metadata | GET /fotmob/lineup-builder-players?player_ids=961995 | 100% | 1.19 s |
| FotMob lineup builder team data | GET /fotmob/lineup-builder-team?team_id=9825 | 100% | 1.22 s |
| FotMob match details | GET /fotmob/match?id=5181825 | 100% | 1.96 s |
| FotMob matches for a date | GET /fotmob/matches?date=20260925&timezone=UTC | 100% | 1.57 s |
| FotMob full top-news article | GET /fotmob/news-article?id=5687-Premier-League-Team-of-the-Week | 99.7% | 1.61 s |
| FotMob league news | GET /fotmob/news?league_id=47&start_index=0 | 100% | 1.36 s |
| FotMob player match stats | GET /fotmob/player-match-stats?match_id=5795457&player_id=961995 | 99.2% | 1.16 s |
| FotMob player match history | GET /fotmob/player-matches?player_id=961995 | 98.1% | 3.09 s |
| FotMob player season statistics | GET /fotmob/player-stats?player_id=961995&season_id=0-1 | 99.7% | 3.15 s |
| FotMob player profile | GET /fotmob/player?id=961995 | 98.1% | 2.06 s |
| Search FotMob entities | GET /fotmob/search?term=Premier+League | 100% | 1.43 s |
| FotMob league stat categories and seasons | GET /fotmob/stats-categories?league_id=47&type=players | 100% | 1.38 s |
| FotMob league player or team statistics | GET /fotmob/stats?league_id=47&stat=goals&type=players | 100% | 2.63 s |
| FotMob league table | GET /fotmob/table?league_id=47 | 99.7% | 1.52 s |
| FotMob paginated team fixtures | GET /fotmob/team-fixtures?cursor=https%3A%2F%2Fpub.fotmob.com%2Fprod%2Fdb%2Fapi%2Fteam%2F9825%2Ffixture-by-date%3FbeforeTimestamp%3D1785607200&team_id=9825 | 100% | 1.43 s |
| FotMob team news | GET /fotmob/team-news?start_index=0&team_id=8456 | 100% | 1.41 s |
| FotMob team details | GET /fotmob/team?id=9825 | 100% | 2.38 s |
| FotMob transfer center | GET /fotmob/transfers?last=6months&mode=all&order_by=lastModified&page=1 | 99.8% | 1.28 s |
| FotMob trending search suggestions | GET /fotmob/trending-searches | 99.7% | 1.36 s |
| FotMob TV guide channels | GET /fotmob/tv-guide-channels?country=us | 100% | 2.20 s |
| FotMob TV guide country directory | GET /fotmob/tv-guide-countries | 100% | 0.07 s |
| FotMob football TV guide | GET /fotmob/tv-guide?country=us&timezone=UTC | 99.7% | 2.35 s |