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 channelIdorhandlemust be provided
- Channel handles should include the @ symbol (e.g., “@channelname”)
- The continuationTokenfrom the response can be used to fetch additional videos
- Setting includeExtrasto “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 continuationTokento 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
Fetch videos from a channel with optional pagination. Supply either channelId or handle.
Token from a previous response for pagination.
Required range: 
1 <= x <= 50Sort 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