Info

For AI agents: docs index at /docs/llms.txt; any page as Markdown by adding .md to its URL.

Fetch metadata for a YouTube video without queueing a download.

Endpoints

Submit a video-info job

post /info

Queue a job that fetches metadata for a YouTube video — title and duration. Returns a jobId that you poll on GET /info/{jobId}.

Set includeAudioTracks: true to also resolve the list of available audio tracks (original + dubbed languages, if any). Audio tracks require a full extraction, which is slower and can occasionally fail on hard-to-reach videos — only request them when you need to pick an audio language ahead of a download.

Useful for showing video details in your UI before queueing a download, or for picking an audio language ahead of time.

Job state is kept in Redis with a 1-hour TTL — make sure to poll within that window.

Cost: 1 info request from your plan's info quota, on success only. No bandwidth cost. Failures are not charged.

Get video-info job status

get /info/{jobId}

Poll the status of a previously-submitted video-info job.

pending — still fetching metadata
success — result contains the resolved VideoInfo
failed — error carries a human-readable message and, for recognised video conditions, errorCode identifies it (see DownloadErrorCode)

Job state expires from Redis 1 hour after submission; polling after that returns 404.

Cost: Free — polling is never charged.