---
title: "SofaScore team player statistics"
method: GET
path: "/sofascore/team-player-statistics"
tags: ["SofaScore"]
---

# SofaScore team player statistics

`GET /sofascore/team-player-statistics`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/sofascore/team-player-statistics`
- Auth: API key in header `x-api-key`

Returns the statistics of every player in a team's squad for one competition season, each as a snake_case metric map (appearances, minutes, rating, goals, assists, passing and duel metrics for football; points, rebounds and assists for basketball), in SofaScore's order. The `type` enum accepts `overall`, `home`, `away`, `regular_season` and `playoffs` and defaults to `overall`; only the types listed for that season by team-player-statistics-seasons exist (football `overall`, `home`, `away`; NBA `regular_season`, `playoffs`). A metric SofaScore did not record is omitted rather than returned as 0. Returns 404 when SofaScore has no statistics of that type for the combination.

## Query parameters

- `id` string, required
- `tournament_id` string, required
- `season` string, required
- `type` 'overall' | 'home' | 'away' | 'regular_season' | 'playoffs'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreTeamPlayerStatisticsResponseDoc
  - `code` integer
  - `data` SofascoreTeamPlayerStatisticsResponse
    - `count` integer
    - `fetched_at` string
    - `players` SofascoreTeamPlayerStatistics[]
      - `played_enough` boolean
      - `player` SofascorePlayerBrief
        - `id` integer
        - `jersey_number` string
        - `name` string
        - `position` string
        - `short_name` string
        - `slug` string
      - `statistics` object
    - `season` integer
    - `source_url` string
    - `team_id` integer
    - `tournament_id` integer
    - `type` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

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