curl "https://api.hooked.so/v1/media/list?type=video&limit=20" \
  -H "x-api-key: your_api_key_here"

const params = new URLSearchParams({ type: "video", limit: "20" });
const response = await fetch(`https://api.hooked.so/v1/media/list?${params}`, {
  headers: { "x-api-key": process.env.HOOKED_API_KEY },
});
const { data } = await response.json();

const ready = data.media.filter((media) => media.status === "COMPLETED");
console.log(`${ready.length} ready of ${data.total} videos`);

import os
import requests

response = requests.get(
    "https://api.hooked.so/v1/media/list",
    params={"type": "video", "limit": 20},
    headers={"x-api-key": os.environ["HOOKED_API_KEY"]},
)
data = response.json()["data"]
print(f"{len(data['media'])} of {data['total']} videos")

{
  "success": true,
  "message": "Media fetched successfully",
  "data": {
    "media": [
      {
        "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"
      }
    ],
    "total": 42,
    "limit": 20,
    "offset": 0
  }
}

{
  "success": false,
  "message": "type: Must be image or video"
}