Skip to main content
GET
Get Metadata Task

GET /api/v1/sports/extract-metadata/

Poll the status of a metadata extraction task and retrieve results when complete.

Path Parameters

Response

Example Request

Example Response (Processing)

Example Response (Completed)

Example Response (Failed)

Polling Strategy

Recommended polling intervals:
  • First minute: every 5 seconds
  • After 1 minute: every 15 seconds
  • After 5 minutes: every 30 seconds

Using Results with Highlights

The extracted metadata can be passed to the Generate Highlights endpoint for enhanced accuracy:

Path Parameters

task_id
string
required

The task ID returned from the create request

Response

Task status retrieved

task_id
string
required

Task identifier

Example:

"task_abc123xyz"

status
enum<string>
required

Current task status

Available options:
pending,
processing,
completed,
failed
Example:

"completed"

progress
integer
required

Progress percentage (0-100)

Required range: 0 <= x <= 100
Example:

100

created_at
string<date-time>
required

When the task was created

completed_at
string<date-time>

When the task completed (if finished)

result
object
error
object