Skip to main content
POST
Search YouTube videos, channels, playlists and shorts
  • Endpoint: youtube.search
  • Returns: data has results.
  • Cost: 1 credit per 20 items, at least 1 credit. Failed calls cost nothing.
  • Paging: Yes. Send the cursor from the response to get the next page. See Paging.

Example

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
Required string length: 1 - 400
type
enum<string>
default:videos
Available options:
videos,
all,
channels,
playlists,
shorts
duration
enum<string>
default:all
Available options:
all,
short,
medium,
long
within
enum<string>
default:all
Available options:
hour,
day,
week,
month,
year,
all
sort
enum<string>
default:relevance
Available options:
relevance,
top
features
enum<string>[]
Maximum array length: 9
Available options:
360,
live,
4k,
hd,
subtitles,
creativeCommons,
vr180,
3d,
hdr
country
string
default:us

ISO 3166-1 alpha-2 country code, e.g. us. Any case is accepted.

Pattern: ^[A-Za-z]{2}$
language
string
default:en

BCP 47 language tag, e.g. en or pt-BR. Any case is accepted.

Pattern: ^[A-Za-z]{2,3}(?:[-_][A-Za-z0-9]{2,4})?$
limit
integer
default:20
Required range: 1 <= x <= 100
cursor
string
Required string length: 1 - 4096

Response

The data, and the credits this call used.

success
any
required
data
object
required
creditsUsed
integer
required
requestId
string
required