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

https://soccer.sportmonks.com/api/v2.0/topscorers/season/{ID}/aggregated

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

https://soccer.sportmonks.com/api/v2.0/topscorers/season/17141/aggregated?api_token={API_TOKEN}

Response

 "data": {
        "id": 17141,
        "name": "2020/2021",
        "league_id": 501,
        "is_current_season": false,
        "current_round_id": null,
        "current_stage_id": null,
        "aggregatedGoalscorers": {
            "data": [
                {
                    "position": 1,
                    "season_id": 17141,
                    "player_id": 96792,
                    "team_id": 53,
                    "stage_id": null,
                    "goals": 18,
                    "penalty_goals": 5,
                    "type": "aggregated_goals"
                },
                {
                    "position": 2,
                    "season_id": 17141,
                    "player_id": 173059,
                    "team_id": 66,
                    "stage_id": null,
                    "goals": 14,
                    "penalty_goals": 2,
                    "type": "aggregated_goals"
                },
                {
                    "position": 3,
                    "season_id": 17141,
                    "player_id": 4561,
                    "team_id": 62,
                    "stage_id": null,
                    "goals": 14,
                    "penalty_goals": 0,
                    "type": "aggregated_goals"
                },
                {
                    "position": 4,
                    "season_id": 17141,
                    "player_id": 172795,
                    "team_id": 66,
                    "stage_id": null,
                    "goals": 12,
                    "penalty_goals": 5,
                    "type": "aggregated_goals"
                },
                {
                    "position": 5,
                    "season_id": 17141,
                    "player_id": 92276,
                    "team_id": 62,
                    "stage_id": null,
                    "goals": 12,
                    "penalty_goals": 0,
                    "type": "aggregated_goals"
                },
                {
                    "position": 6,
                    "season_id": 17141,
                    "player_id": 758,
                    "team_id": 62,
                    "stage_id": null,
                    "goals": 12,
                    "penalty_goals": 7,
                    "type": "aggregated_goals"
                },
                {
                    "position": 7,
                    "season_id": 17141,
                    "player_id": 8934,
                    "team_id": 309,
                    "stage_id": null,
                    "goals": 11,
                    "penalty_goals": 1,
                    "type": "aggregated_goals"
                },
                {
                    "position": 8,
                    "season_id": 17141,
                    "player_id": 150759,
                    "team_id": 53,
                    "stage_id": null,
                    "goals": 10,
                    "penalty_goals": 0,
                    "type": "aggregated_goals"
                },
                {
                    "position": 9,
                    "season_id": 17141,
                    "player_id": 3387,
                    "team_id": 62,
                    "stage_id": null,
                    "goals": 10,
                    "penalty_goals": 0,
                    "type": "aggregated_goals"
                },

Field Description

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.