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

# SofaScore event player heatmap

`GET /sofascore/event-player-heatmap`

## Request

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

Returns one player's touch locations in a football match as `points`, each an `x` and `y` on SofaScore's 0-100 pitch scale. Get `player_id` from event-lineups. Returns 404 when SofaScore has no heatmap for that player in that match, which includes players who did not play, unstarted matches and sports other than football.

## Query parameters

- `id` string, required
- `player_id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreEventPlayerHeatmapResponseDoc
  - `code` integer
  - `data` SofascoreEventPlayerHeatmapResponse
    - `count` integer
    - `event_id` integer
    - `fetched_at` string
    - `player_id` integer
    - `points` SofascoreHeatmapPoint[]
      - `x` number
      - `y` number
    - `source_url` 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/afac9b012a27?raw)