Skip to main content
GET
Search a video provider

Authorizations

Authorization
string
header
required

Permanent personal API key created in the dashboard. Example: curl -H "Authorization: Bearer aty_…" https://your-host/v1/projects

Path Parameters

provider
enum<string>
required

External video provider.

Available options:
youtube
Example:

"youtube"

Query Parameters

q
string
required

Provider search query.

Maximum string length: 500
Example:

"AI agents"

type
enum<string>
default:all

Provider entity type.

Available options:
all,
video,
channel,
playlist
channel
string

Restrict search to a channel.

language
string

Preferred language code.

Example:

"en"

duration
enum<string>

Video duration bucket.

Available options:
short,
medium,
long
sort
enum<string>

Result ordering.

Available options:
relevance,
date,
views,
rating
captions
boolean

Only include captioned videos.

live
enum<string>

Live broadcast state.

Available options:
live,
upcoming,
completed
continuation
string

Opaque token returned by a previous provider search page.

Response

Provider search results.

query
string
required
results
object[]
required
meta
object
required
continuation
string
estimatedTotal
integer
Required range: x >= 0