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

# Get a video analysis

> Retrieve the status and outputs of a video analysis.

Retrieve a video analysis by its `id`. Poll until `status` is `success` or `failed`. On success, `outputs` contains the generated attention map, along with the `title` you supplied and the `created_at` timestamp.

<Note>
  Unlike image and URL analyses (which return `410 Gone` one hour after completion), video analyses remain retrievable.
</Note>

<Warning>
  Video analysis is gated by the `dynamic-saliency` add-on. If it is not enabled for your account, this endpoint returns `404`. Contact [sales@eyequant.com](mailto:sales@eyequant.com) to enable it.
</Warning>

<ParamField path="analysis-id" type="string" required>
  The id for the video analysis received upon its creation.
</ParamField>

<ResponseField name="id" type="string">
  The analysis identifier.
</ResponseField>

<ResponseField name="status" type="string">
  The current state: `pending`, `success`, or `failed`.
</ResponseField>

<ResponseField name="title" type="string">
  The title you supplied when creating the analysis.
</ResponseField>

<ResponseField name="created_at" type="string">
  When the analysis was created.
</ResponseField>

<ResponseField name="outputs" type="object">
  Present when `status` is `success`. Contains the attention map for the video.
</ResponseField>

<ResponseField name="error" type="object">
  Present when `status` is `failed`. Contains an error `code` and `message`.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl \
    -H "Authorization: Bearer $apikey" \
    -H "Content-Type: application/json" \
    -X GET \
    https://api.eyequant.com/v2/analyses/video/611457618c1d4283a830d10a9ad4f8ae
  ```
</RequestExample>

<ResponseExample>
  ```json success theme={null}
  {
    "id": "611457618c1d4283a830d10a9ad4f8ae",
    "status": "success",
    "title": "The video title.",
    "outputs": {
      "attention": {
        "attentionMap": "https://s3.amazonaws.com/api-eyequant/..."
      }
    },
    "created_at": "2026-06-01T09:12:43.512000"
  }
  ```

  ```json pending theme={null}
  {
    "id": "611457618c1d4283a830d10a9ad4f8ae",
    "status": "pending",
    "created_at": "2026-06-01T09:12:43.512000"
  }
  ```

  ```json failed theme={null}
  {
    "id": "611457618c1d4283a830d10a9ad4f8ae",
    "status": "failed",
    "created_at": "2026-06-01T09:12:43.512000",
    "error": {
      "code": "input_error",
      "message": "There's been an error that is related to the provided input medium, e.g. image or video. Please make sure it meets its specific requirements like length, dimensions or file size."
    }
  }
  ```

  ```json 404 theme={null}
  {
    "error": {
      "code": "resource_not_found",
      "message": "We could not find an analysis for the given id."
    }
  }
  ```
</ResponseExample>