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

# SofaScore event statistics

`GET /sofascore/event-statistics`

## Request

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

Returns one match's statistics (possession, shots, passes, and more, grouped and split by period). Returns 404 when SofaScore has no tracked statistics for the match.

## Query parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreEventStatisticsResponseDoc
  - `code` integer
  - `data` SofascoreEventStatisticsResponse
    - `event_id` integer: SofaScore event id the statistics belong to.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `periods` SofascoreStatPeriod[]: Statistics for the whole match and for each period.
      - `groups` SofascoreStatGroup[]: Statistic groups for the period.
        - `items` SofascoreStatItem[]: Statistics in the group.
          - `away` string: Away side's value as displayed, for example 39%.
          - `home` string: Home side's value as displayed, for example 61%.
          - `key` string: Stable key for the statistic, for example `ballPossession`.
          - `name` string: Statistic name, for example "Ball possession".
        - `name` string: Group name, for example "Match overview" or "Shots".
      - `period` string: Period the statistics cover: `ALL`, `1ST` or `2ND`.
    - `source_url` string: SofaScore URL the data was read from.
  - `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/0497899e2016?raw)
