GET Topscorers by Season ID

GET Topscorers by season ID
1
https://soccer.sportmonks.com/api/v2.0/topscorers/season/{ID}
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
goalscorers.player.team cardscorers.player.team assistscorers.player.team goalscorers.team cardscorers.team assistscorers.team goalscorers.player cardscorers.player assistscorers.player

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:
Includes
Example response
Request
Response
Field Description
1
https://soccer.sportmonks.com/api/v2.0/topscorers/season/17141?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
        "goalscorers": {
9
            "data": [
10
                {
11
                    "position": 1,
12
                    "season_id": 17141,
13
                    "player_id": 1836,
14
                    "team_id": 180,
15
                    "stage_id": 77447500,
16
                    "goals": 5,
17
                    "penalty_goals": 1,
18
                    "type": "goals"
19
                },
20
                {
21
                    "position": 1,
22
                    "season_id": 17141,
23
                    "player_id": 96792,
24
                    "team_id": 53,
25
                    "stage_id": 77447501,
26
                    "goals": 16,
27
                    "penalty_goals": 5,
28
                    "type": "goals"
29
                },
30
                {
31
                    "position": 2,
32
                    "season_id": 17141,
33
                    "player_id": 4561,
34
                    "team_id": 62,
35
                    "stage_id": 77447500,
36
                    "goals": 4,
37
                    "penalty_goals": 0,
38
                    "type": "goals"
39
                },
40
                {
41
                    "position": 2,
42
                    "season_id": 17141,
43
                    "player_id": 173059,
44
                    "team_id": 66,
45
                    "stage_id": 77447501,
46
                    "goals": 12,
47
                    "penalty_goals": 2,
48
                    "type": "goals"
49
                },
50
                {
51
                    "position": 3,
52
                    "season_id": 17141,
53
                    "player_id": 8934,
54
                    "team_id": 309,
55
                    "stage_id": 77447500,
56
                    "goals": 3,
57
                    "penalty_goals": 0,
58
                    "type": "goals"
59
                },
60
                {
61
                    "position": 3,
62
                    "season_id": 17141,
63
                    "player_id": 172795,
64
                    "team_id": 66,
65
                    "stage_id": 77447501,
66
                    "goals": 11,
67
                    "penalty_goals": 4,
68
                    "type": "goals"
69
                },
70
                {
71
                    "position": 4,
72
                    "season_id": 17141,
73
                    "player_id": 121792,
74
                    "team_id": 496,
75
                    "stage_id": 77447500,
76
                    "goals": 3,
77
                    "penalty_goals": 1,
78
                    "type": "goals"
79
                },
80
                {
81
                    "position": 4,
82
                    "season_id": 17141,
83
                    "player_id": 92276,
84
                    "team_id": 62,
85
                    "stage_id": 77447501,
86
                    "goals": 11,
87
                    "penalty_goals": 0,
88
                    "type": "goals"
89
                },
90
                {
91
                    "position": 5,
92
                    "season_id": 17141,
93
                    "player_id": 12314,
94
                    "team_id": 180,
95
                    "stage_id": 77447500,
96
                    "goals": 3,
97
                    "penalty_goals": 0,
98
                    "type": "goals"
99
                },
Copied!
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
​
Check this endpoint in Postman.
                                                              ​
​​

Endpoint overview - Previous

Topscorers

GET Topscorers Aggregated by Season ID

Last modified 9mo ago

Export as PDF

Copy link

Contents

GET Topscorers by season ID