FUSSBALL.DE API endpoint
Searches FUSSBALL.DE clubs by club name, postcode or place, or both (both must match), and returns each club's id, name, postal code, city and logo. The first page reports the `total` hit count; page with `limit` (1 to 100, default 20) and `offset`, and `final` marks the last page. Zero results is a valid response.
/fussballde/club-searchtext (string, optional): Club name or part of it; text or place is required.place (string, optional): Postcode or place name; text or place is required.limit (integer, optional): Clubs per call, 1 to 100, default 20.offset (integer, optional): Number of clubs to skip, 0 to 2000, default 0.Standard envelope; data holds the result described above. Dates are ISO YYYY-MM-DD, times are local HH:MM. total is returned for the first page and is the number of matching clubs; the club search shows more than 20 hits only by paging. Errors: 400 invalid parameter, 404 unknown id, 503 upstream failure.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| text | string | No | Club name or part of it; text or place is required | Dortmund | |
| place | string | No | Postcode or place name; text or place is required | 44139 | |
| limit | integer | No | Clubs per call, 1 to 100, default 20 | 20 | |
| offset | integer | No | Number of clubs to skip, 0 to 2000, default 0 | 0 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/fussballde/club-search?limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"clubs": [
{
"city": "Dortmund",
"club_id": "00ES8GN8N400008DVV0AG08LVUPGND5I",
"logo_url": "https://www.fussball.de/export.media/-/action/getLogo/format/7/id/00ES8GN8N400008DVV0AG08LVUPGND5I",
"name": "ASC 09 Dortmund",
"postal_code": "44287",
"url": "https://www.fussball.de/verein/asc-09-dortmund-westfalen/-/id/00ES8GN8N400008DVV0AG08LVUPGND5I"
},
{
"city": "Dortmund",
"club_id": "00ES8GN8N400008VVV0AG08LVUPGND5I",
"logo_url": "https://www.fussball.de/export.media/-/action/getLogo/format/7/id/00ES8GN8N400008VVV0AG08LVUPGND5I",
"name": "Borussia Dortmund",
"postal_code": "44139",
"url": "https://www.fussball.de/verein/borussia-dortmund-westfalen/-/id/00ES8GN8N400008VVV0AG08LVUPGND5I"
}
],
"count": 4,
"final": false,
"limit": 3,
"offset": 0,
"text": "Dortmund",
"total": 102
}
}Request schema
No body schema
Response schema
#/definitions/fussballde.clubSearchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | fussballde.ClubSearchResponse | No | ||||
| data.clubs | array | No | ||||
| data.clubs[].city | string | No | Dortmund | |||
| data.clubs[].club_id | string | No | 00ES8GN8N400008VVV0AG08LVUPGND5I | |||
| data.clubs[].logo_url | string | No | ||||
| data.clubs[].name | string | No | Borussia Dortmund | |||
| data.clubs[].postal_code | string | No | 44139 | |||
| data.clubs[].url | string | No | ||||
| data.count | integer | No | ||||
| data.final | boolean | No | false | |||
| data.limit | integer | No | ||||
| data.offset | integer | No | ||||
| data.place | string | No | ||||
| data.text | string | No | ||||
| data.total | integer | No | 102 | |||
| 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-search?limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"