Skip to main content
GET
YouTube Search Advanced
Beta catalog endpoint. Provider activation and live verification are in progress. An unavailable operation returns HTTP 503 and uses no credits.

Authorizations

x-api-key
string
header
required

Headers

Cache-Control
string
Idempotency-Key
string

Query Parameters

query
string
required
order
string
duration
string
event_type
string
license
string
category
string
region
string
language
string
published_after
string
published_before
string
channel_id
string
max_results
integer
cursor
string
video_caption
string
video_definition
string
video_dimension
string
video_embeddable
string
video_type
string
topic_id
string
location
string
location_radius
string
includeExtras
string
include
enum<string>
Available options:
channel
since
string
until
string
min_views
integer
Required range: x >= 0
max_age_days
integer
Required range: 1 <= x <= 3650
sort_rows
enum<string>
Available options:
views
max_pages
integer
Required range: 1 <= x <= 5
seen
string

Response

Successful response. data is specific to this operation.

success
boolean
required
platform
string
required
endpoint
string
required
credits_used
integer
required
Required range: x >= 0
credits_remaining
integer | null
required
request_id
string
required
cached
boolean
required
data
object
required

Operation-specific data. Fields depend on the endpoint and upstream response; unavailable metrics may be null.