Skip to main content
GET
/
video-analyses
/
{id}
Get video analysis
curl --request GET \
  --url https://app.mavera.io/api/v1/video-analyses/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "object": "video_analysis",
  "status": "pending",
  "created_at": 123,
  "updated_at": 123,
  "video_url": "<string>",
  "title": "<string>",
  "brand": "<string>",
  "product": "<string>",
  "primary_intent": "<string>",
  "secondary_intent": "<string>",
  "tertiary_intent": "<string>",
  "goal": "<string>",
  "chunk_duration": 123,
  "frames_per_chunk": 123,
  "error": "<string>",
  "progress": {
    "total_chunks": 123,
    "processed_chunks": 123
  },
  "results": {
    "total_chunks": 123,
    "completed_at": 123,
    "metrics": {
      "emotional": {},
      "cognitive": {},
      "behavioral": {},
      "technical": {},
      "platform": {},
      "risk": {},
      "ad_effectiveness": {
        "score": 123,
        "explanation": "<string>"
      }
    },
    "web_insights": [
      {
        "title": "<string>",
        "url": "<string>",
        "snippet": "<string>",
        "impact_score": 123
      }
    ],
    "aggregated_transcript": "<string>"
  },
  "chunks": [
    {
      "index": 123,
      "start_time": 123,
      "transcript": "<string>",
      "image_description": "<string>",
      "metrics": {
        "emotional": {
          "primary_emotional_tone": "<string>",
          "emotional_intensity_score": 50,
          "mood_congruence_score": 50,
          "emotional_trust_index": 50
        },
        "cognitive": {
          "message_clarity_score": 50,
          "recall_probability_index": 50,
          "cognitive_load_estimate": 50,
          "brand_attribution_confidence": 50
        },
        "behavioral": {
          "intent_to_act_score": 50,
          "retention_behavior_index": 50,
          "click_through_probability": 50
        }
      }
    }
  ]
}

Authorizations

Authorization
string
header
required

API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.

Path Parameters

id
string
required

The video analysis ID.

Response

Video analysis details.

id
string
object
enum<string>
Available options:
video_analysis
status
enum<string>
Available options:
pending,
generating,
completed,
failed
created_at
integer
updated_at
integer
video_url
string
title
string
brand
string
product
string
primary_intent
string
secondary_intent
string | null
tertiary_intent
string | null
goal
string
chunk_duration
integer
frames_per_chunk
integer
error
string | null

Error message if status is 'failed'.

progress
object

Progress info when status is 'generating'.

results
object

Full analysis results when status is 'completed'.

chunks
object[]

Per-chunk analysis data.