FUSSBALL.DE API endpoint
Returns a page of a competition's top-scorer list with position, player, team and goals; page through it with `limit` (1 to 100, default 30) and `offset`. Tied scorers share a position. A competition without recorded scorers returns an empty list.
/fussballde/top-scorerscompetition_id (string, required): Competition id from fussballde-competitions.limit (integer, optional): Scorers per call, 1 to 100, default 30.offset (integer, optional): Number of scorers 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. Tied scorers share a position, so positions can repeat across pages. final is true on the last page. Errors: 400 invalid parameter, 404 unknown id, 503 upstream failure.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| competition_id | string | Yes | Competition id from fussballde-competitions | 031BFREJC800001BVS5489BUVUR5FS5A-G | |
| limit | integer | No | Scorers per call, 1 to 100, default 30 | 30 | |
| offset | integer | No | Number of scorers 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/top-scorers?competition_id=031BFREJC800001BVS5489BUVUR5FS5A-G&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"competition_id": "031BFREJC800001BVS5489BUVUR5FS5A-G",
"count": 5,
"final": false,
"limit": 5,
"offset": 0,
"scorers": [
{
"goals": 6,
"name": "Niclas Füllkrug",
"player_id": "01MH0AKR7C000007VV0AG13EVSFDFGE6",
"position": 1,
"team": {
"club_id": "00ES8GN8I400001CVV0AG08LVUPGND5I",
"logo_url": "https://www.fussball.de/export.media/-/action/getLogo/format/0/id/00ES8GN8I400001CVV0AG08LVUPGND5I/verband/0123456789ABCDEF0123456700004010",
"name": "SV Werder Bremen",
"team_id": "011MIC0IEC000000VTVG0001VTR8C1K7",
"url": "https://www.fussball.de/mannschaft/sv-werder-bremen-werder-bremen-bremen/-/saison/2627/team-id/011MIC0IEC000000VTVG0001VTR8C1K7"
}
},
{
"goals": 6,
"name": "Patrik Schick",
"player_id": "0288LBM6R4000000VS541L4JVT0TU094",
"position": 1,
"team": {
"club_id": "00ES8GN914000035VV0AG08LVUPGND5I",
"logo_url": "https://www.fussball.de/export.media/-/action/getLogo/format/0/id/00ES8GN914000035VV0AG08LVUPGND5I/verband/0123456789ABCDEF0123456700004010",
"name": "Bayer 04 Leverkusen",
"team_id": "011MICQNT4000000VTVG0001VTR8C1K7",
"url": "https://www.fussball.de/mannschaft/bayer-04-leverkusen-bayer-04-leverkusen-mittelrhein/-/saison/2627/team-id/011MICQNT4000000VTVG0001VTR8C1K7"
}
}
],
"title": "Torjäger Bundesliga - Deutschland - Herren"
}
}Request schema
No body schema
Response schema
#/definitions/fussballde.topScorersResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | fussballde.TopScorersResponse | No | ||||
| data.competition_id | string | No | ||||
| data.count | integer | No | ||||
| data.final | boolean | No | false | |||
| data.limit | integer | No | ||||
| data.offset | integer | No | ||||
| data.scorers | array | No | ||||
| data.scorers[].goals | integer | No | ||||
| data.scorers[].name | string | No | Niclas Füllkrug | |||
| data.scorers[].player_id | string | No | ||||
| data.scorers[].position | integer | No | ||||
| data.scorers[].team | fussballde.TeamRef | No | TeamRef record, 5 fields: club_id, logo_url, name, team_id, url. Described under FUSSBALL.DE Match API. | |||
| data.title | 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/top-scorers?competition_id=031BFREJC800001BVS5489BUVUR5FS5A-G&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"