Skip to main content
POST
List channel shorts

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

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

Accepted Values for sort

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 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 shorts
  • This endpoint provides basic short information only - use the Video Details endpoint for complete metadata, descriptions, and transcripts
  • This endpoint uses 10 credits 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

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Fetch Shorts 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
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 shorts.

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