FUSSBALL.DE API endpoint
Returns a competition's standings in one view: `overall`, `home_away` (home and away tables), `rounds` (first and second half-season tables), `fairness` (fair-play table) or `cross` (cross table of results between every pair of teams). Set `matchday` to get the standings as they were after that matchday (not available for `fairness`). Rows carry position, team, played, won, drawn, lost, goals and points where the view has them, plus the raw cells.
/fussballde/tablecompetition_id (string, required): Competition id from fussballde-competitions.view (string, optional): Standings view, default overall. Allowed values: overall, home_away, rounds, fairness, cross.matchday (integer, optional): Return the standings after this matchday, 1 to the competition's matchday count; not available for the fairness view.Standard envelope; data holds the result described above. Dates are ISO YYYY-MM-DD, times are local HH:MM. matchday returns historical standings for overall, home_away, rounds and cross; fairness has no per-matchday history and returns 400 when matchday is set. 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 | |
| view | string | No | Standings view, default overall Allowed values: overall, home_away, rounds, fairness, cross. | overall | |
| matchday | integer | No | Return the standings after this matchday, 1 to the competition's matchday count; not available for the fairness view | 3 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/fussballde/table?competition_id=031BFREJC800001BVS5489BUVUR5FS5A-G&view=overall" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"competition_id": "031BFREJC800001BVS5489BUVUR5FS5A-G",
"matchday": 3,
"tables": [
{
"columns": [
"Platz",
"Mannschaft"
],
"rows": [
{
"cells": [
"6",
"4"
],
"drawn": 2,
"goal_difference": 17,
"goals_against": 5,
"goals_for": 22,
"lost": 0,
"played": 6,
"points": 14,
"position": 1,
"team": {
"club_id": "00ES8GNHAK00001AVV0AG08LVUPGND5I",
"logo_url": "https://www.fussball.de/export.media/-/action/getLogo/format/0/id/00ES8GNHAK00001AVV0AG08LVUPGND5I/verband/0123456789ABCDEF0123456700004010",
"name": "FC Bayern München"
},
"won": 4
},
{
"cells": [
"6",
"4"
],
"drawn": 2,
"goal_difference": 7,
"goals_against": 4,
"goals_for": 11,
"lost": 0,
"played": 6,
"points": 14,
"position": 2,
"team": {
"club_id": "00ES8GN8N400008VVV0AG08LVUPGND5I",
"logo_url": "https://www.fussball.de/export.media/-/action/getLogo/format/0/id/00ES8GN8N400008VVV0AG08LVUPGND5I/verband/0123456789ABCDEF0123456700004010",
"name": "Borussia Dortmund",
"team_id": "011MI8V6UC000000VTVG0001VTR8C1K7",
"url": "https://www.fussball.de/mannschaft/borussia-dortmund-borussia-dortmund-westfalen/-/saison/2627/team-id/011MI8V6UC000000VTVG0001VTR8C1K7"
},
"won": 4
}
]
}
],
"view": "overall"
}
}Request schema
No body schema
Response schema
#/definitions/fussballde.tableResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | fussballde.TableResponse | No | ||||
| data.competition_id | string | No | ||||
| data.matchday | integer | No | 3 | |||
| data.tables | array | No | ||||
| data.tables[].columns | array | No | ||||
| data.tables[].rows | array | No | ||||
| data.tables[].rows[].cells | array | No | ||||
| data.tables[].rows[].drawn | integer | No | ||||
| data.tables[].rows[].goal_difference | integer | No | ||||
| data.tables[].rows[].goals_against | integer | No | ||||
| data.tables[].rows[].goals_for | integer | No | ||||
| data.tables[].rows[].lost | integer | No | ||||
| data.tables[].rows[].played | integer | No | ||||
| data.tables[].rows[].points | integer | No | ||||
| data.tables[].rows[].position | integer | No | ||||
| data.tables[].rows[].team | fussballde.TeamRef | No | TeamRef record, 5 fields: club_id, logo_url, name, team_id, url. Described under FUSSBALL.DE Match API. | |||
| data.tables[].rows[].won | integer | No | ||||
| data.tables[].title | string | No | Heimtabelle | |||
| data.view | string | No | overall | |||
| 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/table?competition_id=031BFREJC800001BVS5489BUVUR5FS5A-G&view=overall" \
-H "x-api-key: $CRAWLORA_API_KEY"