GET Topscorers Aggregated by Season ID
This Topscorers endpoint returns the Aggregated Topscorers by Season. This means that all stages are summed, also preliminary stages.
https://soccer.sportmonks.com/api/v2.0/topscorers/season/{ID}/aggregated
Endpoint details | |
Authorization | API Key |
Pagination | NO |
Allowed nested includes | 3 |
Available parameters | |
include | Enrich the API with more data and/or nested includes. Can be used by adding &include= etc to your request url. |
aggregatedGoalscorers.player aggregatedGoalscorers.player.team aggregatedCardscorers.player aggregatedCardscorers.player.team aggregatedAssistscorers.player aggregatedAssistscorers.player.team aggregatedGoalscorers.team aggregatedCardscorers.team aggregatedAssistscorers.team
Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.
You can learn more about what includes are and how they work here:
Request
Response
Field Description
https://soccer.sportmonks.com/api/v2.0/topscorers/season/17141/aggregated?api_token={API_TOKEN}
"data": {
"id": 17141,
"name": "2020/2021",
"league_id": 501,
"is_current_season": false,
"current_round_id": null,
"current_stage_id": null,
"aggregatedGoalscorers": {
"data": [
{
"position": 1,
"season_id": 17141,
"player_id": 96792,
"team_id": 53,
"stage_id": null,
"goals": 18,
"penalty_goals": 5,
"type": "aggregated_goals"
},
{
"position": 2,
"season_id": 17141,
"player_id": 173059,
"team_id": 66,
"stage_id": null,
"goals": 14,
"penalty_goals": 2,
"type": "aggregated_goals"
},
{
"position": 3,
"season_id": 17141,
"player_id": 4561,
"team_id": 62,
"stage_id": null,
"goals": 14,
"penalty_goals": 0,
"type": "aggregated_goals"
},
{
"position": 4,
"season_id": 17141,
"player_id": 172795,
"team_id": 66,
"stage_id": null,
"goals": 12,
"penalty_goals": 5,
"type": "aggregated_goals"
},
{
"position": 5,
"season_id": 17141,
"player_id": 92276,
"team_id": 62,
"stage_id": null,
"goals": 12,
"penalty_goals": 0,
"type": "aggregated_goals"
},
{
"position": 6,
"season_id": 17141,
"player_id": 758,
"team_id": 62,
"stage_id": null,
"goals": 12,
"penalty_goals": 7,
"type": "aggregated_goals"
},
{
"position": 7,
"season_id": 17141,
"player_id": 8934,
"team_id": 309,
"stage_id": null,
"goals": 11,
"penalty_goals": 1,
"type": "aggregated_goals"
},
{
"position": 8,
"season_id": 17141,
"player_id": 150759,
"team_id": 53,
"stage_id": null,
"goals": 10,
"penalty_goals": 0,
"type": "aggregated_goals"
},
{
"position": 9,
"season_id": 17141,
"player_id": 3387,
"team_id": 62,
"stage_id": null,
"goals": 10,
"penalty_goals": 0,
"type": "aggregated_goals"
},
Season Field Description
Field | Description |
id | The unique id of the current stage |
name | The name of the stage |
league_id | The unique league id the stage belongs to |
season_id | The unique id of the current season |
round_id | The unique id of the current round |
round_name | The name of the round |
type | Indicates what kind of type this stage is |
stage_id | The unique id of the current stage |
stage_name | The name of the stage |
Topscorers Field Description
Field | Description |
position | The actual position in the rankings in the stage |
player_id | The unique player id of the player in that position in the stage |
team_id | The unique id of the the player plays for |
stage_id | The unique id of the current stage |
goals | The total number of goals the player has scored in the stage |
penalty_goals | The total number of penalty goals the player has scored in the stage |
type | The type of the standings. Possible values are: goals, cards or assists |
Last modified 1yr ago