curl "https://api.hooked.so/v1/video/cm4x9n7q20003ab12xy98zt10" \
  -H "x-api-key: your_api_key_here"

const videoId = "cm4x9n7q20003ab12xy98zt10";
const response = await fetch(`https://api.hooked.so/v1/video/${videoId}`, {
  headers: { "x-api-key": process.env.HOOKED_API_KEY },
});
const { data: video } = await response.json();

console.log(video.status, `${video.progress}%`);
if (video.status === "COMPLETED") console.log("Download:", video.url);

import os
import requests

video_id = "cm4x9n7q20003ab12xy98zt10"
response = requests.get(
    f"https://api.hooked.so/v1/video/{video_id}",
    headers={"x-api-key": os.environ["HOOKED_API_KEY"]},
)
video = response.json()["data"]

print(video["status"], f"{video['progress']}%")
if video["status"] == "COMPLETED":
    print("Download:", video["url"])

{
  "success": true,
  "message": "Video details fetched successfully",
  "data": {
    "id": "cm4x9n7q20003ab12xy98zt10",
    "name": "Morning routine tips",
    "projectId": "cm4x9k2p10001ab12cd34ef56",
    "projectType": "script_to_video",
    "status": "COMPLETED",
    "progress": 100,
    "message": "Video ready",
    "url": "https://files.hooked.so/team/videos/cm4x9n7q20003ab12xy98zt10.mp4?X-Amz-Signature=...",
    "thumbnail": "https://files.hooked.so/team/thumbnails/cm4x9n7q20003ab12xy98zt10.jpg?X-Amz-Signature=...",
    "durationInFrames": 1125,
    "durationInSeconds": 45,
    "size": 18874368,
    "createdAt": "2026-10-01T09:15:58.000Z",
    "updatedAt": "2026-10-01T09:16:41.000Z"
  }
}

{
  "code": "not_authenticated",
  "message": "Not authenticated",
  "errorCode": "NOT_AUTHENTICATED",
  "details": { "x-api-key": "Header not provided or API Key invalid" }
}

{
  "code": "entitlement_required",
  "error": "entitlement_required",
  "message": "This endpoint requires the \"app\" product.",
  "product": "app"
}

{
  "success": false,
  "message": "Video not found"
}