---
title: "Get Video Heatmap"
method: GET
path: "/library/{libraryId}/videos/{videoId}/heatmap"
tags: ["Manage Videos"]
---

# Get Video Heatmap

`GET /library/{libraryId}/videos/{videoId}/heatmap`

## Request

- Base URL: `https://video.bunnycdn.com`
- URL: `https://video.bunnycdn.com/library/{libraryId}/videos/{videoId}/heatmap`
- Auth: API key in header `AccessKey`

Returns the attention heatmap for a specific video, showing relative viewer interest across the timeline. May be unavailable if the feature is disabled or there isn't enough viewing data.

## Path parameters

- `libraryId` integer, required
- `videoId` string, required

## Response `200`

The heatmap of the requested video.

- VideoHeatmapModel
  - `heatmap` object, nullable: Timeline heatmap as segment-index to intensity (0–100). Keys represent consecutive segments from the start of the video; values are normalized so 100 equals the most‑watched segment. Missing segments imply 0.

## Other responses

- `401`: The request authentication failed
- `404`: Video not found
- `500`: Internal Server Error

## Changes

- **2026-11-12** `83116184952f`: 1 info
  - added the media type `application/json` for the response with the status `401`

[Operation history](https://skmtc.dev/bunny/apis/stream-api/changes/library/:libraryId/videos/:videoId/heatmap/get.md)

---

[API](https://skmtc.dev/bunny/apis/stream-api.md) - [All operations](https://skmtc.dev/bunny/apis/stream-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bunny/apis/stream-api/revisions/83116184952f?raw)