Skip to main content
GET
/
v1
/
video
/
describe
/
{jobId}
Poll video describe job status and results
curl --request GET \
  --url https://api.urltodata.ai/v1/video/describe/{jobId} \
  --header 'Authorization: Bearer <token>'
{
  "status": "pending",
  "attempts": 123,
  "maxAttempts": 123,
  "durationMs": 123,
  "error": "<string>",
  "url": "<string>",
  "summary": "<string>",
  "frames": [
    {
      "timestampSec": 123,
      "description": "<string>"
    }
  ],
  "transcript": "<string>",
  "model": "<string>",
  "frameCount": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.urltodata.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
default:your-api-key
required

API key as Bearer token (e.g. Bearer mp_abc123_secret)

Path Parameters

jobId
string
required

Response

200 - application/json

Video describe job status

status
enum<string>
Available options:
pending,
active,
completed,
failed
attempts
integer
maxAttempts
integer
durationMs
integer | null
error
string
url
string
summary
string
frames
object[]
transcript
string
model
string
frameCount
integer