FotMob API endpoint
Returns 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.
/fotmob/leagueQuery parameters:
league_id (required): numeric FotMob league id. Discover ids through /api/v1/fotmob/leagues.season (optional): a season string returned by /api/v1/fotmob/seasons?league_id=..., such as 2025/2026. Values are league-specific and change over time.shotmap (optional): set to true to include the optional overview.shotMap data. This makes the response substantially larger.Returns FotMob's public league page JSON, preserving the source shape. It includes tabs, allAvailableSeasons, and the available league overview, table, fixtures, stats, transfers, and seasons data. The exact tabs vary by league. Use /fotmob/seasons for a focused season discovery response. The optional shot map increases the response from about 828 KB to 1.9 MB for the Premier League. /fotmob/table is a smaller focused standings response; its separate source feed currently ignores the season parameter.
| Field | Filled in, of 380 checked | Values in the sample |
|---|---|---|
| id | 380 | |
| pageUrl | 380 | “/matches/coventry-city-vs-arsenal/2tttz6#5795363” and 379 other values |
| opponent | 380 | |
| home | 380 | |
| away | 380 | |
| displayTournament | 380 | true in 380 of 380 |
| notStarted | 380 | true in 320 of 380 |
| tournament | 380 | |
| status | 380 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| league_id | integer | Yes | Numeric FotMob league id from /fotmob/leagues | 47 | |
| season | string | No | Optional season value from /fotmob/seasons for this league | 2025/2026 | |
| shotmap | boolean | No | Include the optional overview shot map; increases response size | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/fotmob/league?league_id=47&shotmap=true" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"data": {
"source_url": "https://www.fotmob.com/api/data/leagues?id=47&season=2025%2F2026",
"data": {
"tabs": [
"overview",
"table",
"fixtures",
"stats",
"transfers",
"seasons"
],
"allAvailableSeasons": [
"2026/2027",
"2025/2026"
],
"details": {
"id": 47,
"name": "Premier League",
"selectedSeason": "2025/2026"
},
"overview": {
"leagueName": "Premier League"
},
"table": [],
"fixtures": {},
"stats": {},
"transfers": {},
"seasons": []
}
}
}Request schema
No body schema
Response schema
#/definitions/fotmob.responseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | fotmob.sourceDataDoc | No | ||||
| data.data | object | No | ||||
| data.source_url | string | No | https://www.fotmob.com/api/data/matches?date=20260925&timezone=UTC | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/fotmob/league?league_id=47&shotmap=true" \
-H "x-api-key: $CRAWLORA_API_KEY"