Skip to main content
POST
Submit YouTube Search task

YouTube Search

Search public videos using stable, provider-independent filters.
results_limit defaults to 100. Results use the normalized video structure documented in YouTube Videos, with resource set to search.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
query
string
required

YouTube search query.

Minimum string length: 1
results_limit
integer
default:100
Required range: x >= 1
sort_by
enum<string>
default:relevance
Available options:
relevance,
date,
rating,
view_count
published_within
enum<string>
Available options:
hour,
day,
week,
month,
year
duration
enum<string>
Available options:
short,
medium,
long
has_captions
boolean
callback_url
string<uri>

Optional callback URL.

Response

Task submitted

code
integer
Example:

200

data
object