Getting Started
Endpoint overview
Tutorials
Tools
How-to Guides
API References
General
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.
GET Topscorers Aggregated by season ID
GET Topscorers Aggregated by season ID1
https://soccer.sportmonks.com/api/v2.0/topscorers/season/{ID}/aggregated
Copied!
Endpoint details
​
Authorization
API Key
Pagination
NO
Allowed nested includes
3
Parameters
Available parameters
​
include
Enrich the API with more data and/or nested includes. Can be used by adding
&include= etc to your request url. Include options
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:
Example response
Request
Response
Field Description
1
https://soccer.sportmonks.com/api/v2.0/topscorers/season/17141/aggregated?api_token={API_TOKEN}
Copied!
1
"data": {
2
"id": 17141,
3
"name": "2020/2021",
4
"league_id": 501,
5
"is_current_season": false,
6
"current_round_id": null,
7
"current_stage_id": null,
8
"aggregatedGoalscorers": {
9
"data": [
10
{
11
"position": 1,
12
"season_id": 17141,
13
"player_id": 96792,
14
"team_id": 53,
15
"stage_id": null,
16
"goals": 18,
17
"penalty_goals": 5,
18
"type": "aggregated_goals"
19
},
20
{
21
"position": 2,
22
"season_id": 17141,
23
"player_id": 173059,
24
"team_id": 66,
25
"stage_id": null,
26
"goals": 14,
27
"penalty_goals": 2,
28
"type": "aggregated_goals"
29
},
30
{
31
"position": 3,
32
"season_id": 17141,
33
"player_id": 4561,
34
"team_id": 62,
35
"stage_id": null,
36
"goals": 14,
37
"penalty_goals": 0,
38
"type": "aggregated_goals"
39
},
40
{
41
"position": 4,
42
"season_id": 17141,
43
"player_id": 172795,
44
"team_id": 66,
45
"stage_id": null,
46
"goals": 12,
47
"penalty_goals": 5,
48
"type": "aggregated_goals"
49
},
50
{
51
"position": 5,
52
"season_id": 17141,
53
"player_id": 92276,
54
"team_id": 62,
55
"stage_id": null,
56
"goals": 12,
57
"penalty_goals": 0,
58
"type": "aggregated_goals"
59
},
60
{
61
"position": 6,
62
"season_id": 17141,
63
"player_id": 758,
64
"team_id": 62,
65
"stage_id": null,
66
"goals": 12,
67
"penalty_goals": 7,
68
"type": "aggregated_goals"
69
},
70
{
71
"position": 7,
72
"season_id": 17141,
73
"player_id": 8934,
74
"team_id": 309,
75
"stage_id": null,
76
"goals": 11,
77
"penalty_goals": 1,
78
"type": "aggregated_goals"
79
},
80
{
81
"position": 8,
82
"season_id": 17141,
83
"player_id": 150759,
84
"team_id": 53,
85
"stage_id": null,
86
"goals": 10,
87
"penalty_goals": 0,
88
"type": "aggregated_goals"
89
},
90
{
91
"position": 9,
92
"season_id": 17141,
93
"player_id": 3387,
94
"team_id": 62,
95
"stage_id": null,
96
"goals": 10,
97
"penalty_goals": 0,
98
"type": "aggregated_goals"
99
},
Copied!
Season Field Description
Field
Description
idThe unique id of the current stage
nameThe name of the stage
league_idThe unique league id the stage belongs to
season_idThe unique id of the current season
round_idThe unique id of the current round
round_nameThe name of the round
typeIndicates what kind of type this stage is
stage_idThe unique id of the current stage
stage_nameThe name of the stage
Topscorers Field Description
Field
Description
positionThe actual position in the rankings in the stage
player_idThe unique player id of the player in that position in the stage
team_idThe unique id of the the player plays for
stage_idThe unique id of the current stage
goalsThe total number of goals the player has scored in the stage
penalty_goalsThe total number of penalty goals the player has scored in the stage
typeThe type of the standings. Possible values are: goals, cards or assists
Last modified 9mo ago
Export as PDF
Copy link