> For the complete documentation index, see [llms.txt](https://docs.sportmonks.com/v2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sportmonks.com/v2/endpoint-overview/topscorers/get-topscorers-by-season-id.md).

# GET Topscorers by Season ID

### `GET` Topscorers by season ID

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

| 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`<br>

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.&#x20;

You can learn more about what includes are and how they work here:

{% content-ref url="/pages/-MJXOeyBzTS35Z7kTf1c" %}
[Includes](/v2/tutorials/enriching-your-response/includes.md)
{% endcontent-ref %}

#### Example response

{% tabs %}
{% tab title="Request" %}

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

{% endtab %}

{% tab title="Response" %}

```javascript
"data": {
        "id": 17141,
        "name": "2020/2021",
        "league_id": 501,
        "is_current_season": false,
        "current_round_id": null,
        "current_stage_id": null,
        "goalscorers": {
            "data": [
                {
                    "position": 1,
                    "season_id": 17141,
                    "player_id": 1836,
                    "team_id": 180,
                    "stage_id": 77447500,
                    "goals": 5,
                    "penalty_goals": 1,
                    "type": "goals"
                },
                {
                    "position": 1,
                    "season_id": 17141,
                    "player_id": 96792,
                    "team_id": 53,
                    "stage_id": 77447501,
                    "goals": 16,
                    "penalty_goals": 5,
                    "type": "goals"
                },
                {
                    "position": 2,
                    "season_id": 17141,
                    "player_id": 4561,
                    "team_id": 62,
                    "stage_id": 77447500,
                    "goals": 4,
                    "penalty_goals": 0,
                    "type": "goals"
                },
                {
                    "position": 2,
                    "season_id": 17141,
                    "player_id": 173059,
                    "team_id": 66,
                    "stage_id": 77447501,
                    "goals": 12,
                    "penalty_goals": 2,
                    "type": "goals"
                },
                {
                    "position": 3,
                    "season_id": 17141,
                    "player_id": 8934,
                    "team_id": 309,
                    "stage_id": 77447500,
                    "goals": 3,
                    "penalty_goals": 0,
                    "type": "goals"
                },
                {
                    "position": 3,
                    "season_id": 17141,
                    "player_id": 172795,
                    "team_id": 66,
                    "stage_id": 77447501,
                    "goals": 11,
                    "penalty_goals": 4,
                    "type": "goals"
                },
                {
                    "position": 4,
                    "season_id": 17141,
                    "player_id": 121792,
                    "team_id": 496,
                    "stage_id": 77447500,
                    "goals": 3,
                    "penalty_goals": 1,
                    "type": "goals"
                },
                {
                    "position": 4,
                    "season_id": 17141,
                    "player_id": 92276,
                    "team_id": 62,
                    "stage_id": 77447501,
                    "goals": 11,
                    "penalty_goals": 0,
                    "type": "goals"
                },
                {
                    "position": 5,
                    "season_id": 17141,
                    "player_id": 12314,
                    "team_id": 180,
                    "stage_id": 77447500,
                    "goals": 3,
                    "penalty_goals": 0,
                    "type": "goals"
                },
```

{% endtab %}

{% tab title="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 |
| {% endtab %}    |                                                                         |
| {% endtabs %}   |                                                                         |

|   |
| - |

{% hint style="info" %}
Check this endpoint in Postman.\
&#x20;                                                             [![Run in Postman](https://run.pstmn.io/button.svg)](https://football-postman.sportmonks.com/#86b53d4d-afa7-4ad1-824d-d09b920d32b7)
{% endhint %}