---
title: "Goalgetter"
method: GET
path: "/tournaments/{tournament_id}/seasons/{season_id}/goalgetter"
tags: ["Season"]
---

# Goalgetter

`GET /tournaments/{tournament_id}/seasons/{season_id}/goalgetter`

## Request

- Base URL: `https://api.clubplatform.de/api`
- URL: `https://api.clubplatform.de/api/tournaments/{tournament_id}/seasons/{season_id}/goalgetter`
- Auth: API key in query parameter `auth_token`

Goalgetter statistics for the season.

## Path parameters

- `tournament_id` integer, required
- `season_id` integer, required

## Query parameters

- `limit` integer
- `page` integer
- `club_id` integer

## Response `200`

OK.

- object
  - `data` object
    - `season_id` integer: The id of the season the ranking belongs to.
    - `player` object[]: An array containing all goalgetters.
      - `id` integer: ID of the player.
      - `firstname` string: First name of the player.
      - `goals` integer: Goals scored by the player.
      - `assists` integer: Number of assists for the player during the season.
      - `lastname` string: Last name of the player.
      - `name` string: Name of the player.
      - `nickname` string: Nickname of the player.
      - `team_id` integer: Id of the team the player belongs to.
      - `goals_home` integer: Goals scored by the player in home matches.
      - `goals_away` integer: Goals scored by the player in away matches.
      - `goals_today` integer: Goals the player has scored today.
      - `goals_head` integer: Goals scored by the player with a header.
      - `goals_inside_box` integer: Goals from within 16 meter penalty box.
      - `goals_outside_box` integer: Goals from outside 16 meter penalty box.
      - `goals_left` integer: Goals with left foot.
      - `goals_right` integer: Goals with right foot.
      - `penalty_shots_scored` integer: Goals scored by penalties.
      - `rank` integer: Rank in the list of goalgetters.
      - `portrait_image_url` string: URL to the portrait image of the player.
      - `portrait_image` object: The portrait image in different resolutions.
        - `original` string: URL to the portrait image in original resolution.
        - `medium` string: URL to the portrait image in medium resolution (300x300).
        - `small` string: URL to the portrait image in small resolution (100x100).
        - `mini` string: URL to the portrait image in mini resolution (30x30).
      - `club` object: The club the team belongs to.
        - `id` integer: The Club id.
        - `link` string: The url to the club resource in the api.
        - `emblem` object: The club emblem in different resolutions.
          - `mini` string: URL of the club emblem in a mini resolution (36px by 36px).
          - `small` string: URL of the club emblem in a small resolution (70px by 70px).
          - `medium` string: URL of the club emblem in a medium resolution (300px by 300px).

## Other responses

- `304`: Not Modified
- `401`: Unauthorized
- `404`: Not Found

---

[API](https://skmtc.dev/clubplatform/apis/clubplatform-api.md) - [All operations](https://skmtc.dev/clubplatform/apis/clubplatform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clubplatform/apis/clubplatform-api/revisions/5c107a185e03?raw)