Getting Started
Endpoint overview
Tutorials
Tools
How-to Guides
API References
General
Topscorer standings
Step 1: Gather the tools
You are going to need the following tools:
- Sportmonks' API token
- Code editor (Visual studio used in examples)
- Postman (optional)
You can find a link to another article where we discuss the tools in-depth on our Developer Tools Guide.​
Step 2: Determine the league and season
What league and specifically what season interests you? For this guide, we’ll go with the 20/21 season of the Scottish Premiership (league id: 501, season id: 17141).
Step 3: Choose the correct endpoint
1
https://soccer.sportmonks.com/api/v2.0/topscorers/season/17141?api_token={API_TOKEN}
Copied!
However, we will slightly modify the request because we want the player and team names and not just their player id. We can do this for all three top scorers, which are:
- Goalscorers → players who have scored a goal
- Assistscorers → players who gave assists
- Cardscorers → players who have received yellow or red cards
We then plug the nested includes
goalscorers.playerandgoalscorers.teamto the request. So we could for example request everything:1
https://soccer.sportmonks.com/api/v2.0/topscorers/season/17141?api_token={API_TOKEN}&include=goalscorers.player,goalscorers.team,assistscorers.player,assistscorers.team,cardscorers.player,cardscorers.team
Copied!
It’s up to you how much data you want to receive. For our example, we are only interested in the goal-scoring top scorers. So we’ll use this URL:
1
https://soccer.sportmonks.com/api/v2.0/topscorers/season/17141?api_token={API_TOKEN}&include=goalscorers.player,goalscorers.team
Copied!
Step 4: Analyze the response
1
"position": 1,
2
"season_id": 17141,
3
"player_id": 173059,
4
"team_id": 66,
5
"stage_id": 77447501,
6
"goals": 6,
7
"penalty_goals": 1,
8
"type": "goals",
9
"player": {
10
"data": {
11
"player_id": 173059,
12
"team_id": 66,
13
"country_id": 1161,
14
"position_id": 4,
15
"common_name": "K. Nisbet",
16
"display_name": "Kevin Nisbet",
17
"fullname": "Kevin Nisbet",
18
"firstname": "Kevin",
19
"lastname": "Nisbet",
20
"nationality": "Scotland",
21
"birthdate": "08/03/1997",
22
"birthcountry": "Scotland",
23
"birthplace": "Glasgow",
24
"height": "180 cm",
25
"weight": null,
26
"image_path": "https://cdn.sportmonks.com/images/soccer/placeholder.png"
27
}
28
},
29
"team": {
30
"data": {
31
"id": 66,
32
"legacy_id": 702,
33
"name": "Hibernian",
34
"short_code": "HIB",
35
"twitter": "@HibernianFC",
36
"country_id": 1161,
37
"national_team": false,
38
"founded": 1875,
39
"logo_path": "https://cdn.sportmonks.com/images//soccer/teams/2/66.png",
40
"venue_id": 8946,
41
"current_season_id": 17141
Copied!
We can see that the Scottish Premiership’s top scorer is Kevin Nisbet from Hibernian with six goals including one penalty goal.
Last modified 8mo ago