Jobs and Exports
Track async jobs and retrieve export download URLs.
Transcription, AI generation, clip assembly, and exports can run asynchronously. Poll jobs for status or use webhooks for push notifications.
Endpoints
GET /v1/jobs/{job_id}GET /v1/projects/{project_id}/jobsPOST /v1/projects/{project_id}/exportGET /v1/exports/{export_id}GET /v1/projects/{project_id}/exports
Get Job Status
curl https://www.blitzreels.com/api/v1/jobs/{job_id} \
-H "Authorization: Bearer $BLITZREELS_API_KEY"{
"job_id": "job-uuid",
"type": "export",
"status": "processing",
"progress": 45,
"project_id": "project-uuid",
"created_at": "2026-02-04T10:00:00Z",
"completed_at": null,
"error": null
}List Jobs for a Project
curl https://www.blitzreels.com/api/v1/projects/{project_id}/jobs \
-H "Authorization: Bearer $BLITZREELS_API_KEY"Start Export
curl -X POST https://www.blitzreels.com/api/v1/projects/{project_id}/export \
-H "Authorization: Bearer $BLITZREELS_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "resolution": "1080p", "format": "mp4", "cover_frame_seconds": 1 }'Omit cover_frame_seconds or pass null to use smart automatic thumbnail selection. Smart selection ranks rendered-video candidates: title-card hook, text hook, early visual moment, then generic fallback.
{
"export_id": "export-uuid",
"job_id": "job-export-uuid",
"status": "queued"
}Get Export Status
curl https://www.blitzreels.com/api/v1/exports/{export_id} \
-H "Authorization: Bearer $BLITZREELS_API_KEY"{
"export_id": "export-uuid",
"status": "complete",
"download_url": "https://cdn.blitzreels.com/exports/xxx.mp4",
"thumbnail_url": "https://cdn.blitzreels.com/exports/xxx-thumbnail.jpg",
"thumbnail": {
"url": "https://cdn.blitzreels.com/exports/xxx-thumbnail.jpg",
"frame": 30,
"frame_seconds": 1,
"selection_mode": "smart_title_card",
"rationale": "Opening title-card hook: EMAIL IS YOUR REAL AUDIENCE"
},
"platform_metadata": {
"youtube": {
"title": "Why an Email List Beats Platform Followers",
"description": "Why an Email List Beats Platform Followers\n\nOpening title-card hook: EMAIL IS YOUR REAL AUDIENCE",
"hashtags": ["shorts", "email", "list"]
}
},
"expires_at": "2026-02-05T10:00:00Z",
"file_size_bytes": 15234567,
"duration_seconds": 32
}List Exports for a Project
curl https://www.blitzreels.com/api/v1/projects/{project_id}/exports \
-H "Authorization: Bearer $BLITZREELS_API_KEY"Polling Strategy
- Poll every 3 to 5 seconds for short jobs.
- Back off to 10 to 20 seconds for long jobs.
- Use webhooks for large batch runs.