YouTube
YouTube youTube Search API
Scrape YouTube search results. Call the YouTube youTube Search API and get JSON back in one request. 1 credit per call. Failed calls cost nothing.
POST
Scrape YouTube search results
Scrape YouTube search results.
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 youTube Transcript: Accepts
videoUrl. Scrape a YouTube video’s transcript. - YouTube youTube Video: Accepts
videoUrl. Scrape a YouTube video page. - YouTube youTube Comments: Accepts
videoUrl. Scrape the comments of a YouTube video. - YouTube youTube Channel: Accepts
channelUrl. Scrape a YouTube channel and its videos.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Cut every text value in the response to this many characters. A value that was cut ends with …, and a page whose text was cut has isTruncated set to true. A screenshot is never cut. Leave it out to get the full text.
Required range:
x >= 1Body
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