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
channelId
or handle
is required.
Accepted Values for sort
Value | Description |
---|---|
latest | Sort by most recently published |
popular | Sort by most popular (views/engagement) |
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
orhandle
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 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
- Option 1
- Option 2
Fetch videos from a channel with optional pagination.
Token from a previous response for pagination.
Required range:
1 <= x <= 50
Sort order for the result set.
Available options:
latest
, popular
, newest
Include engagement counts and descriptions. Slower response.
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