Poll Clip Job

Poll a YouTube clip render job created via POST /clip. Scoped to the API key that enqueued it. No additional credit charge.

GEThttps://www.startuphub.ai/api/v1/clip/{jobId}

Request

curl "https://www.startuphub.ai/api/v1/clip/your-job-id" \
  -H "Authorization: Bearer sk_live_..."

Parameters

jobIdstringrequired

Job UUID returned by POST /clip (path param).

Response

json

{
  "jobId": "uuid",
  "status": "done",
  "progress": 100,
  "aspect": "9:16",
  "quality": "720p",
  "title": "Example video title",
  "mp4_url": "https://cdn.startuphub.ai/.../clip.mp4",
  "error": null,
  "created_at": "2026-08-30T12:00:00Z"
}

Errors

401Invalid or missing API key

404No job with that id for this API key

PreviousYouTube to Clips Next YouTube Transcript