FUSSBALL.DE API endpoint
Returns a page of one of the ten Top-Amateurstatistiken rankings (Kreisklasse to Regionalliga, championship matches): top teams by goals, goal ratio, goals against and points average, highest-scoring matches, biggest draws, and top scorers by goals, ratio and goals in one match per week or season. Filter by season, team type and federation and page with `limit` and `offset`. A ranking is bounded to roughly its top 200 entries; `final` marks the last page.
/fussballde/amateur-statsstat (string, required): Ranking id. Allowed values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10. Names: 1 Meiste Tore (Teams), 2 Beste Torquote (Teams), 3 Beste Gegentorquote (Teams), 4 Beste Teams (Punkteschnitt), 5 Torreichste Spiele, 6 Die höchsten Unentschieden, 7 Beste Torquote (Spieler), 8 Meiste Tore (Spieler), 9 Meiste Tore in einem Spiel (Spieler/Woche), 10 Meiste Tore in einem Spiel (Spieler/Saison).season (string, optional): Four-digit season code, 2627 for 2026/27; the site offers the current and previous season.team_type (string, optional): Team type id; omit for all. Allowed values: 1, 3, 6, 8, 4, 5, 7, 9. Names: 1 Herren, 3 A-Junioren, 6 B-Junioren, 8 C-Junioren, 4 Frauen, 5 A-Juniorinnen, 7 B-Juniorinnen, 9 C-Juniorinnen.federation_id (string, optional): Federation id; omit for all federations. Allowed values: 89, 32, 31, 66, 61, 02, 03, 34, 62, 23, 22, 01, 41, 43, 63, 64, 04, 33, 42, 65, 21, 35. Names: 89 Deutschland, 32 Baden, 31 Bayern, 66 Berlin, 61 Brandenburg, 02 Bremen, 03 Hamburg, 34 Hessen, 62 Mecklenburg-Vorpommern, 23 Mittelrhein, 22 Niederrhein, 01 Niedersachsen, 41 Rheinland, 43 Saarland, 63 Sachsen, 64 Sachsen-Anhalt, 04 Schleswig-Holstein, 33 Südbaden, 42 Südwest, 65 Thüringen, 21 Westfalen, 35 Württemberg.limit (integer, optional): Rows per call, 1 to 100, default 30.offset (integer, optional): Number of rows to skip, 0 to 1000, default 0.Standard envelope; data holds the result described above. Dates are ISO YYYY-MM-DD, times are local HH:MM. Rows carry team, player (person rankings) or home/away/result/match_id (match rankings 5 and 6) plus labelled values. Errors: 400 invalid parameter, 404 unknown id, 503 upstream failure.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| stat | string | Yes | Ranking id Allowed values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10. | 8 | |
| season | string | No | Four-digit season code, 2627 for 2026/27; the site offers the current and previous season | 2627 | |
| team_type | string | No | Team type id; omit for all Allowed values: 1, 3, 6, 8, 4, 5, 7, 9. | 1 | |
| federation_id | string | No | Federation id; omit for all federations Allowed values: 89, 32, 31, 66, 61, 02, 03, 34, 62, 23, 22, 01, 41, 43, 63, 64, 04, 33, 42, 65, 21, 35. | 21 | |
| limit | integer | No | Rows per call, 1 to 100, default 30 | 30 | |
| offset | integer | No | Number of rows to skip, 0 to 1000, default 0 | 0 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/fussballde/amateur-stats?stat=8&team_type=1&federation_id=89&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"count": 4,
"final": false,
"limit": 4,
"offset": 0,
"rows": [
{
"competition_id": "031FK2JIRS000004VS5489BTVUS470OH-G",
"league": "Kreisliga C",
"player": "Dominik Milaszewski",
"player_id": "00MC8O1DBC000000VV0AG85VVSMHI0R7",
"position": 1,
"team": {
"logo_url": "https://www.fussball.de/export.media/-/action/getLogo/format/0/id/22013064",
"name": "FC Besa Essen e.V.",
"team_id": "02TO8KUVP4000000VS5489BSVTNMVP4D",
"url": "https://www.fussball.de/mannschaft/fc-besa-essen-ev-besa-essen/-/saison/2627/team-id/02TO8KUVP4000000VS5489BSVTNMVP4D"
},
"team_type": "Herren",
"values": [
{
"label": "Spiele",
"value": "7"
},
{
"label": "Tore",
"value": "47"
}
]
},
{
"competition_id": "031BI0FKPC000004VS5489BUVUR5FS5A-G",
"league": "Kreisliga C",
"player": "Sven Igelbüscher",
"player_id": "00MC8BM36O000000VV0AG85VVSMHI0R7",
"position": 2,
"team": {
"logo_url": "https://www.fussball.de/export.media/-/action/getLogo/format/0/id/21120034",
"name": "VfB Kirchhellen 1920 III",
"team_id": "011MICL49S000000VTVG0001VTR8C1K7",
"url": "https://www.fussball.de/mannschaft/vfb-kirchhellen-1920-iii-vfb-kirchhellen-1920/-/saison/2627/team-id/011MICL49S000000VTVG0001VTR8C1K7"
},
"team_type": "Herren",
"values": [
{
"label": "Spiele",
"value": "9"
},
{
"label": "Tore",
"value": "44"
}
]
}
],
"season": "2627",
"stat": "8",
"stat_name": "Meiste Tore (Spieler)",
"team_type": "1"
}
}Request schema
No body schema
Response schema
#/definitions/fussballde.amateurStatsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | fussballde.AmateurStatsResponse | No | ||||
| data.count | integer | No | ||||
| data.federation_id | string | No | ||||
| data.final | boolean | No | false | |||
| data.limit | integer | No | ||||
| data.offset | integer | No | ||||
| data.rows | array | No | ||||
| data.rows[].away | fussballde.TeamRef | No | TeamRef record, 5 fields: club_id, logo_url, name, team_id, url. Described under FUSSBALL.DE Match API. | |||
| data.rows[].competition_id | string | No | ||||
| data.rows[].home | fussballde.TeamRef | No | TeamRef record, 5 fields: club_id, logo_url, name, team_id, url. Described under FUSSBALL.DE Match API. | |||
| data.rows[].league | string | No | Kreisliga C | |||
| data.rows[].match_id | string | No | ||||
| data.rows[].player | string | No | Dominik Milaszewski | |||
| data.rows[].player_id | string | No | ||||
| data.rows[].position | integer | No | ||||
| data.rows[].result | string | No | 0:30 | |||
| data.rows[].team | fussballde.TeamRef | No | TeamRef record, 5 fields: club_id, logo_url, name, team_id, url. Described under FUSSBALL.DE Match API. | |||
| data.rows[].team_type | string | No | Herren | |||
| data.rows[].values | array | No | ||||
| data.rows[].values[].label | string | No | Tore | |||
| data.rows[].values[].value | string | No | 47 | |||
| data.season | string | No | ||||
| data.stat | string | No | ||||
| data.stat_name | string | No | ||||
| data.team_type | 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/amateur-stats?stat=8&team_type=1&federation_id=89&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"