Endpoint Playground
Searches players registered on FUSSBALL.DE by first and/or last name, optionally narrowed by postcode or place, and returns each player's id, name, birth date, team and team type. The first page reports the `total` hit count; page with `limit` (1 to 100, default 20) and `offset`, and `final` marks the last page. At least one of `first_name` and `last_name` is required. No match is a valid empty result.
curl 'https://api.crawlora.net/api/v1/fussballde/player-search' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| first_name | string | No | First name; first_name or last_name is required | |
| last_name | string | No | Last name; first_name or last_name is required | |
| place | string | No | Postcode or place name to narrow the result; cannot be used alone | |
| limit | integer | No | Players per call, 1 to 100, default 20 | |
| offset | integer | No | Number of players to skip, 0 to 2000, default 0 |
{
"code": 200,
"msg": "OK",
"data": {
"count": 5,
"final": false,
"first_name": "Niclas",
"last_name": "Füllkrug",
"limit": 5,
"offset": 0,
"players": [
{
"birth_date": "2010-06-21",
"name": "Adrian Magnus Müller",
"player_id": "02LMEUHP24000000VUM1DNQBVU8JGK40",
"team": "FC Rot-Weiss Koblenz",
"team_type": "B-Junioren",
"url": "https://www.fussball.de/spielerprofil/-/userid/02LMEUHP24000000VUM1DNQBVU8JGK40"
},
{
"birth_date": "2004-11-01",
"name": "Aileen Müller",
"player_id": "02MHEKPM4S000000VUM1DNOCVTAAE1T0",
"team": "SV Nienhagen",
"team_type": "Frauen",
"url": "https://www.fussball.de/spielerprofil/-/userid/02MHEKPM4S000000VUM1DNOCVTAAE1T0"
}
],
"total": 1
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.