Skip to main content
POST
Search YouTube videos, channels, playlists and shorts
Searches YouTube videos, channels, playlists and shorts.

Request

query is required.
This endpoint can be called without an API key, subject to per-address limits. Pagination requires a key.

Response

If successful, the response body contains the standard envelope. data.results[] contains videos, channels and playlists, and each row has a type. The following example is a real response, truncated: each list shows one item and long strings are cut.
For every field, see the response schema on this page.

Optional parameters

Billing

Each successful request consumes 1 credit, regardless of the number of items returned. Requests that fail, or that return no items, are not billed.

Pagination

Results are paginated. To retrieve the next page, pass the value of data.cursor as cursor in a subsequent request. A response that omits cursor is the last page.
  • YouTube transcript: Accepts videoUrl. Returns what a YouTube video says, from its captions.
  • YouTube video: Accepts videoUrl. Returns a video’s stats, description, chapters and most replayed moments.
  • YouTube comments: Accepts videoUrl. Returns a video’s comments, or the replies to one comment.
  • YouTube channel: Accepts channelUrl. Returns a channel’s profile and one tab of videos, shorts, live, playlists, podcasts or posts.

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>

Leave out for videos, channels and playlists. Use shorts for Shorts.

Available options:
videos,
shorts,
channels,
playlists,
movies
duration
enum<string>
Available options:
under3Minutes,
3to20Minutes,
over20Minutes
uploadDate
enum<string>
Available options:
today,
thisWeek,
thisMonth,
thisYear
features
enum<string>[]
Maximum array length: 11
Available options:
360,
live,
4k,
hd,
subtitles,
creativeCommons,
vr180,
3d,
hdr,
location,
purchased
prioritize
enum<string>
default:relevance
Available options:
relevance,
popularity
cursor
string

The cursor from the previous response. Send it as is.

Minimum string length: 1

Response

The data, and the credits this call used.

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