// Top scorers
Top scorers
Results plan and upMCP: top_scorers
The leading scorers of a competition and season, from the player lines held, with matches, 7m goals and goals a match.
GEThttps://api.handballapi.com/v1/competitions/{id}/scorers
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.
Parameters3
| name | type | what it does | |
|---|---|---|---|
id | string | required | Competition id (cp_...) |
season | string | optional | Season, such as 2025/26 (the latest with results) |
limit | integer | optional | How many players, 1 to 200 (25) |
Returns9 fields
| field | type | what it holds |
|---|---|---|
rank | integer | Place in the list, from 1. |
player_id | string | Our id for the player (pl_). Permanent. |
name | string | The name as published. |
team_id | string | Our id for the team (tm_). Permanent. |
team | string | home or away. |
matches | integer | Matches with a line for the player. |
goals | integer | Goals scored. |
seven_m_goals | integer | 7m throws scored. |
goals_per_match | number | Goals divided by matches. |
Example answerGET /v1/competitions/cp_vdaq0xgv/scorers?season=2026%2F27
20025 of 25 rows
{
"data": [
{
"rank": 1,
"player_id": "pl_smwv0t96",
"name": "Mayra Funke",
"team_id": "tm_yxwkzkkn",
"team": "HSG Soest Damen",
"matches": 1,
"goals": 12,
"seven_m_goals": 0,
"goals_per_match": 12
},
{
"rank": 2,
"player_id": "pl_4stewt2m",
"name": "Jule Marie Pietzner",
"team_id": "tm_pd7mgxmj",
"team": "HSG HOHENLIMBURG II",
"matches": 2,
"goals": 12,
"seven_m_goals": 8,
"goals_per_match": 6
},
{
"rank": 3,
"player_id": "pl_zz49ahyt",
"name": "Anna Hering",
"team_id": "tm_vkcq92se",
"team": "SGH Unna Massen",
"matches": 2,
"goals": 11,
"seven_m_goals": 3,
"goals_per_match": 5.5
},
{
"rank": 4,
"player_id": "pl_6wc4bc9a",
"name": "Laura Janzen",
"team_id": "tm_m6y101yy",
"team": "SOESTER TV VON 1862 E.V.",
"matches": 1,
"goals": 10,
"seven_m_goals": 5,
"goals_per_match": 10
},
{
"rank": 5,
"player_id": "pl_dvw6zy4z",
"name": "Nele Stratenschulte",
"team_id": "tm_csfmmw96",
"team": "TV ARNSBERG 1861 E.V.",
"matches": 1,
"goals": 10,
"seven_m_goals": 0,
"goals_per_match": 10
},
{
"rank": 6,
"player_id": "pl_4da324ga",
"name": "Johanna Teresa Lohre",
"team_id": "tm_pd7mgxmj",
"team": "HSG HOHENLIMBURG II",
"matches": 2,
"goals": 10,
"seven_m_goals": 0,
"goals_per_match": 5
},
{
"rank": 7,
"player_id": "pl_e7thnkrp",
"name": "Marie Deventer",
"team_id": "tm_m32520sc",
"team": "Allgemeiner Sportverein Hamm-Westfalen e.V.",
"matches": 1,
"goals": 9,
"seven_m_goals": 0,
"goals_per_match": 9
},
{
"rank": 8,
"player_id": "pl_z9080ck7",
"name": "Michelle Lell",
"team_id": "tm_yxwkzkkn",
"team": "HSG Soest Damen",
"matches": 1,
"goals": 9,
"seven_m_goals": 0,
"goals_per_match": 9
},
{
"rank": 9,
"player_id": "pl_g76k6shy",
"name": "Nina Baier",
"team_id": "tm_vm7h9pbf",
"team": "LÜNER SV HANDBALL E.V. II",
"matches": 1,
"goals": 8,
"seven_m_goals": 3,
"goals_per_match": 8
},
{
"rank": 10,
"player_id": "pl_p8qz7xfm",
"name": "Pia Sandhof",
"team_id": "tm_vkcq92se",
"team": "SGH Unna Massen",
"matches": 2,
"goals": 8,
"seven_m_goals": 0,
"goals_per_match": 4
},
{
"rank": 11,
"player_id": "pl_a8c0k4t9",
"name": "Antonia Roewer",
"team_id": "tm_yxwkzkkn",
"team": "HSG Soest Damen",
"matches": 1,
"goals": 7,
"seven_m_goals": 0,
"goals_per_match": 7
},
{
"rank": 12,
"player_id": "pl_wbfwk4qq",
"name": "Ida Schindler",
"team_id": "tm_gggfcx9c",
"team": "VTV FREIER GRUND 2016 E.V.",
"matches": 1,
"goals": 7,
"seven_m_goals": 3,
"goals_per_match": 7
},
{
"rank": 13,
"player_id": "pl_67gmakn2",
"name": "Martha Wegemann",
"team_id": "tm_gpjswbwb",
"team": "TV WERNE 03 E.V.",
"matches": 1,
"goals": 7,
"seven_m_goals": 1,
"goals_per_match": 7
},
{
"rank": 14,
"player_id": "pl_6731xj3c",
"name": "Pauline Schmidt",
"team_id": "tm_vm7h9pbf",
"team": "LÜNER SV HANDBALL E.V. II",
"matches": 1,
"goals": 7,
"seven_m_goals": 0,
"goals_per_match": 7
},
{
"rank": 15,
"player_id": "pl_d1tp88ks",
"name": "Ayleen Beutel",
"team_id": "tm_m32520sc",
"team": "Allgemeiner Sportverein Hamm-Westfalen e.V.",
"matches": 1,
"goals": 6,
"seven_m_goals": 0,
"goals_per_match": 6
},
{
"rank": 16,
"player_id": "pl_0mynry3y",
"name": "Elena Schulte",
"team_id": "tm_csfmmw96",
"team": "TV ARNSBERG 1861 E.V.",
"matches": 1,
"goals": 6,
"seven_m_goals": 1,
"goals_per_match": 6
},
{
"rank": 17,
"player_id": "pl_cva4axbx",
"name": "Finja Klaas",
"team_id": "tm_vm7h9pbf",
"team": "LÜNER SV HANDBALL E.V. II",
"matches": 1,
"goals": 6,
"seven_m_goals": 0,
"goals_per_match": 6
},
{
"rank": 18,
"player_id": "pl_jz368yfq",
"name": "Hannah Kathrine Weber",
"team_id": "tm_gggfcx9c",
"team": "VTV FREIER GRUND 2016 E.V.",
"matches": 1,
"goals": 6,
"seven_m_goals": 3,
"goals_per_match": 6
},
{
"rank": 19,
"player_id": "pl_4dvcmymm",
"name": "Lena Boettcher",
"team_id": "tm_vkcq92se",
"team": "SGH Unna Massen",
"matches": 2,
"goals": 6,
"seven_m_goals": 3,
"goals_per_match": 3
},
{
"rank": 20,
"player_id": "pl_2vsbp0hb",
"name": "Lenja Stranegger",
"team_id": "tm_pd7mgxmj",
"team": "HSG HOHENLIMBURG II",
"matches": 2,
"goals": 6,
"seven_m_goals": 0,
"goals_per_match": 3
},
{
"rank": 21,
"player_id": "pl_wx9rj2p5",
"name": "Sophia Geuss",
"team_id": "tm_pd7mgxmj",
"team": "HSG HOHENLIMBURG II",
"matches": 2,
"goals": 6,
"seven_m_goals": 0,
"goals_per_match": 3
},
{
"rank": 22,
"player_id": "pl_pkzrd4n8",
"name": "Franziska Julie Willeke",
"team_id": "tm_csfmmw96",
"team": "TV ARNSBERG 1861 E.V.",
"matches": 1,
"goals": 5,
"seven_m_goals": 2,
"goals_per_match": 5
},
{
"rank": 23,
"player_id": "pl_85za4jyf",
"name": "Lilith Kramer",
"team_id": "tm_m6y101yy",
"team": "SOESTER TV VON 1862 E.V.",
"matches": 1,
"goals": 5,
"seven_m_goals": 0,
"goals_per_match": 5
},
{
"rank": 24,
"player_id": "pl_53e2f3am",
"name": "Nele Schuetz",
"team_id": "tm_gggfcx9c",
"team": "VTV FREIER GRUND 2016 E.V.",
"matches": 1,
"goals": 5,
"seven_m_goals": 0,
"goals_per_match": 5
},
{
"rank": 25,
"player_id": "pl_k4hvh3ad",
"name": "Lotte Karolina Bergsen",
"team_id": "tm_vkcq92se",
"team": "SGH Unna Massen",
"matches": 2,
"goals": 5,
"seven_m_goals": 0,
"goals_per_match": 2.5
}
],
"meta": {
"competition": {
"id": "cp_vdaq0xgv",
"name": "Verbandsliga WEIBLICH, HVW Frauen Verbandsliga Staffel 3",
"season": "2026/27"
},
"players": 133,
"count": 25,
"took_ms": 8
}
}