Submit a video-info job

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.

Server URLloading...

POST

/info

Send

Authorization

Header

Body

Authorization

Parameters

Response Body

curl -X POST "https://vidkraken.com/api/v2/info" \  -H "Authorization: Bearer YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{"url":"https://youtu.be/dQw4w9WgXcQ"}'

{
  "jobId": "6f9c1234-5e8a-4b2f-9c1e-0a7b69cfc45e",
  "status": "pending"
}

{
  "error": "Missing required field: url",
  "code": "INVALID_REQUEST"
}

{
  "error": "Missing API key. Provide it as 'Bearer YOUR_API_KEY'",
  "code": "UNAUTHORIZED"
}

{
  "error": "Credit limit reached",
  "code": "LIMIT_REACHED"
}

{
  "error": "A request with this Idempotency-Key is still being processed. Retry shortly.",
  "code": "IDEMPOTENCY_CONFLICT"
}

{
  "error": "This Idempotency-Key was already used with a different request body. Use a new key.",
  "code": "IDEMPOTENCY_KEY_REUSED"
}

{
  "error": "Failed to enqueue download job",
  "code": "INTERNAL_ERROR"
}