> ## Documentation Index
> Fetch the complete documentation index at: https://bunny.net/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Video Heatmap

> 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.



## OpenAPI

````yaml https://video.bunnycdn.com/openapi/bunnynet-video-api.public.json get /library/{libraryId}/videos/{videoId}/heatmap
openapi: 3.0.0
info:
  title: Stream API
  termsOfService: https://bunny.net/tos
  contact:
    name: bunny.net
    url: https://docs.bunny.net
    email: support@bunny.net
  version: 1.6.21
servers:
  - url: https://video.bunnycdn.com
security: []
tags:
  - name: Manage Collections
  - name: Encoding Statistics
  - name: Manage Videos
paths:
  /library/{libraryId}/videos/{videoId}/heatmap:
    get:
      tags:
        - Manage Videos
      summary: Get Video Heatmap
      description: >-
        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.
      operationId: Video_GetVideoHeatmap
      parameters:
        - name: libraryId
          in: path
          required: true
          description: The ID of the video library.
          schema:
            type: integer
            format: int64
          x-position: 1
        - name: videoId
          in: path
          required: true
          description: The GUID of the video.
          schema:
            type: string
          x-position: 2
      responses:
        '200':
          description: The heatmap of the requested video.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoHeatmapModel'
        '401':
          description: The request authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusModel'
        '404':
          description: Video not found
        '500':
          description: Internal Server Error
      security:
        - AccessKey: []
components:
  schemas:
    VideoHeatmapModel:
      type: object
      additionalProperties: false
      properties:
        heatmap:
          type: object
          description: >-
            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.
          nullable: true
          additionalProperties:
            type: integer
            format: int32
    StatusModel:
      type: object
      additionalProperties: false
      properties:
        success:
          type: boolean
          description: Determines if the request was successful
        message:
          type: string
          description: >-
            Human-readable message describing the result, typically populated
            with error details when Success is false.
          nullable: true
        statusCode:
          type: integer
          description: The HTTP status code corresponding to the result of the request.
          format: int32
  securitySchemes:
    AccessKey:
      type: apiKey
      description: AccessKey based authentication
      name: AccessKey
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.