FUSSBALL.DE API endpoint
Returns the German postcodes (with city and district) that FUSSBALL.DE's own location search suggests for a place name or postcode prefix. Use it to turn a place such as Dortmund into the five-digit `postal_code` that `fussballde-match-calendar` requires. No match is a valid empty list.
/fussballde/postal-codesq (string, required): Place name or postcode prefix, 2 to 40 characters.Standard envelope; data holds the result described above. Dates are ISO YYYY-MM-DD, times are local HH:MM. Errors: 400 invalid parameter, 404 unknown id, 503 upstream failure.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| q | string | Yes | Place name or postcode prefix, 2 to 40 characters | Dortmund | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/fussballde/postal-codes?q=Dortmund" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"count": 6,
"postal_codes": [
{
"city": "Dortmund",
"district": "Mitte",
"postal_code": "44135"
},
{
"city": "Dortmund",
"district": "Mitte",
"postal_code": "44137"
}
],
"q": "Dortmund"
}
}Request schema
No body schema
Response schema
#/definitions/fussballde.postalCodesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | fussballde.PostalCodesResponse | No | ||||
| data.count | integer | No | ||||
| data.postal_codes | array | No | ||||
| data.postal_codes[].city | string | No | Dortmund | |||
| data.postal_codes[].district | string | No | Mitte | |||
| data.postal_codes[].postal_code | string | No | 44139 | |||
| data.q | 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/postal-codes?q=Dortmund" \
-H "x-api-key: $CRAWLORA_API_KEY"