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

# SofaScore event team heatmap

`GET /sofascore/event-team-heatmap`

## Request

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

Returns one team's touch locations in a football match as `player_points` (outfield players) and `goalkeeper_points`, each point an `x` and `y` on SofaScore's 0-100 pitch scale. `team_id` must be the home or away team of the event; get both ids from the event endpoint. Returns 404 when SofaScore has no heatmap for that team in that match, which includes teams that did not play it, unstarted matches and sports other than football.

## Query parameters

- `id` string, required
- `team_id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreEventTeamHeatmapResponseDoc
  - `code` integer
  - `data` SofascoreEventTeamHeatmapResponse
    - `event_id` integer
    - `fetched_at` string
    - `goalkeeper_points` SofascoreHeatmapPoint[]
      - `x` number
      - `y` number
    - `player_points` SofascoreHeatmapPoint[]
      - `x` number
      - `y` number
    - `source_url` string
    - `team_id` integer
  - `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)