// Find players
Find players
Free key and every planMCP: find_players
Players by part of the name, with matches, goals and their last match.
GEThttps://api.handballapi.com/v1/players
Try itruns against the live API with your key
keyGet a free key
Kept in this browser and filled in on every docs page. A key made in your account appears here by itself.
Parameters4
| name | type | what it does | |
|---|---|---|---|
q | string | required | Part of the name, 3 characters or more |
per_page | integer | optional | Rows per page, 1 to 200 (100) |
page | integer | optional | Page number, from 1. Wins over cursor |
cursor | string | optional | The next_cursor from the previous answer |
Returns5 fields
| field | type | what it holds |
|---|---|---|
player_id | string | Our id for the player (pl_). Permanent. |
name | string | The name as published. |
matches | integer | Matches with a line for the player. |
goals | integer | Goals scored. |
last_match | date | The latest match held. |
Example answerGET /v1/players?q=hansen&per_page=3
2003 of 107 rows
{
"data": [
{
"player_id": "pl_s3m2w1xk",
"name": "Arvin Hansen",
"matches": 1,
"goals": 0,
"last_match": "2026-10-30"
},
{
"player_id": "pl_b12b3tqg",
"name": "Lena Hansen",
"matches": 1,
"goals": 3,
"last_match": "2026-10-30"
},
{
"player_id": "pl_3898443d",
"name": "Nadja Hansen",
"matches": 2,
"goals": 1,
"last_match": "2026-10-30"
}
],
"meta": {
"count": 3,
"next_cursor": "cDI",
"page": 1,
"per_page": 3,
"total": 107,
"total_pages": 36,
"next_page": 2,
"prev_page": null,
"took_ms": 53
}
}