Get a video analysis

GET

analyses

video

{analysis-id}

curl \
  -H "Authorization: Bearer $apikey" \
  -H "Content-Type: application/json" \
  -X GET \
  https://api.eyequant.com/v2/analyses/video/611457618c1d4283a830d10a9ad4f8ae

{
  "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"
}

{
  "id": "611457618c1d4283a830d10a9ad4f8ae",
  "status": "pending",
  "created_at": "2026-06-01T09:12:43.512000"
}

{
  "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."
  }
}

{
  "error": {
    "code": "resource_not_found",
    "message": "We could not find an analysis for the given id."
  }
}

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.

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

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 to enable it.

string

required

The id for the video analysis received upon its creation.

string

The analysis identifier.

string

The current state: pending, success, or failed.

string

The title you supplied when creating the analysis.

string

When the analysis was created.

object

Present when status is success. Contains the attention map for the video.

object

Present when status is failed. Contains an error code and message.

curl \
  -H "Authorization: Bearer $apikey" \
  -H "Content-Type: application/json" \
  -X GET \
  https://api.eyequant.com/v2/analyses/video/611457618c1d4283a830d10a9ad4f8ae

{
  "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"
}

{
  "id": "611457618c1d4283a830d10a9ad4f8ae",
  "status": "pending",
  "created_at": "2026-06-01T09:12:43.512000"
}

{
  "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."
  }
}

{
  "error": {
    "code": "resource_not_found",
    "message": "We could not find an analysis for the given id."
  }
}

Create a video analysis

Update analysis metadata

curl \
  -H "Authorization: Bearer $apikey" \
  -H "Content-Type: application/json" \
  -X GET \
  https://api.eyequant.com/v2/analyses/video/611457618c1d4283a830d10a9ad4f8ae

{
  "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"
}

{
  "id": "611457618c1d4283a830d10a9ad4f8ae",
  "status": "pending",
  "created_at": "2026-06-01T09:12:43.512000"
}

{
  "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."
  }
}

{
  "error": {
    "code": "resource_not_found",
    "message": "We could not find an analysis for the given id."
  }
}

General

Analyses

Summaries & Recommendations

Ad Visibility

Tags

Get a video analysis