---
title: "Get player statistics by player id"
method: GET
path: "/football/players/{id}/statistics"
tags: ["Football.Players"]
---

# Get player statistics by player id

`GET /football/players/{id}/statistics`

## Request

- Base URL: `https://sports.highlightly.net`
- URL: `https://sports.highlightly.net/football/players/{id}/statistics`
- Auth: none declared. Required headers: `x-rapidapi-host`, `x-rapidapi-key`
- TypeScript: <https://skmtc.dev/highlightly/apis/sports-api-highlightly/docs/football/players/:id/statistics/get.ts> (a function with typed inputs; its response is checked against the schema)

> Refresh interval: Once a day

Retrieve detailed player statistics for specified `playerId`.

Detailed player statistics is split into `perClub` and `perCompetition` aggregation. The following statistics are available:

| Type               | Description                                                                 |
|--------------------|-----------------------------------------------------------------------------|
| Goals              | Number of goals scored by the player.                                        |
| Assists            | Number of assists provided by the player.                                    |
| Own goals           | Number of goals accidentally scored against the player's own team.           |
| Red cards           | Number of direct red cards received.                                         |
| Clean sheets        | Number of matches where no goals were conceded (mostly relevant for goalkeepers). |
| Games played        | Total number of matches the player appeared in.                              |
| Yellow cards        | Number of yellow cards received.                                              |
| Goals conceded      | Number of goals the team conceded while the player was on the pitch (mainly for goalkeepers). |
| Minutes played      | Total number of minutes the player was on the field.                         |
| Substituted in      | Number of times the player came on as a substitute.                          |
| Substituted out     | Number of times the player was substituted off.                              |
| Penalties scored    | Number of penalty goals scored.                                               |
| Second yellow cards  | Number of second yellow cards leading to a red card.                        |

Additionally, the competitions are split into multiple categories:

| Type             | Description                                                                 |
|------------------|-----------------------------------------------------------------------------|
| National league  | A country's main domestic competition where clubs play each other over a season (e.g., Premier League, La Liga). |
| National cup     | A domestic knockout tournament open to clubs from different divisions (e.g., FA Cup, Copa del Rey). |
| International cup| A tournament involving clubs from multiple countries (e.g., UEFA Champions League, Copa Libertadores). |

![Player stats example](https://highlightly.net/assets/img/documentation/football/player-stats.png)

## Path parameters

- `id` number, required

## Headers

- `x-rapidapi-host` string, required
- `x-rapidapi-key` string, required

## Response `200`

- FootballDetailedPlayerStatisticsResponseDto[]
  - `id` number, required
  - `name` string, required
  - `fullName` string
  - `logo` string
  - `perCompetition` FootballDetailedPlayerStatisticsPerCompetitionDto[], required
    - `club` string, required
    - `type` 'national league' | 'national cup' | 'international cup', required
    - `league` string, required
    - `season` string, required
    - `goals` number, required
    - `assists` number, required
    - `ownGoals` number, required
    - `redCards` number, required
    - `cleanSheets` number, required
    - `gamesPlayed` number, required
    - `yellowCards` number, required
    - `goalsConceded` number, required
    - `minutesPlayed` number, required
    - `substitutedIn` number, required
    - `substitutedOut` number, required
    - `penaltiesScored` number, required
    - `secondYellowCards` number, required
  - `perClub` FootballDetailedPlayerStatisticsPerClubDto[], required
    - `club` string, required
    - `goals` number, required
    - `assists` number, required
    - `ownGoals` number, required
    - `redCards` number, required
    - `cleanSheets` number, required
    - `gamesPlayed` number, required
    - `yellowCards` number, required
    - `goalsConceded` number, required
    - `minutesPlayed` number, required
    - `substitutedIn` number, required
    - `substitutedOut` number, required
    - `penaltiesScored` number, required
    - `secondYellowCards` number, required

## Other responses

- `400`: Bad request descriptive error.
- `500`: Internal server error.

---

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