BlitzReels
BlitzReelsDocumentation

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}/jobs
  • POST /v1/projects/{project_id}/export
  • GET /v1/exports/{export_id}
  • GET /v1/projects/{project_id}/exports

Get Job Status

Terminal
curl https://www.blitzreels.com/api/v1/jobs/{job_id} \
  -H "Authorization: Bearer $BLITZREELS_API_KEY"
Response
{
  "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

Terminal
curl https://www.blitzreels.com/api/v1/projects/{project_id}/jobs \
  -H "Authorization: Bearer $BLITZREELS_API_KEY"

Start Export

Terminal
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.

Response
{
  "export_id": "export-uuid",
  "job_id": "job-export-uuid",
  "status": "queued"
}

Get Export Status

Terminal
curl https://www.blitzreels.com/api/v1/exports/{export_id} \
  -H "Authorization: Bearer $BLITZREELS_API_KEY"
Response
{
  "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

Terminal
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.

On this page

EndpointsGet Job StatusList Jobs for a ProjectStart ExportGet Export StatusList Exports for a ProjectPolling StrategyRelated