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
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 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
continuationToken
to 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
- 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