YouTube
YouTube search API
Search YouTube videos, channels, playlists and shorts. Call the YouTube search API for JSON. 1 credit per call. Every call returns the same flat shape.
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 ofdata.cursor as cursor in a subsequent request. A response that omits cursor is the last page.
Related methods
- 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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Required string length:
1 - 400Leave out for videos, channels and playlists. Use shorts for Shorts.
Available options:
videos, shorts, channels, playlists, movies Available options:
under3Minutes, 3to20Minutes, over20Minutes Available options:
today, thisWeek, thisMonth, thisYear Maximum array length:
11Available options:
360, live, 4k, hd, subtitles, creativeCommons, vr180, 3d, hdr, location, purchased Available options:
relevance, popularity The cursor from the previous response. Send it as is.
Minimum string length:
1