Description
This endpoint searches YouTube and returns matching videos, channels, playlists, shorts, and other content types. Perfect for content discovery, research, and finding specific types of educational or business content.Endpoint
Headers
- Content-Type:
application/json
- Authorization: Bearer
<API_KEY>
(required)
Request Body
Accepted Values for uploadDate
Value | Description |
---|---|
hour | Uploaded in the last hour |
today | Uploaded today |
week | Uploaded this week |
month | Uploaded this month |
year | Uploaded this year |
Accepted Values for sortBy
Value | Description |
---|---|
relevance | Sort by relevance (default) |
date | Sort by upload date |
viewCount | Sort by view count |
rating | Sort by rating |
Accepted Values for filter
Value | Description |
---|---|
video | Videos only |
channel | Channels only |
playlist | Playlists only |
short | Shorts only |
live | Live streams only |
movie | Movies only |
Responses
Success (200)
Returns search results organized by content type with pagination support.- Content-Type: application/json
- X-RateLimit-Limit: The rate limit for the user
- X-RateLimit-Remaining: The remaining number of requests for the user
Bad Request (400)
Returned if the request is invalid or missing required parameters.Bad Gateway (502)
Returned if the external service is unavailable or returns invalid data.Internal Server Error (500)
Returned if there’s an unexpected server error.Example Request
Example Response
Notes
- The
query
parameter is required and must be a non-empty string - Use filters to narrow down results to specific content types (videos, channels, playlists, etc.)
- The
continuationToken
from the response can be used to fetch additional pages of results - Setting
includeExtras
to “true” includes additional metadata like like/comment counts but may slow down the response - Search results are organized by content type in separate arrays
- This endpoint uses 1 credit per request
- Results are paginated - use the
continuationToken
to retrieve additional pages
Rate Limiting
Rate limit headers (X-RateLimit-Limit
and X-RateLimit-Remaining
) are included in the response to indicate the user’s current rate limit status.Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/json
Available options:
videos
, shorts
, channels
Required range:
1 <= x <= 50
Optional identifier describing where the API request originated.
Available options:
API
, WEB
, MAKE_DOT_COM
, ZAPIER
, N8N
, PLAYGROUND
, DEFAULT_AUTOMATION
, AGENT_PREVIEW
, AGENT_LIVE
, AUTOPILOT
, STUDIO