Skip to main content
POST
List channel videos

Description

This endpoint retrieves all videos from a YouTube channel with detailed information including views, publish dates, and metadata. Supports pagination for channels with many videos.

Endpoint

Headers

  • Content-Type: application/json
  • Authorization: Bearer <API_KEY> (required)

Request Body

Note: At least one of channelId or handle is required.

Accepted Values for sort

Responses

Success (200)

Returns an array of videos from the specified channel 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

  • Either channelId or handle must be provided
  • Channel handles should include the @ symbol (e.g., “@channelname”)
  • The continuationToken from the response can be used to fetch additional videos
  • Setting includeExtras to “true” will include video descriptions and engagement metrics but may slow down the response
  • 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

Fetch videos from a channel with optional pagination. Supply either channelId or handle.

channelId
string
handle
string
continuationToken
string

Token from a previous response for pagination.

sort
enum<string>

Sort order for the result set.

Available options:
latest,
popular,
newest
includeExtras
string

Optional upstream flag forwarded to the provider 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

A page of channel videos.

success
boolean

Present on some responses from the upstream provider.

videos
object[]

Present when returning long-form uploads.

shorts
object[]

Present when returning Shorts.

continuationToken
string | null