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

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

console.log(`${data.projects.length} of ${data.total} projects`);
for (const project of data.projects) {
  console.log(project.name, project.status, project.video?.url ?? "(no video yet)");
}

import os
import requests

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

{
  "success": true,
  "message": "Projects fetched successfully",
  "data": {
    "projects": [
      {
        "id": "cm4x9q1r30005ab12gh34ij78",
        "name": "Evening routine tips",
        "type": "script_to_video",
        "status": "processing",
        "source": "api",
        "progress": 35,
        "message": "Generating media...",
        "usedCredits": 42,
        "metadata": {},
        "createdAt": "2026-10-01T11:02:00.000Z",
        "updatedAt": "2026-10-01T11:03:10.000Z",
        "video": null
      },
      {
        "id": "cm4x9k2p10001ab12cd34ef56",
        "name": "Morning routine tips",
        "type": "script_to_video",
        "status": "completed",
        "source": "api",
        "progress": 100,
        "message": "Video ready",
        "usedCredits": 42,
        "metadata": { "campaignId": "spring-launch" },
        "createdAt": "2026-10-01T09:12:03.000Z",
        "updatedAt": "2026-10-01T09:16:41.000Z",
        "video": {
          "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"
        }
      }
    ],
    "total": 12,
    "limit": 2,
    "offset": 0
  }
}

{
  "success": false,
  "message": "status: Must be one of draft, processing, completed, failed"
}