Social Fetch
YouTube

List trending YouTube Shorts

Discover currently trending YouTube Shorts.

Operation

GET/v1/youtube/shorts/trending

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Response fields

data
objectrequired

Endpoint-specific response payload.

datashorts
arrayrequired

Trending YouTube Shorts for this request—typically about 48 items. Call the endpoint again for another fresh batch that may include Shorts not returned earlier.

datashorts[]id
stringrequired

YouTube Short identifier.

min 1 chars

datashorts[]url
stringrequirednullable

Canonical public YouTube URL for the Short.

datashorts[]title
stringrequirednullable

Title shown for the Short.

datashorts[]description
stringrequirednullable

Description text when available.

datashorts[]thumbnailUrl
stringrequirednullable

Thumbnail image URL when available.

datashorts[]viewCount
integerrequirednullable

View count when available.

≥ 0

datashorts[]viewCountText
stringrequirednullable

Human-readable view count label when available.

datashorts[]likeCount
integerrequirednullable

Like count when available.

≥ 0

datashorts[]likeCountText
stringrequirednullable

Human-readable like count label when available.

datashorts[]commentCount
integerrequirednullable

Comment count when available.

≥ 0

datashorts[]commentCountText
stringrequirednullable

Human-readable comment count label when available.

datashorts[]publishedAt
stringrequirednullable

Publication timestamp when available.

datashorts[]publishedDateText
stringrequirednullable

Human-readable publication date label when available.

datashorts[]channel
objectrequirednullable

Channel metadata when available.

datashorts[]channelid
stringrequirednullable

Channel identifier when available.

datashorts[]channelurl
stringrequirednullable

Channel URL when available.

datashorts[]channelhandle
stringrequirednullable

Channel handle when available.

datashorts[]channeltitle
stringrequirednullable

Channel title when available.

datashorts[]keywords
arrayrequired

Keyword tags associated with the Short when available.

datashorts[]keywords[]
string
datashorts[]durationMs
integerrequirednullable

Duration of the Short in milliseconds when available.

≥ 0

datashorts[]durationText
stringrequirednullable

Formatted duration label when available.

datatotalResults
integerrequired

Number of Shorts in `data.shorts` for this response (typically about 48 when the feed is available).

≥ 0

meta
objectrequired

Metadata describing the request and billing outcome.

metarequestId
stringrequired

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integerrequired

Credits charged for this request.

≥ 0

metaversion
stringrequired

Public API version that served the response.

one of: v1

Code example

Responses

Trending YouTube Shorts for this request (typically about 48; see `data.totalResults`).

Error codes

insufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page