FUSSBALL.DE API endpoint
Returns every team's table position after each played matchday of a competition (the site's Fieberkurve), as one ordered list of positions per team. Position 1 is the leader; the list index is the matchday.
/fussballde/position-historycompetition_id (string, required): Competition id from fussballde-competitions.Standard envelope; data holds the result described above. Dates are ISO YYYY-MM-DD, times are local HH:MM. Scores, dates and names that FUSSBALL.DE serves as obfuscated glyphs are decoded server-side. Errors: 400 invalid parameter, 404 unknown id, 503 upstream failure.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| competition_id | string | Yes | Competition id from fussballde-competitions | 031BFREJC800001BVS5489BUVUR5FS5A-G | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/fussballde/position-history?competition_id=031BFREJC800001BVS5489BUVUR5FS5A-G" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"competition_id": "031BFREJC800001BVS5489BUVUR5FS5A-G",
"matchdays": 7,
"teams": [
{
"positions": [
2,
2
],
"team": {
"club_id": "00ES8GN9DO00000TVV0AG08LVUPGND5I",
"logo_url": "https://www.fussball.de/export.media/-/action/getLogo/format/3/id/00ES8GN9DO00000TVV0AG08LVUPGND5I/verband/0123456789ABCDEF0123456700004010",
"name": "Sport-Club Freiburg"
}
},
{
"positions": [
5,
3
],
"team": {
"club_id": "00ES8GN8N400008VVV0AG08LVUPGND5I",
"logo_url": "https://www.fussball.de/export.media/-/action/getLogo/format/3/id/00ES8GN8N400008VVV0AG08LVUPGND5I/verband/0123456789ABCDEF0123456700004010",
"name": "Borussia Dortmund"
}
}
]
}
}Request schema
No body schema
Response schema
#/definitions/fussballde.positionHistoryResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | fussballde.PositionHistoryResponse | No | ||||
| data.competition_id | string | No | ||||
| data.matchdays | integer | No | ||||
| data.teams | array | No | ||||
| data.teams[].positions | array | No | ||||
| data.teams[].team | fussballde.TeamRef | No | TeamRef record, 5 fields: club_id, logo_url, name, team_id, url. Described under FUSSBALL.DE Match API. | |||
| 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/fussballde/position-history?competition_id=031BFREJC800001BVS5489BUVUR5FS5A-G" \
-H "x-api-key: $CRAWLORA_API_KEY"