---
title: "SofaScore event best players"
method: GET
path: "/sofascore/event-best-players"
tags: ["SofaScore"]
---

# SofaScore event best players

`GET /sofascore/event-best-players`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/sofascore/event-best-players`
- Auth: API key in header `x-api-key`

Returns a match's best-rated players per side, the overall top-rated list, and the player of the match (each with team and value) from SofaScore. Covers football (value is the match rating, label `rating`) and ice hockey (label `pts`, value the points scored; a goalkeeper with no points has no numeric `value` and carries SofaScore's dash in `value_text`). The basketball, baseball and tennis matches checked returned no summary. Returns 404 when SofaScore has no best-players summary for the match, which includes matches that have not started, sports without one and fixtures without rated players.

## Query parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreEventBestPlayersResponseDoc
  - `code` integer
  - `data` SofascoreEventBestPlayersResponse
    - `away_players` SofascoreBestPlayer[]
      - `label` string
      - `player` SofascorePlayerBrief
        - `id` integer
        - `jersey_number` string
        - `name` string
        - `position` string
        - `short_name` string
        - `slug` string
      - `team` SofascoreTeamRef
        - `country` string: Country the team belongs to.
        - `id` integer: SofaScore team id. Use it with the team endpoints.
        - `name` string: Full team name.
        - `national` boolean: True for a national team.
        - `short_name` string: Shortened team name.
        - `slug` string: URL slug of the team on SofaScore.
      - `value` number
      - `value_text` string: ValueText carries the upstream value verbatim when it is not a number, for example the en dash an ice hockey goalkeeper gets next to the `pts` label. It is omitted whenever Value is set.
    - `event_id` integer
    - `fetched_at` string
    - `home_players` SofascoreBestPlayer[]
      - `label` string
      - `player` SofascorePlayerBrief
        - `id` integer
        - `jersey_number` string
        - `name` string
        - `position` string
        - `short_name` string
        - `slug` string
      - `team` SofascoreTeamRef
        - `country` string: Country the team belongs to.
        - `id` integer: SofaScore team id. Use it with the team endpoints.
        - `name` string: Full team name.
        - `national` boolean: True for a national team.
        - `short_name` string: Shortened team name.
        - `slug` string: URL slug of the team on SofaScore.
      - `value` number
      - `value_text` string: ValueText carries the upstream value verbatim when it is not a number, for example the en dash an ice hockey goalkeeper gets next to the `pts` label. It is omitted whenever Value is set.
    - `player_of_the_match` SofascoreBestPlayer
      - `label` string
      - `player` SofascorePlayerBrief
        - `id` integer
        - `jersey_number` string
        - `name` string
        - `position` string
        - `short_name` string
        - `slug` string
      - `team` SofascoreTeamRef
        - `country` string: Country the team belongs to.
        - `id` integer: SofaScore team id. Use it with the team endpoints.
        - `name` string: Full team name.
        - `national` boolean: True for a national team.
        - `short_name` string: Shortened team name.
        - `slug` string: URL slug of the team on SofaScore.
      - `value` number
      - `value_text` string: ValueText carries the upstream value verbatim when it is not a number, for example the en dash an ice hockey goalkeeper gets next to the `pts` label. It is omitted whenever Value is set.
    - `source_url` string
    - `top_players` SofascoreBestPlayer[]
      - `label` string
      - `player` SofascorePlayerBrief
        - `id` integer
        - `jersey_number` string
        - `name` string
        - `position` string
        - `short_name` string
        - `slug` string
      - `team` SofascoreTeamRef
        - `country` string: Country the team belongs to.
        - `id` integer: SofaScore team id. Use it with the team endpoints.
        - `name` string: Full team name.
        - `national` boolean: True for a national team.
        - `short_name` string: Shortened team name.
        - `slug` string: URL slug of the team on SofaScore.
      - `value` number
      - `value_text` string: ValueText carries the upstream value verbatim when it is not a number, for example the en dash an ice hockey goalkeeper gets next to the `pts` label. It is omitted whenever Value is set.
  - `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/028417aa35bb?raw)