Topscorer standings

Retrieve accurate information about the goals, assist and card topscorers. The topscorers endpoints return the top 25 players. You can request the topscorers in total or by type: Goals, Cards or Assists.

You can choose a variety of endpoints to retrieve the topscorer standings.

This section will briefly discuss all the options available to request topscorer standings.

An overview of all available options:

• GET Topscorers by Stage ID: return all the topscorers of the requested stage.

• GET Topscorers by Season ID: returns all the topscorers per stage of the requested season.

For all the topscorer endpoints the base URL is the same:

https://api.sportmonks.com/v3/football/topscorers

Per endpoint the rest of the URL requires additional information. We will explain this per endpoint.

Requesting topscorer standings

GET Topscorers by Stage ID

Many of our clients are interested in topscorer information from their favourite league. Showing the topscorers in your application adds a great value. You can opt for a few options. The first one is the GET Topscorers by Stage ID endpoint.

A season can have multiple stages, i.e: a group stage, knock-out stage, finals etc. This endpoint is great if you want to show the topscorers per stage instead of over the complete season.

You will need to add the stage id parameters to your request:

https://api.sportmonks.com/v3/football/topscorers/stages/{stage_id}

Let’s take a look at the regular stage (stage id: 77457696) of the Danish Superliga in the 2022/2023 season. (id: 19686)

Check the stages and seasons tutorial for info about how to retrieve those ids.

This will result in the following request:

https://api.sportmonks.com/v3/football/topscorers/stages/77457696?api_token=YOUR_TOKEN

Response

{
  "data": [
    {
      "id": 1637440,
      "stage_id": 77457696,
      "player_id": 954,
      "type_id": 208,
      "position": 16,
      "total": 5,
      "participant_type": "team",
      "participant_id": 86
    },
    {
      "id": 1637115,
      "stage_id": 77457696,
      "player_id": 954,
      "type_id": 209,
      "position": 36,
      "total": 2,
      "participant_type": "team",
      "participant_id": 86
    },
    {
      "id": 1637611,
      "stage_id": 77457696,
      "player_id": 4071,
      "type_id": 84,
      "position": 21,
      "total": 4,
      "participant_type": "team",
      "participant_id": 1789
    },
    //And more!

As you can see, the response is an overview of the topscorers from the regular season stage, but what if you’re interested in the topscorer per stage per season?

Interested in adding extra information to the response? Check our adding useful information section

GET Topscorers by Season ID

You can use the Topscorers by Season ID endpoint if you want to request all the topscorers of the season.

You will need to add the season id parameters to your request.

https://api.sportmonks.com/v3/football/topscorers/seasons/{season_id}

Let’s look at the topscorers of the Danish Superliga in the 2022/2023 season. (id: 19686)

https://api.sportmonks.com/v3/football/topscorers/seasons/19686?api_token=YOUR_TOKEN

Response

{
  "data": [
    {
      "id": 1527652,
      "season_id": 19686,
      "player_id": 37563059,
      "type_id": 83,
      "position": 1,
      "total": 2,
      "participant_type": "team",
      "participant_id": 2394
    },
    {
      "id": 1527641,
      "season_id": 19686,
      "player_id": 37614052,
      "type_id": 83,
      "position": 2,
      "total": 2,
      "participant_type": "team",
      "participant_id": 2394
    },
    {
      "id": 1527642,
      "season_id": 19686,
      "player_id": 62855,
      "type_id": 83,
      "position": 3,
      "total": 2,
      "participant_type": "team",
      "participant_id": 939
    },

Adding useful information

Now, you might have noticed that the API returns only the necessary information. But what if you’re interested in team, player, league and season names? Or if you’re interested in more details about the type of topscorer? You can use certain include for this.

Check the endpoint page for a complete overview of the available includes.

Let’s say you want the topscorers of the Danish Superliga 2022/2023 season, but this time with the team, player and league information and topscorer type. As you’ve learnt in the GET Topscorers by Season ID section, your request is:

https://api.sportmonks.com/v3/football/topscorers/seasons/19686?api_token=YOUR_TOKEN

Now, you can add the league, season,stage ,team ,player and type include for more info:

https://api.sportmonks.com/v3/football/topscorers/seasons/19686?api_token=YOUR_TOKEN&include=league;season;stage;team;player;type

Selecting and filtering

Let’s continue with the previous example. You have included all relevant information but are only interested in the goalscorers. You can filter via the filters option:

An overview of some filters available:

• Goals: &filters=seasonTopscorerTypes:208

• Assists: &filters=seasonTopscorerTypes:209

• Red cards: &filters=seasonTopscorerTypes:83

• Yellow cards: &filters=seasonTopscorerTypes:84

• Penalties scored: &filters=seasonTopscorerTypes:1600

• Penalties missed: &filters=seasonTopscorerTypes:1601

https://api.sportmonks.com/v3/football/topscorers/seasons/19686?api_token=YOUR_TOKEN&include=league;season;stage;team;player;type&filters=seasonTopscorerTypes:208

Check our selecting and filtering tutorial for more information.