---
title: "Team stats"
method: POST
path: "/v1/get_team_stats"
tags: ["Stats + aggregation"]
---

# Team stats

`POST /v1/get_team_stats`

## Request

- Base URL: `https://mcp.strikerapi.com`
- URL: `https://mcp.strikerapi.com/v1/get_team_stats`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Use for clubs' per-match averages over a season, for and against: goals, our xG, shots, shots on target, possession, pass accuracy, corners, fouls, cards, tackles, clean sheets. Possession is missing for some leagues and seasons (for example the Eredivisie before 2020, the Scottish Premiership 2015 to 2023, the NWSL before 2025) and its average covers only matches that have it. Costs 5 credits.

## Request body

- object
  - `season` union: Season by the year it starts (default: the latest).
    - number
    - string
  - `team` string: One club.
  - `league` 'soccer' | 'mls' | 'laliga' | 'seriea' | 'bundesliga' | 'ligue1' | 'ucl' | 'championship' | 'nwsl' | 'ligamx' | 'uel' | 'uecl' | 'eredivisie' | 'primeira' | 'scotland' | 'brazil' | 'argentina': League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.

## Response `200`

The result, wrapped in data.

- object
  - `data` object, required
    - `season` number, nullable, required
    - `teams` object[], required
    - `count` number, required
    - `method` string, required

## Other responses

- `400`: Invalid arguments.
- `401`: Missing or invalid API key.
- `402`: Not enough credits.
- `429`: Rate limited.

---

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