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

# SofaScore event average positions

`GET /sofascore/event-average-positions`

## Request

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

Returns every player's average position on the pitch during a football match (`average_x` and `average_y` on SofaScore's 0-100 pitch scale, plus the number of touches behind it) for the home and away sides, and the substitutions with their minute. Returns 404 when SofaScore has no positional data for the match, which includes unstarted matches and sports other than football.

## Query parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreEventAveragePositionsResponseDoc
  - `code` integer
  - `data` SofascoreEventAveragePositionsResponse
    - `away` SofascoreAveragePosition[]
      - `average_x` number
      - `average_y` number
      - `player` SofascorePlayerBrief
        - `id` integer
        - `jersey_number` string
        - `name` string
        - `position` string
        - `short_name` string
        - `slug` string
      - `points_count` integer
    - `event_id` integer
    - `fetched_at` string
    - `home` SofascoreAveragePosition[]
      - `average_x` number
      - `average_y` number
      - `player` SofascorePlayerBrief
        - `id` integer
        - `jersey_number` string
        - `name` string
        - `position` string
        - `short_name` string
        - `slug` string
      - `points_count` integer
    - `source_url` string
    - `substitutions` SofascoreAveragePositionSubstitution[]
      - `is_home` boolean
      - `minute` integer
      - `player_in` SofascorePlayerBrief
        - `id` integer
        - `jersey_number` string
        - `name` string
        - `position` string
        - `short_name` string
        - `slug` string
      - `player_out` SofascorePlayerBrief
        - `id` integer
        - `jersey_number` string
        - `name` string
        - `position` string
        - `short_name` string
        - `slug` 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/0497899e2016?raw)