Skip to content

Search YouTube (POST)

POST
/v1/youtube-search

Search YouTube videos with pagination.

Credits: 1 per request.

Accepts the same fields as JSON instead of query parameters.

object
query

Search query.

string
continuation

Pagination token from previous response.

string

Extracted data.

object
videos
Array<object>
object
type
string
id
string
url
string
title
string
description
string
thumbnail
string
view_count_text
string
view_count_int
number
published_time_text
string
published_time
string
length_text
string
length_seconds
number
channel_id
string
channel_name
string
channel_url
string
badges
Array<string>
shorts
Array<object>
object
type
string
id
string
url
string
title
string
thumbnail
string
view_count_text
string
view_count_int
number
channels
Array<object>
object
type
string
id
string
url
string
name
string
handle
string
thumbnail
string
description
string
subscriber_count
string
video_count
string
continuation_token
string
has_more
boolean
X-Credits-Used
integer

Credits consumed.

X-Credits-Remaining
integer

Remaining credit balance.

Missing or invalid API key.

object
error
required
string
Example
invalid request
field

Field that failed validation.

string
detail
string
hint
string

Insufficient unreserved credits.

object
error
required
string
Example
insufficient credits
required
required
integer
available
required
integer

Request, concurrency, or plan limit exceeded.

One of:
object
error
required
string
Example
invalid request
field

Field that failed validation.

string
detail
string
hint
string
Retry-After
integer

Seconds to wait when supplied.