FotMob API endpoint
Returns FotMob's public match payload for a calendar date and IANA timezone. The data field preserves the upstream JSON shape.
/fotmob/matchesQuery parameters:
date (required): calendar date as YYYYMMDD, for example 20260925.timezone (optional): IANA timezone, for example Asia/Shanghai. Defaults to UTC.Returns the source JSON under data; its match grouping and league fields follow FotMob's current payload and may change upstream.
| Field | Filled in, of 61 checked | Values in the sample |
|---|---|---|
| isGroup | 20 | true in 20 of 20 |
| groupName | 20 | “1” and 11 other values |
| ccode | 61 | “INT” and 19 other values |
| id | 61 | |
| primaryId | 61 | 111 to 13,287, median 9,091 |
| name | 61 | “UEFA Nations League A Grp. 1” and 59 other values |
| matches | 61 | median 2 entries |
| parentLeagueId | 56 | 114 to 13,287, median 9,134 |
| parentLeagueName | 20 | Africa Cup of Nations Qualifica… (8), CONCACAF Nations League (4), UEFA Nations League B (2) and 5 more |
| internalRank | 61 | 0 to 18, median 0 |
| simpleLeague | 61 | true in 0 of 61 |
| localRank | 5 | 9 to 45, median 11 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| date | string | Yes | Date in YYYYMMDD format | 20260925 | |
| timezone | string | No | UTC | IANA timezone; defaults to UTC | Asia/Shanghai |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/fotmob/matches?date=20260925" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://www.fotmob.com/api/data/matches?date=20260925&timezone=UTC",
"data": {
"leagues": [
{
"id": 47,
"name": "Premier League",
"matches": [
{
"id": 5181825,
"status": "Not started"
}
]
}
]
}
}
}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 |
| 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/matches?date=20260925" \
-H "x-api-key: $CRAWLORA_API_KEY"