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

async function waitForMedia(mediaId) {
  for (;;) {
    const response = await fetch(`https://api.hooked.so/v1/media/${mediaId}`, {
      headers: { "x-api-key": process.env.HOOKED_API_KEY },
    });
    const { data } = await response.json();
    if (data.status === "COMPLETED") return data;
    if (data.status === "FAILED") throw new Error(`Media ${mediaId} failed: ${data.error}`);
    await new Promise((resolve) => setTimeout(resolve, 3000));
  }
}

import os
import time
import requests

def wait_for_media(media_id):
    while True:
        response = requests.get(
            f"https://api.hooked.so/v1/media/{media_id}",
            headers={"x-api-key": os.environ["HOOKED_API_KEY"]},
        )
        data = response.json()["data"]
        if data["status"] == "COMPLETED":
            return data
        if data["status"] == "FAILED":
            raise RuntimeError(f"Media {media_id} failed: {data['error']}")
        time.sleep(3)

{
  "success": true,
  "message": "Media fetched successfully",
  "data": {
    "id": "cm4x9s8u60009ab12kl56mn90",
    "name": "Demo clip",
    "type": "video",
    "status": "COMPLETED",
    "error": null,
    "url": "https://files.hooked.so/team/public/demo--fid--9c1d.mp4",
    "thumbnail": "https://files.hooked.so/team/public/demo--fid--9c1d.jpg",
    "durationSeconds": 12.4,
    "size": 8388608,
    "aspectRatio": "ratio_9_16",
    "isAIGenerated": false,
    "createdAt": "2026-10-01T09:30:00.000Z"
  }
}

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