Social Fetch
YouTube

List trending YouTube Shorts

Discover currently trending YouTube Shorts.

Typically returns about 48 trending Shorts per call. Repeat the same request for another fresh batch (new and overlapping Shorts are both possible). No cursor or page parameters.

An empty `data.shorts` array means no trending Shorts were available for that call (you normally receive about 48 when the feed is populated).

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

API key (`sfk_...`)

Response fields
29

Endpoint-specific response payload.

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

Description text when available.

datashorts[]thumbnailUrl
stringnullable

Thumbnail image URL when available.

datashorts[]viewCount
integernullable

View count when available.

≥ 0

datashorts[]viewCountText
stringnullable

Human-readable view count label when available.

datashorts[]likeCount
integernullable

Like count when available.

≥ 0

datashorts[]likeCountText
stringnullable

Human-readable like count label when available.

datashorts[]commentCount
integernullable

Comment count when available.

≥ 0

datashorts[]commentCountText
stringnullable

Human-readable comment count label when available.

datashorts[]publishedAt
stringnullable

Publication timestamp when available.

datashorts[]publishedDateText
stringnullable

Human-readable publication date label when available.

Channel metadata when available.

datashorts[]channelid
stringnullable

Channel identifier when available.

datashorts[]channelurl
stringnullable

Channel URL when available.

datashorts[]channelhandle
stringnullable

Channel handle when available.

datashorts[]channeltitle
stringnullable

Channel title when available.

Keyword tags associated with the Short when available.

datashorts[]keywords[]
stringoptional
datashorts[]durationMs
integernullable

Duration of the Short in milliseconds when available.

≥ 0

datashorts[]durationText
stringnullable

Formatted duration label when available.

datatotalResults
integer

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

≥ 0

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/shorts/trending" \
  -H "x-api-key: YOUR_API_KEY"

Responses

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

On this page

No Headings