API Documentation — VideoConduit

What is VideoConduit?

VideoConduit is a REST API for downloading, processing, and analyzing video and audio content from over 1,000 platforms. Submit a URL, choose what you need — a download, transcription, translation, thumbnail, or fingerprint — and get the result back as a file or structured data. No browser automation, no fragile scraping: just clean HTTP requests and credit-based pricing.

Base URL

All API requests are made to the following base URL:

https://videoconduit.com

HTTPS Required

All API requests must use HTTPS. HTTP requests will be rejected.

API Spec & Collections

Import the API into your favorite HTTP client or use the spec for code generation:

OpenAPI Spec (JSON) Postman Collection

Insomnia users: import the OpenAPI spec directly via File → Import.

Available Endpoints

Method	Endpoint	Description	Credits
GET	/v1/info	Extract video metadata	1
POST	/v1/download	Download & process video/audio	1–2
POST	/v1/transcribe	Transcribe audio to text	3
POST	/v1/translate	Transcribe + translate	4
POST	/v1/preview	Generate GIF, thumbnail, mosaic, or clip	1
POST	/v1/fingerprint	Perceptual video fingerprinting	1
POST	/v1/comments	Extract video comments	1
GET	/v1/jobs/{id}	Get job status	Free
GET	/v1/jobs	List all jobs	Free

How It Works

Authenticate — Include your API key in the Authorization header.
Submit a request — POST to an endpoint with a source URL and options.
Poll for results — Async jobs return a job_id. Poll GET /v1/jobs/{id} until status is "completed".
Download the result — The completed job includes a download_url for the processed file.

Async Processing Model

Most endpoints (download, transcribe, translate, preview, fingerprint, comments) run asynchronously. You submit a job, receive a job_id, then poll for completion or configure webhooks for push notifications. Only the /v1/info endpoint is synchronous.

Request → pending → processing →

completed failed

Response Format

All responses are JSON. Here are the standard shapes:

Success (async job created)

{
  "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "pending",
  "credits_charged": 1
}

Error

{
  "detail": "Insufficient credits",
  "code": "insufficient_credits",
  "required": 3,
  "available": 1
}

See Error Codes for a complete reference of error responses.

API Overview