FotMob API endpoint
Returns 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.
/fotmob/tv-guideQuery parameters:
country (required): market code from /api/v1/fotmob/tv-guide-countries. All accepted values: 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, pl, pt, ro, ru, ch, tr, za, br, in, me, id, th, mm, al, az, bl, ba, ks, la, li, mk, rs, sk, ua, essv, nz, bd, cn, gh, hk, jp, kr, ma, mt, my, ng, ph, pk, sg, si, tz.timezone (optional): IANA timezone used for schedule times; defaults to UTC.Returns FotMob's public seven-day football broadcast schedule, grouped by date and competition. Match rows include the currently listed channels and their public affiliate metadata. Empty schedules are possible for a supported market when no matches are listed in the current window.
| Field | Filled in, of 28 checked | Values in the sample |
|---|---|---|
| key | 28 | |
| leagueId | 28 | 47 to 10,699, median 113 |
| leagueName | 28 | “Major League Soccer” and 26 other values |
| leagueStage | 28 | “30” and 13 other values |
| leagueCcode | 28 | “USA” and 15 other values |
| matches | 28 | median 2 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| country | string | Yes | Market code from /fotmob/tv-guide-countries Allowed values: 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, pl, pt, ro, ru, ch, tr, za, br, in, me, id, th, mm, al, az, bl, ba, ks, la, li, mk, rs, sk, ua, essv, nz, bd, cn, gh, hk, jp, kr, ma, mt, my, ng, ph, pk, sg, si, tz. | us | |
| timezone | string | No | IANA timezone for local times | America/New_York | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/fotmob/tv-guide?country=us" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"data": {
"source_url": "https://www.fotmob.com/api/data/tvguide?country=us&timezone=UTC",
"data": {
"20260926": [
{
"key": "130",
"leagueId": 130,
"leagueName": "Major League Soccer",
"matches": [
{
"id": 5071381,
"utcTime": "2026-09-26T23:30:00.000Z",
"home": {
"id": 773958,
"name": "Atlanta United"
},
"away": {
"id": 546238,
"name": "New York City FC"
},
"channels": [
{
"name": "Apple TV (US)"
}
]
}
]
}
]
}
}
}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/tv-guide?country=us" \
-H "x-api-key: $CRAWLORA_API_KEY"