---
title: "Changes to Get Engagement Heatmap for an Asset"
method: GET
path: "/data/v1/engagement/assets/{ASSET_ID}/heatmap"
---

# Changes to Get Engagement Heatmap for an Asset

`GET /data/v1/engagement/assets/{ASSET_ID}/heatmap`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 54 revisions.

- **2026-09-30** `99c1d509dcbb`: 1 warning, 1 info
- **2026-09-30** `4fb3ee354107`: 2 breaking, 4 info
- **2026-08-12** `5b4b3133f27d`: 1 info

## Changes

- **2026-09-30** `99c1d509dcbb`: 1 warning, 1 info
  - deleted the `query` request parameter `timeframe[]`
  - added the new optional `query` request parameter `timeframe`
- **2026-09-30** `4fb3ee354107`: 2 breaking, 4 info
  - removed the required property `data/total_views` from the response with the `200` status
  - removed the required property `data/value` from the response with the `200` status
  - added the optional property `data/asset_id` to the response with the `200` status
  - added the optional property `data/playback_id` to the response with the `200` status
  - added the optional property `data/video_id` to the response with the `200` status
  - added the required property `data/heatmap` to the response with the `200` status
- **2026-08-12** `5b4b3133f27d`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/muxinc/apis/mux-api/docs/data/v1/engagement/assets/:ASSET_ID/heatmap/get.md) - [API](https://skmtc.dev/muxinc/apis/mux-api.md) - [Page](https://skmtc.dev/muxinc/apis/mux-api/changes/data/v1/engagement/assets/:ASSET_ID/heatmap/get)