MUmuxinc
Engagement

Get Engagement Heatmap for a Video

Changed on

Returns the engagement heatmap for a video. The heatmap is an array of per-bucket engagement values across the content timeline, where the number of buckets scales with the content duration. Each value represents how engaged viewers were with that portion of the content.

get/data/v1/engagement/videos/{VIDEO_ID}/heatmap

Request

  • Base URL
    https://api.mux.com
  • Auth
    • HTTP basic
    • or HTTP bearer

Path parameters

VIDEO_IDstring required

ID of the Video, as provided in the video_id metadata field when configuring the player.

Query parameters

timeframestring[]

Timeframe window to limit results by. Must be provided as an array query string parameter (e.g. timeframe[]=).

Accepted formats are...

  • array of epoch timestamps e.g. timeframe[]=1498867200&timeframe[]=1498953600
  • duration string e.g. timeframe[]=24:hours or timeframe[]=7:days

Response

OK

total_row_countinteger nullable required
timeframeinteger[] required

Changes

  • 99c1d509dcbbRevision changes
    • warning

      deleted the query request parameter timeframe[]

    • info

      added the new optional query request parameter timeframe

  • 4fb3ee354107Revision changes
    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the required property / to the response with the status