FUSSBALL.DE API endpoint
Returns the profile of one of the 22 federations (the DFB and the regional and state associations) or of one of the five regional associations (Norddeutscher, Nordostdeutscher, Süddeutscher, Südwest and Westdeutscher): name, address, website, president, club, member and team counts, and the latest news items. Provide exactly one of `federation_id` and `regional_association`.
/fussballde/federationfederation_id (string, optional): Federation id; provide exactly one of federation_id and regional_association. Allowed values: 89, 32, 31, 66, 61, 02, 03, 34, 62, 23, 22, 01, 41, 43, 63, 64, 04, 33, 42, 65, 21, 35. Names: 89 Deutschland, 32 Baden, 31 Bayern, 66 Berlin, 61 Brandenburg, 02 Bremen, 03 Hamburg, 34 Hessen, 62 Mecklenburg-Vorpommern, 23 Mittelrhein, 22 Niederrhein, 01 Niedersachsen, 41 Rheinland, 43 Saarland, 63 Sachsen, 64 Sachsen-Anhalt, 04 Schleswig-Holstein, 33 Südbaden, 42 Südwest, 65 Thüringen, 21 Westfalen, 35 Württemberg.regional_association (string, optional): Regional association; provide exactly one of federation_id and regional_association. Allowed values: nord, nordost, sued, suedwest, west. Names: nord Norddeutscher Fußball-Verband, nordost Nordostdeutscher Fußballverband, sued Süddeutscher Fußball-Verband, suedwest Fußball-Regional-Verband Südwest, west Westdeutscher Fußballverband.Standard envelope; data holds the result described above. Dates are ISO YYYY-MM-DD, times are local HH:MM. Federation pages are keyed by a separate "verband" id which the response returns as verband_id. Errors: 400 invalid parameter, 404 unknown id, 503 upstream failure.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| federation_id | string | No | Federation id; provide exactly one of federation_id and regional_association Allowed values: 89, 32, 31, 66, 61, 02, 03, 34, 62, 23, 22, 01, 41, 43, 63, 64, 04, 33, 42, 65, 21, 35. | 21 | |
| regional_association | string | No | Regional association; provide exactly one of federation_id and regional_association Allowed values: nord, nordost, sued, suedwest, west. | west | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/fussballde/federation?federation_id=89®ional_association=nord" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"federation_id": "21",
"name": "Fußball- und Leichtathletik-Verband Westfalen",
"news": [
{
"category": "Magazin",
"date": "2026-10-21",
"excerpt": "Davon träumt jeder Amateurfußballer: Nino Lammers steuerte in der Veltins-Arena drei Tore zum 4:3 seines Vorwärts Epe II bei - und das in einem richtigen Meisterschaftsspiel.",
"id": "10067496",
"time": "13:00",
"title": "Epes Arena-Held Nino Lammers: \"Das wird mich einige Kisten kosten\"",
"url": "https://www.fussball.de/newsdetail/epes-arena-held-nino-lammers-das-wird-mich-einige-kisten-kosten/-/article-id/10067496"
},
{
"category": "Magazin",
"date": "2024-12-15",
"excerpt": "Mit 67 will es Manfred Wölpper noch mal wissen. Der langjährige Trainer kehrt zum VfB Hüls in die 8. Liga zurück - hier feierte er einst in der Regionalliga große Erfolge.",
"id": "264693",
"time": "08:30",
"title": "VfB-Coach Wölpper: \"Durch und durch Hülser\"",
"url": "https://www.fussball.de/newsdetail/vfb-coach-woelpper-durch-und-durch-huelser/-/article-id/264693"
}
],
"profile": [
{
"label": "Adresse",
"value": "Jakob-Koenen-Str. 2, 59174 Kamen"
},
{
"label": "Webseite",
"url": "http://www.flvw.de",
"value": "www.flvw.de"
}
],
"summary": [
{
"label": "Anzahl der Vereine",
"value": "2172"
},
{
"label": "Mannschaften",
"value": "16665"
}
],
"url": "http://127.0.0.1:52964/verband/x/-/verband/0123456789ABCDEF0123456700004130",
"verband_id": "0123456789ABCDEF0123456700004130"
}
}Request schema
No body schema
Response schema
#/definitions/fussballde.federationResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | fussballde.FederationDetail | No | ||||
| data.federation_id | string | No | 21 | |||
| data.name | string | No | Fußball- und Leichtathletik-Verband Westfalen | |||
| data.news | array | No | NewsItem record, 7 fields: category, date, excerpt, id, time, title, url. Described under FUSSBALL.DE News API. | |||
| data.profile | array | No | ||||
| data.profile[].label | string | No | Gründungsjahr | |||
| data.profile[].url | string | No | ||||
| data.profile[].value | string | No | 1909 | |||
| data.regional_association | string | No | west | |||
| data.summary | array | No | ||||
| data.summary[].label | string | No | Gründungsjahr | |||
| data.summary[].url | string | No | ||||
| data.summary[].value | string | No | 1909 | |||
| data.url | string | No | ||||
| data.verband_id | string | No | 0123456789ABCDEF0123456700004130 | |||
| 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/federation?federation_id=89®ional_association=nord" \
-H "x-api-key: $CRAWLORA_API_KEY"