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
Requesting top scorers can be done with the endpoint: get topscorers by season id.​
https://soccer.sportmonks.com/api/v2.0/topscorers/season/17141?api_token={API_TOKEN}
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 includesgoalscorers.playerandgoalscorers.teamto the request. So we could for example request everything:
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
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:
https://soccer.sportmonks.com/api/v2.0/topscorers/season/17141?api_token={API_TOKEN}&include=goalscorers.player,goalscorers.team
Step 4: Analyze the response
"position": 1,
                    "season_id": 17141,
                    "player_id": 173059,
                    "team_id": 66,
                    "stage_id": 77447501,
                    "goals": 6,
                    "penalty_goals": 1,
                    "type": "goals",
                    "player": {
                        "data": {
                            "player_id": 173059,
                            "team_id": 66,
                            "country_id": 1161,
                            "position_id": 4,
                            "common_name": "K. Nisbet",
                            "display_name": "Kevin Nisbet",
                            "fullname": "Kevin Nisbet",
                            "firstname": "Kevin",
                            "lastname": "Nisbet",
                            "nationality": "Scotland",
                            "birthdate": "08/03/1997",
                            "birthcountry": "Scotland",
                            "birthplace": "Glasgow",
                            "height": "180 cm",
                            "weight": null,
                            "image_path": "https://cdn.sportmonks.com/images/soccer/placeholder.png"
                        }
},
                    "team": {
                        "data": {
                            "id": 66,
                            "legacy_id": 702,
                            "name": "Hibernian",
                            "short_code": "HIB",
                            "twitter": "@HibernianFC",
                            "country_id": 1161,
                            "national_team": false,
                            "founded": 1875,
                            "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/2/66.png",
                            "venue_id": 8946,
                            "current_season_id": 17141
We can see that the Scottish Premiership’s top scorer is Kevin Nisbet from Hibernian with six goals including one penalty goal.
For more detailed information you can head to our leagues & topscorers tutorial.
League & topscorers standings

League standings

Next - How-to Guides

Odds & predictions

Last modified 1yr ago

Export as PDF

Copy link

Outline

Step 1: Gather the tools

Step 2: Determine the league and season

Step 3: Choose the correct endpoint

Step 4: Analyze the response