Social Fetch
YouTube

List YouTube channel shorts

Get Shorts published by a specific YouTube channel.

Use `data.lookupStatus` to distinguish a resolved empty result from `not_found`.

An empty `data.shorts` array can still mean `data.lookupStatus: "found"` when the channel resolves but the returned page has no Shorts.

GET/v1/youtube/channels/shorts
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
4
channelIdstringquery

Optional YouTube channel id for the request.

min 1 chars · max 4096 chars

handlestringquery

Optional YouTube channel handle for the request.

sortBystringquery

Optional sort order for the returned YouTube Shorts.

one of: latest, popular

cursorstringquery

Opaque pagination cursor returned by a previous response.

min 1 chars

Response fields
24

Endpoint-specific response payload.

datalookupStatus
string

Whether the channel was resolved for this request.

one of: found, not_found

YouTube Shorts returned for the resolved channel. This array may be empty when the channel resolves but there are no Shorts in the returned page.

datashorts[]id
string

YouTube Short identifier.

min 1 chars

datashorts[]url
stringnullable

Canonical public YouTube URL for the Short.

datashorts[]title
stringnullable

Title shown for the Short.

datashorts[]description
stringnullable

Short description text when available.

datashorts[]viewCount
integernullable

View count for the Short when available.

≥ 0

datashorts[]viewCountText
stringnullable

Human-readable view count label when available.

datashorts[]commentCount
integernullableoptional

Comment count for the Short when available.

≥ 0

datashorts[]commentCountText
stringnullableoptional

Human-readable comment count label when available.

datashorts[]likeCount
integernullableoptional

Like count for the Short when available.

≥ 0

datashorts[]likeCountText
stringnullableoptional

Human-readable like count label when available.

datashorts[]publishDate
stringnullableoptional

Publication timestamp label when available.

datashorts[]genre
stringnullableoptional

Category or genre label when available.

datashorts[]durationMs
integernullableoptional

Duration of the Short in milliseconds when available.

≥ 0

datashorts[]durationFormatted
stringnullableoptional

Formatted duration label when available.

Pagination information for the current response.

datapagenextCursor
stringnullable

Cursor to pass in the next request when another page exists.

datapagehasMore
boolean

Whether another page of Shorts is available.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/youtube/channels/shorts?handle=charlidamelio" \
  -H "x-api-key: YOUR_API_KEY"

Responses

YouTube Shorts for the requested channel. Check `data.lookupStatus` for `found` vs `not_found`.

On this page

No Headings