---
title: "Flashscore football player match statistics and ratings"
method: GET
path: "/flashscore/match-player-stats"
tags: ["Flashscore"]
---

# Flashscore football player match statistics and ratings

`GET /flashscore/match-player-stats`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/flashscore/match-player-stats`
- Auth: API key in header `x-api-key`

Returns per-player statistics for a football match with player-statistics coverage: the Flashscore rating, highlight badges and every statistic of the player-statistics tabs (shots, expected goals, passes, duels, goalkeeping and more) with display text, unrounded value and rank, plus the statistic and group definitions. The full response is large; narrow it with group, or with player_id for a single player. Other sports and matches without coverage return not found.

## Query parameters

- `id` string, required
- `player_id` string
- `group` 'top_stats' | 'shots' | 'attack' | 'passes' | 'defense' | 'goalkeeping' | 'general'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- FlashscoreMatchPlayerStatsResponseDoc
  - `code` integer
  - `data` FlashscoreMatchPlayerStatsDataDoc
    - `groups` FlashscorePlayerStatGroupDoc[]
      - `goalkeeper_only` boolean
      - `key` 'top_stats' | 'shots' | 'attack' | 'passes' | 'defense' | 'goalkeeping' | 'general'
      - `label` string
      - `stats` string[]
    - `match_id` string
    - `players` FlashscorePlayerMatchStatsDoc[]
      - `highlights` string[]
      - `id` string
      - `name` string
      - `position` string
      - `rating` number
      - `short_name` string
      - `side` 'home' | 'away'
      - `slug` string
      - `starter` boolean
      - `stats` object: Stats maps a statistic key from stat_types to this player's value.
      - `team_id` string
      - `top_rated` boolean
    - `source_url` string
    - `stat_types` FlashscorePlayerStatTypeDoc[]
      - `combined` FlashscorePlayerStatCombinedDoc
        - `stats` string[]
        - `template` string
      - `format` 'count' | 'percentage' | 'count_two_decimal_places'
      - `groups` string[]
      - `key` string
      - `label` string
      - `sentiment` 'positive' | 'negative'
    - `teams` FlashscorePlayerStatTeamDoc[]
      - `id` string
      - `name` string
      - `side` 'home' | 'away'
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `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/028417aa35bb?raw)