Get a YouTube Shorts Job

GET /api/v1/videos/youtube-shorts/{id}

Returns the job metadata and the list of generated clips. Clips are stored as JSON in the VideoJob row and parsed into a clean array on response.

Path parameters

Response

{
  "id": "vjob_xxx",
  "status": "completed",
  "sourceUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "targetClipCount": 3,
  "targetDurationSec": 45,
  "clips": [
    {
      "id": "clip_xxx",
      "index": 0,
      "title": "The hook",
      "startSec": 12.4,
      "endSec": 57.1,
      "durationSec": 44.7,
      "mediaUrl": "https://cdn.pepe.business/clips/clip_xxx.mp4",
      "thumbnailUrl": "https://cdn.pepe.business/clips/clip_xxx.jpg",
      "caption": "When the beat drops...",
      "published": false
    },
    {
      "id": "clip_yyy",
      "index": 1,
      "title": "The payoff",
      "startSec": 102.0,
      "endSec": 146.3,
      "durationSec": 44.3,
      "mediaUrl": "https://cdn.pepe.business/clips/clip_yyy.mp4",
      "thumbnailUrl": "https://cdn.pepe.business/clips/clip_yyy.jpg",
      "caption": "Never gonna give you up",
      "published": false
    }
  ],
  "createdAt": "2026-08-11T10:00:00Z",
  "completedAt": "2026-08-11T10:04:32Z"
}

Returns 404 if the job doesn't exist or doesn't belong to the authenticated user.

Example

curl "https://pepe.business/api/v1/videos/youtube-shorts/vjob_xxx" \
  -H "Authorization: Bearer pk_live_xxx"