Social Fetch
TikTok

List TikTok trending feed

Discover currently trending TikTok posts.

Operation

GET/v1/tiktok/feed/trending

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

regionstringrequired(query)

Two-letter region code for the request.

min 1 chars

trimboolean(query)

When true, requests a smaller response with fewer optional fields.

Response fields

data
objectrequired

Endpoint-specific response payload.

dataitems
arrayrequired

Trending TikTok posts for this request. Repeat the same request for a fresh batch that may include new and overlapping posts.

dataitems[]video
objectrequired

Core identity and media type for a trending TikTok post.

dataitems[]videoid
stringrequired

TikTok post identifier.

min 1 chars

dataitems[]videourl
stringrequirednullable

Canonical public TikTok URL for the post.

dataitems[]videocaption
stringrequirednullable

Caption text.

dataitems[]videocreatedAt
stringrequirednullable

ISO-8601 timestamp when the post was created.

dataitems[]videoregion
stringnullable

Two-letter country code when available.

dataitems[]videodurationMs
integerrequirednullable

Duration in milliseconds when available.

≥ 0

dataitems[]videomediaType
stringrequired

Whether the post is a video or photo slideshow.

one of: video, slideshow

dataitems[]videoisAd
booleanrequired

Whether TikTok marks the post as an ad.

dataitems[]author
objectrequirednullable

Creator of the trending post when available.

dataitems[]authorplatformUserId
string

Numeric user id.

dataitems[]authorsecUid
string

Stable opaque user id.

dataitems[]authorhandle
stringnullable

Public username without a leading @.

dataitems[]authornickname
stringnullable

Display name.

dataitems[]authorverified
boolean

Whether the account is verified.

dataitems[]authoravatarUrl
stringnullable

Profile picture URL.

dataitems[]authorsignature
stringnullable

Profile bio text.

dataitems[]authorregion
stringnullable

Two-letter country code when available.

dataitems[]metrics
objectrequired

Engagement metrics for a trending post.

dataitems[]metricsviews
integerrequired

View count.

≥ 0

dataitems[]metricslikes
integerrequired

Like count.

≥ 0

dataitems[]metricscomments
integerrequired

Comment count.

≥ 0

dataitems[]metricsshares
integerrequired

Share count.

≥ 0

dataitems[]metricssaves
integerrequired

Save or collection count.

≥ 0

dataitems[]media
objectrequired

Media URLs for a trending post.

dataitems[]mediathumbnailUrl
stringrequirednullable

Thumbnail or cover image URL.

dataitems[]mediadownloadUrl
stringrequirednullable

Best available downloadable video URL.

dataitems[]mediadownloadWithoutWatermarkUrl
stringrequirednullable

Download URL without watermark when available.

dataitems[]mediaslideshowImages
array

Ordered image URLs for photo slideshow posts.

dataitems[]mediaslideshowImages[]
string
dataitems[]details
object

Additional TikTok-native fields for this post, excluding fields already shown above.

datatotalResults
integerrequired

Number of posts in data.items for this response.

≥ 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 TikTok posts for this request.

Error codes

bad_requestinsufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page