List / search videos

GET

/videos

const url = 'https://api.devstreamcore.com/v1/videos?status=ready';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.devstreamcore.com/v1/videos?status=ready' \
  --header 'Authorization: Bearer <token>'

Cursor-paginated. Pass ?q= for FTS5 full-text search (single page).

Authorizations

ApiKey

Parameters

Query Parameters

cursor

<created_at>|<id> from a prior next_cursor

string

<created_at>|<id> from a prior next_cursor

limit

Page size, 1–100 (default 25)

string

Page size, 1–100 (default 25)

status

string

Allowed values: ready preparing errored

Full-text search (FTS5); returns a single page

string

Full-text search (FTS5); returns a single page

Responses

200

A page of videos

application/json

object

data

required

Array<object>

A video asset. The shape is stable — fields are only ever added.

object

required

string

title

required

string

description

required

string | null

thumbnail_url

required

string | null

status

required

string

Allowed values: preparing ready errored reprocessing

progress

required

0–100, aggregated across encode + package jobs

number

transcode_attempts

required

number | null

duration

required

Seconds

number | null

file_size_bytes

required

number | null

video_codec

required

string | null

fps

required

number | null

source_url

required

Public URL of the original upload; null until landed in R2

string | null

source_width

required

Native width of the original upload (px); null when unknown

number | null

source_height

required

Native height of the original upload (px); null when unknown

number | null

creator_username

required

string | null

playback

required

object

hls

required

string | null

dash

required

string | null

mp4

required

Array<object>

object

height

required

number

url

required

string

bitrate_kbps

required

Encode target bitrate in kb/s; null on legacy rows

number | null

hls

required

Per-resolution HLS variant playlist URL; null when ungated

string | null

playback_ids

required

Array<object>

object

required

string

policy

required

string

Allowed values: public signed

created_at

required

string

policy

required

string

Allowed values: public signed

passthrough

required

string | null

ingest

required

object

kind

required

string

Allowed values: direct_upload url console

errors

required

Array<object>

object

type

required

string

messages

required

Array<string>

view_count

required

number

tags

required

Array<string>

created_at

required

string

updated_at

required

string

has_more

required

boolean

next_cursor

required

string | null

Example

{
  "data": [
    {
      "id": "vid_a1b2c3d4e5f6a1b2c3d4",
      "status": "preparing",
      "playback_ids": [
        {
          "id": "play_a1b2c3d4e5f6a1b2c3d4",
          "policy": "public"
        }
      ],
      "policy": "public",
      "ingest": {
        "kind": "direct_upload"
      }
    }
  ]
}

401

Missing or invalid API key

application/json

Error envelope — a single error per response.

object

error

required

object

type

required

string

Allowed values: invalid_request_error authentication_error permission_error not_found rate_limit_error quota_exceeded api_error

code

string

message

required

string

param

string

request_id

string

Example

{
  "error": {
    "type": "invalid_request_error"
  }
}

429

Rate limited — apply backoff

application/json

Error envelope — a single error per response.

object

error

required

object

type

required

string

Allowed values: invalid_request_error authentication_error permission_error not_found rate_limit_error quota_exceeded api_error

code

string

message

required

string

param

string

request_id

string

Example

{
  "error": {
    "type": "invalid_request_error"
  }
}