FUSSBALL.DE API endpoint
Returns a team's players for a season: the `squad` (appearances, minutes, goals), `arrivals` or `departures` with the columns the site publishes for each. Player names come in the site's `Surname, Forename` order.
/fussballde/team-squadteam_id (string, required): Team id, see fussballde-team.season (string, optional): Four-digit season code, default current season.kind (string, optional): Player list kind, default squad. Allowed values: squad, arrivals, departures.Standard envelope; data holds the result described above. Dates are ISO YYYY-MM-DD, times are local HH:MM. Scores, dates and names that FUSSBALL.DE serves as obfuscated glyphs are decoded server-side. Errors: 400 invalid parameter, 404 unknown id, 503 upstream failure.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| team_id | string | Yes | Team id, see fussballde-team | 011MI8V6UC000000VTVG0001VTR8C1K7 | |
| season | string | No | Four-digit season code, default current season | 2627 | |
| kind | string | No | Player list kind, default squad Allowed values: squad, arrivals, departures. | squad | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/fussballde/team-squad?team_id=011MI8V6UC000000VTVG0001VTR8C1K7&kind=squad" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"columns": [
"Spieler",
"Einsätze"
],
"count": 5,
"kind": "squad",
"players": [
{
"appearances": 6,
"cells": [
"6",
"540"
],
"goals": 0,
"minutes": 540,
"name": "Anton, Waldemar",
"player_id": "02205300QG000000VS541L4IVV1IV37M"
},
{
"appearances": 6,
"cells": [
"6",
"540"
],
"goals": 0,
"minutes": 540,
"name": "Kobel, Gregor",
"player_id": "022052VS0K000000VS541L4IVV1IV37M"
}
],
"season": "2627",
"team_id": "011MI8V6UC000000VTVG0001VTR8C1K7"
}
}Request schema
No body schema
Response schema
#/definitions/fussballde.teamSquadResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | fussballde.TeamSquadResponse | No | ||||
| data.columns | array | No | ||||
| data.count | integer | No | ||||
| data.kind | string | No | ||||
| data.players | array | No | ||||
| data.players[].appearances | integer | No | ||||
| data.players[].cells | array | No | ||||
| data.players[].goals | integer | No | ||||
| data.players[].minutes | integer | No | ||||
| data.players[].name | string | No | Anton, Waldemar | |||
| data.players[].player_id | string | No | ||||
| data.season | string | No | ||||
| data.team_id | 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/team-squad?team_id=011MI8V6UC000000VTVG0001VTR8C1K7&kind=squad" \
-H "x-api-key: $CRAWLORA_API_KEY"