Skip to main content
POST
Search YouTube

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

Accepted Values for sortBy

Accepted Values for filter

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 10 credits 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

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
query
string
required
uploadDate
string

Optional upload-date filter forwarded to the upstream provider.

sortBy
string

Optional sort mode forwarded to the upstream provider.

filter
string

Optional result filter forwarded to the upstream provider.

continuationToken
string
includeExtras
string

Optional upstream flag forwarded to request additional metadata.

requestSource
enum<string>

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

Response

Search results returned.

videos
object[]
channels
object[]
playlists
object[]
shorts
object[]
continuationToken
string | null