Get videos by IDs

Retrieves video data for a comma-separated list of video IDs

GET /media/video/{ids}

Get videos by IDs

cURL

curl --request GET \
  --url https://api.example.com/media/video/{ids}

200

{
  "system": "<string>",
  "id": "<string>",
  "originId": "<string>",
  "provider": "<string>",
  "url": "<string>",
  "title": "<string>",
  "thumbnail": "<string>",
  "status": "<string>",
  "owner": "<string>",
  "recipientId": "<string>",
  "readyTimestamp": "2023-11-07T05:31:56Z",
  "paymentId": "<string>"
}

Path Parameters

ids · string · required

Comma-separated video IDs

Response

200 - application/json

List of videos retrieved successfully

Video data entity

system · string · required

id · string

Unique video identifier

originId · string

Original video ID from provider

provider · string

Video provider (e.g., youtube)

url · string

Video URL

title · string

Video title

thumbnail · string

Video thumbnail URL

status · string

Video status

owner · string | null

Owner of the video

recipientId · string | null

Recipient ID associated with this video

readyTimestamp · string<date-time> | null

Timestamp when video is ready

paymentId · string | null

Payment ID associated with this video