Search a video provider
Discovery
Search a video provider
Searches the selected external provider. Cache hits cost less than fresh upstream retrieval.
GET
Search a video provider
Authorizations
Permanent personal API key created in the dashboard. Example: curl -H "Authorization: Bearer aty_…" https://your-host/v1/projects
Path Parameters
External video provider.
Available options:
youtube Example:
"youtube"
Query Parameters
Provider search query.
Maximum string length:
500Example:
"AI agents"
Provider entity type.
Available options:
all, video, channel, playlist Restrict search to a channel.
Preferred language code.
Example:
"en"
Video duration bucket.
Available options:
short, medium, long Result ordering.
Available options:
relevance, date, views, rating Only include captioned videos.
Live broadcast state.
Available options:
live, upcoming, completed Opaque token returned by a previous provider search page.