How it Works

​

Operating Principle

1. Create a Download Job
   • Make a request to GET /api/v1/video/download with the video URL
   • You’ll receive a job_id in response
2. Monitor Job Status
   • Use the received job_id to check progress via GET /api/v1/jobs/{job_id}
   • You can make this request as many times as needed at no additional cost
   • The status can be:
     • QueuedJob: The job is being processed
     • CompletedJob: The job is complete
3. Get the Result
   • Once the job is complete (CompletedJob), you’ll have access to the download URL in the response
   • The video remains available on our servers for 24 hours
   • You must download it to your own server to keep it longer

​

HTTP Status Codes

• 201 Created: Job successfully created and queued for processing
• 200 OK: Successfully retrieved job status or download information
• 400 Bad Request: Invalid input (malformed URL, unsupported video platform)
• 404 Not Found: Job ID doesn’t exist

​

Processing Time

​

Error Handling

• The video is private
• The video is no longer available
• The video has age restrictions
• A technical error from HuntAPI