FUSSBALL.DE API endpoint
Returns news teasers of one FUSSBALL.DE stream (all news, magazine, Regionalliga, federations, service, campaigns or help center) with title, category, publication date and time, and excerpt, paged with `limit` (1 to 50, default 10) and `offset`; `final` is true on the last page. Use `regional_league` or `help_category` to narrow the Regionalliga and help-center streams to one league or category. Use the article id with `fussballde-news-article` for the full text.
/fussballde/newsstream (string, optional): News stream, default all_news. Allowed values: all_news, magazin, regionalliga, verbaende, service, aktionen, helpcenter.regional_league (string, optional): Only Regionalliga news of one league (implies stream regionalliga). Allowed values: nord, nordost, west, suedwest, bayern.help_category (string, optional): Only help-center articles of one category (implies stream helpcenter). Allowed values: allgemeines, app, liveticker, mannschaftsseite, profile, registrierung, training_service, widgets.limit (integer, optional): Articles per call, 1 to 50, default 10.offset (integer, optional): Number of articles to skip, 0 to 5000, default 0.Standard envelope; data holds the result described above. Dates are ISO YYYY-MM-DD, times are local HH:MM. Only the Regionalliga and help-center streams have sub-filters that work without a session; the federation (Verbände) filter on the site ignores its value, so federation news is available through fussballde-federation instead. Errors: 400 invalid parameter, 404 unknown id, 503 upstream failure.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| stream | string | No | News stream, default all_news Allowed values: all_news, magazin, regionalliga, verbaende, service, aktionen, helpcenter. | all_news | |
| regional_league | string | No | Only Regionalliga news of one league (implies stream regionalliga) Allowed values: nord, nordost, west, suedwest, bayern. | nord | |
| help_category | string | No | Only help-center articles of one category (implies stream helpcenter) Allowed values: allgemeines, app, liveticker, mannschaftsseite, profile, registrierung, training_service, widgets. | app | |
| limit | integer | No | Articles per call, 1 to 50, default 10 | 10 | |
| offset | integer | No | Number of articles to skip, 0 to 5000, default 0 | 0 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/fussballde/news?stream=all_news®ional_league=nord&help_category=allgemeines&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"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-10-22",
"excerpt": "Sophie Hagedorn erzielte für den VfB Lübeck in sechs Spielen in der Kreisliga Süd in Schleswig-Holstein 29 Treffer. Im FUSSBALL.DE-Interview spricht sie über ihren Torhunger.",
"id": "10067511",
"time": "12:00",
"title": "VfB-Torjägerin Sophie Hagedorn: \"Will mit Lübeck hoch in die Oberliga\"",
"url": "https://www.fussball.de/newsdetail/vfb-torjaegerin-sophie-hagedorn-will-mit-luebeck-hoch-in-die-oberliga/-/article-id/10067511"
}
],
"limit": 3,
"offset": 0,
"stream": "all_news"
}
}Request schema
No body schema
Response schema
#/definitions/fussballde.newsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | fussballde.NewsResponse | No | ||||
| data.count | integer | No | ||||
| data.final | boolean | No | false | |||
| data.items | array | No | ||||
| data.items[].category | string | No | Magazin | |||
| data.items[].date | string | No | 2026-10-22 | |||
| data.items[].excerpt | string | No | ||||
| data.items[].id | string | No | 10067512 | |||
| data.items[].time | string | No | 14:00 | |||
| data.items[].title | string | No | ||||
| data.items[].url | string | No | ||||
| data.limit | integer | No | ||||
| data.offset | integer | No | ||||
| data.stream | 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/news?stream=all_news®ional_league=nord&help_category=allgemeines&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"