Get video-info job status

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

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.

GET
/info/{jobId}

Authorization

Bearer token. API key issued from the dashboard, sent as Authorization: Bearer YOUR_API_KEY. Get a key at https://vidkraken.com/login.

Parameters

  • jobId (path, string, required)

    The jobId returned from POST /info.

    Example: 6f9c1234-5e8a-4b2f-9c1e-0a7b69cfc45e.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://vidkraken.com/api/v2/info/6f9c1234-5e8a-4b2f-9c1e-0a7b69cfc45e" \  -H "Authorization: Bearer YOUR_API_KEY"

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

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

{
  "error": "Download job not found",
  "code": "NOT_FOUND"
}
{
  "error": "Failed to enqueue download job",
  "code": "INTERNAL_ERROR"
}
Vid Kraken Docs