Description
This endpoint retrieves all YouTube Shorts from a channel. Provides basic information about each short including title, thumbnail, and view counts. For detailed information about specific shorts, use the Video Details endpoint.Endpoint
Headers
- Content-Type: application/json
- Authorization: Bearer <API_KEY>(required)
Request Body
channelId or handle is required.
Accepted Values for sort
| Value | Description | 
|---|---|
| newest | Sort by most recently published shorts | 
| popular | Sort by most popular shorts (views) | 
Responses
Success (200)
Returns an array of shorts 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 shorts
- This endpoint provides basic short information only - use the Video Details endpoint for complete metadata, descriptions, and transcripts
- This endpoint uses 1 credit per request
- Results are paginated - use the continuationTokento retrieve additional pages
- Some channels may not have any shorts available
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