FUSSBALL.DE API endpoint
Searches FUSSBALL.DE editorial news (`news`) or the Profi-Newsflash (`pro_news`) by keyword and returns teasers with title, category, date and excerpt. The first page (offset 0) also reports the total hit count; page with `limit` (1 to 50) and `offset`. No hits is a valid empty result.
/fussballde/news-searchq (string, required): Search text, 2 to 80 characters.channel (string, optional): News channel, default news. Allowed values: news, pro_news.limit (integer, optional): Articles per call, 1 to 50, default 10.offset (integer, optional): Number of hits to skip, 0 to 10000, 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 only (offset 0). Team news written by users is not included. Errors: 400 invalid parameter, 404 unknown id, 503 upstream failure.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| q | string | Yes | Search text, 2 to 80 characters | Dortmund | |
| channel | string | No | News channel, default news Allowed values: news, pro_news. | news | |
| limit | integer | No | Articles per call, 1 to 50, default 10 | 10 | |
| offset | integer | No | Number of hits to skip, 0 to 10000, default 0 | 0 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/fussballde/news-search?q=Dortmund&channel=news&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"channel": "news",
"count": 3,
"final": false,
"items": [
{
"category": "Magazin",
"date": "2026-10-22",
"excerpt": "100 Ausgaben von \"Der beste Tag\": Zum Jubiläum kam Bundestrainer Jürgen Klopp gemeinsam mit U 19-Trainer Hanno Balitsch und dessen \"Co\" Pascal Pellowski.",
"id": "10067512",
"time": "14:00",
"title": "\"Der beste Tag\": Bundestrainer Jürgen Klopp bringt Kinder zum Strahlen",
"url": "https://www.fussball.de/newsdetail/der-beste-tag-bundestrainer-juergen-klopp-bringt-kinder-zum-strahlen/-/article-id/10067512"
},
{
"category": "Magazin",
"date": "2026-09-29",
"excerpt": "Gewalt ist einer der Herausforderungen in Sport und Gesellschaft und war Thema einer Podiumsdiskussion der Daniel-Nivel-Stiftung im Deutschen Fußballmuseum.",
"id": "10067271",
"time": "21:25",
"title": "Podiumsdiskussion: Gewalt in Stadion und Gesellschaft",
"url": "https://www.fussball.de/newsdetail/gewalt-in-stadion-und-gesellschaft-podiumsdiskussion-im-deutschen-fussballmuseum/-/article-id/10067271"
}
],
"limit": 3,
"offset": 0,
"q": "Dortmund",
"total": 1974
}
}Request schema
No body schema
Response schema
#/definitions/fussballde.newsSearchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | fussballde.NewsSearchResponse | No | ||||
| data.channel | string | No | ||||
| data.count | integer | No | ||||
| data.final | boolean | No | false | |||
| data.items | array | No | NewsItem record, 7 fields: category, date, excerpt, id, time, title, url. Described under FUSSBALL.DE News API. | |||
| data.limit | integer | No | ||||
| data.offset | integer | No | ||||
| data.q | string | No | ||||
| data.total | integer | No | 1974 | |||
| 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/news-search?q=Dortmund&channel=news&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"