FUSSBALL.DE API endpoint
Returns a player's public profile: name, team, team type, birth date and, for registered players (`profile_type` full), the current-season statistics such as appearances, minutes played, goals, goals against and cards. Players without a registered profile (`profile_type` basic) only have name, team and team type. Player ids come from `fussballde-player-search`, scorer lists, squads and amateur statistics.
/fussballde/playerplayer_id (string, required): Player id from fussballde-player-search, fussballde-top-scorers, fussballde-team-squad or fussballde-amateur-stats.Standard envelope; data holds the result described above. Dates are ISO YYYY-MM-DD. profile_type is full for registered players (statistics included) and basic for players that only appear through their team. Both id forms used by the site (userid and player-id) are accepted and resolved automatically, including legacy ids such as I.247287.-----. Errors: 400 invalid parameter, 404 unknown id, 503 upstream failure.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| player_id | string | Yes | Player id from fussballde-player-search, fussballde-top-scorers, fussballde-team-squad or fussballde-amateur-stats | 01MH0AKR7C000007VV0AG13EVSFDFGE6 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/fussballde/player?player_id=01MH0AKR7C000007VV0AG13EVSFDFGE6" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"birth_date": "1993-02-09",
"facts": [
{
"label": "Mannschaftsart",
"value": "Herren"
},
{
"label": "Geburtsdatum",
"value": "09.02.1993"
}
],
"name": "Niclas Füllkrug",
"player_id": "01MH0AKR7C000007VV0AG13EVSFDFGE6",
"profile_type": "full",
"stats": [
{
"label": "Einsätze",
"value": "6"
},
{
"label": "Gespielte Minuten",
"value": "486"
}
],
"stats_season": "26/27",
"team": "SV Werder Bremen",
"team_id": "011MIC0IEC000000VTVG0001VTR8C1K7",
"team_type": "Herren",
"url": "http://127.0.0.1:64285/spielerprofil/-/userid/01MH0AKR7C000007VV0AG13EVSFDFGE6"
}
}Request schema
No body schema
Response schema
#/definitions/fussballde.playerResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | fussballde.PlayerDetail | No | ||||
| data.birth_date | string | No | 1993-02-09 | |||
| data.facts | array | No | ||||
| data.facts[].label | string | No | Gründungsjahr | |||
| data.facts[].url | string | No | ||||
| data.facts[].value | string | No | 1909 | |||
| data.name | string | No | Niclas Füllkrug | |||
| data.player_id | string | No | ||||
| data.profile_type | string | No | full | |||
| data.stats | array | No | ||||
| data.stats[].label | string | No | Tore | |||
| data.stats[].value | string | No | 6 | |||
| data.stats_season | string | No | 26/27 | |||
| data.team | string | No | SV Werder Bremen | |||
| data.team_id | string | No | ||||
| data.team_type | string | No | Herren | |||
| data.url | 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/player?player_id=01MH0AKR7C000007VV0AG13EVSFDFGE6" \
-H "x-api-key: $CRAWLORA_API_KEY"