List trending YouTube Shorts

List currently trending YouTube Shorts.

GET/v1/youtube/shorts/trending
1credit
x-api-keystringheader

API key (`sfk_...`)

Response fields
31

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

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

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`).