FUSSBALL.DE API endpoint
Returns one club: name, federation, team counts, profile facts (founding year, address, website) and the club's teams with their competitions and team type. Teams are those of the current season; set `season` for an earlier one and `competition_kind` to keep only teams in championships, cups, friendlies and so on. Club ids appear as `club_id` on teams and matches.
/fussballde/clubclub_id (string, required): Club id from a team or match, e.g. 00ES8GN8N400008VVV0AG08LVUPGND5I.season (string, optional): Four-digit season code such as 2526; default current season.competition_kind (string, optional): Competition kind id; omit for all kinds. Allowed values: 1, 8, 3, 7, 6, 11, 2, 21, 9. Names: 1 Meisterschaften, 8 Pokale, 3 Turniere, 7 Freundschaftsspiele, 6 Privatspiele, 11 Futsal-Ligabetrieb, 2 Hallenturniere (Futsal), 21 Beachsoccer-Meisterschaften, 9 Auswahlspiele.Standard envelope; data holds the result described above. Dates are ISO YYYY-MM-DD, times are local HH:MM. Team ids differ between a club page's own filter lists and other endpoints, so team type is returned per team (team_type) for client-side filtering rather than offered as a filter. Errors: 400 invalid parameter, 404 unknown id, 503 upstream failure.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| club_id | string | Yes | Club id from a team or match, e.g. 00ES8GN8N400008VVV0AG08LVUPGND5I | 00ES8GN8N400008VVV0AG08LVUPGND5I | |
| season | string | No | Four-digit season code such as 2526; default current season | 2526 | |
| competition_kind | string | No | Competition kind id; omit for all kinds Allowed values: 1, 8, 3, 7, 6, 11, 2, 21, 9. | 1 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/fussballde/club?club_id=00ES8GN8N400008VVV0AG08LVUPGND5I&competition_kind=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"club_id": "00ES8GN8N400008VVV0AG08LVUPGND5I",
"federation": "Fußball- und Leichtathletik-Verband Westfalen",
"federation_id": "0123456789ABCDEF0123456700004130",
"junior_team_count": 12,
"name": "Borussia Dortmund",
"profile": [
{
"label": "Gründungsjahr",
"value": "1909"
},
{
"label": "Adresse",
"value": "Strobelallee 50, 44139 Dortmund"
}
],
"season": "2526",
"senior_team_count": 5,
"team_count": 17,
"teams": [
{
"name": "Herren Ü32 - Borussia Dortmund",
"team_id": "01E01A7L58000000VV0AG811VTA8FO8N",
"team_type": "Herren Ü32",
"url": "https://www.fussball.de/mannschaft/borussia-dortmund-borussia-dortmund-westfalen/-/saison/2526/team-id/01E01A7L58000000VV0AG811VTA8FO8N"
},
{
"competition": "Bundesliga",
"competition_id": "02TKC4CR0O00001BVS5489BUVUD1610F-G",
"name": "Herren - Borussia Dortmund",
"team_id": "011MI8V6UC000000VTVG0001VTR8C1K7",
"team_type": "Herren",
"url": "https://www.fussball.de/mannschaft/borussia-dortmund-borussia-dortmund-westfalen/-/saison/2526/team-id/011MI8V6UC000000VTVG0001VTR8C1K7"
}
],
"url": "https://www.fussball.de/verein/borussia-dortmund-westfalen/-/id/00ES8GN8N400008VVV0AG08LVUPGND5I"
}
}Request schema
No body schema
Response schema
#/definitions/fussballde.clubResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | fussballde.ClubDetail | No | ||||
| data.club_id | string | No | ||||
| data.federation | string | No | ||||
| data.federation_id | string | No | ||||
| data.junior_team_count | integer | No | ||||
| data.name | string | No | Borussia Dortmund | |||
| data.profile | array | No | ||||
| data.profile[].label | string | No | Gründungsjahr | |||
| data.profile[].url | string | No | ||||
| data.profile[].value | string | No | 1909 | |||
| data.season | string | No | 2627 | |||
| data.senior_team_count | integer | No | ||||
| data.team_count | integer | No | ||||
| data.teams | array | No | ||||
| data.teams[].competition | string | No | ||||
| data.teams[].competition_id | string | No | ||||
| data.teams[].competition_type | string | No | Freundschaftsspiele | |||
| data.teams[].name | string | No | Herren - Borussia Dortmund | |||
| data.teams[].team_id | string | No | ||||
| data.teams[].team_type | string | No | Herren | |||
| data.teams[].url | string | No | ||||
| data.url | string | No | ||||
| 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/club?club_id=00ES8GN8N400008VVV0AG08LVUPGND5I&competition_kind=1" \
-H "x-api-key: $CRAWLORA_API_KEY"