FotMob API endpoint
Returns ranked national-team points and rank changes for one period. Discover valid periodId values for the selected gender from /fotmob/fifa-ranking-periods.
/fotmob/fifa-rankingsQuery parameters:
gender (required): one of men, women.period_id (required): a period id returned by /fotmob/fifa-ranking-periods for the same gender.Returns the ranking rows, points, and rank-change flags for the selected period. The service checks that period_id is present in the current gender-specific period directory before requesting the ranking.
| Field | Filled in, of 211 checked | Values in the sample |
|---|---|---|
| name | 211 | “Spain” and 210 other values |
| id | 211 | |
| rank | 211 | 1 to 211, median 106 |
| totalPoints | 211 | 721 to 1,996, median 1,192 |
| previousPoints | 211 | 721 to 1,877, median 1,192 |
| pointsDiff | 211 | -61 to 121, median 0 |
| gainedRank | 211 | true in 37 of 211 |
| lostRank | 211 | true in 27 of 211 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| gender | string | Yes | Ranking gender Allowed values: men, women. | men | |
| period_id | string | Yes | Period id returned for this gender by /fotmob/fifa-ranking-periods | 20260720 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/fotmob/fifa-rankings?gender=men&period_id=20260720" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://www.fotmob.com/api/data/fifarankings/ranking?gender=men&periodId=20260720",
"data": [
{
"name": "Spain",
"id": 6720,
"rank": 1,
"totalPoints": 1996,
"previousPoints": 1875,
"pointsDiff": 121,
"gainedRank": true,
"lostRank": false
}
]
}
}Request schema
No body schema
Response schema
#/definitions/fotmob.fifaRankingsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | fotmob.fifaRankingRowsDataDoc | No | ||||
| data.data | array | No | ||||
| data.data[].gainedRank | boolean | No | true | |||
| data.data[].id | integer | No | 6720 | |||
| data.data[].lostRank | boolean | No | false | |||
| data.data[].name | string | No | Spain | |||
| data.data[].pointsDiff | integer | No | 121 | |||
| data.data[].previousPoints | integer | No | 1875 | |||
| data.data[].rank | integer | No | 1 | |||
| data.data[].totalPoints | integer | No | 1996 | |||
| data.source_url | string | No | https://www.fotmob.com/api/data/fifarankings/ranking?gender=men&periodId=20260720 | |||
| 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/fifa-rankings?gender=men&period_id=20260720" \
-H "x-api-key: $CRAWLORA_API_KEY"