Social Fetch
TikTok

List TikTok trending feed

Discover currently trending TikTok posts.

Repeat the same request for a fresh trending batch. New and overlapping posts are both possible. No cursor or page parameters.

An empty `data.items` array means no trending posts were available for that request.

GET/v1/tiktok/feed/trending
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
2
region*stringquery

Two-letter region code for the request.

min 1 chars

trimbooleanoptionalquery

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

Response fields
38

Endpoint-specific response payload.

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

Core identity and media type for a trending TikTok post.

dataitems[]videoid
string

TikTok post identifier.

min 1 chars

dataitems[]videourl
stringnullable

Canonical public TikTok URL for the post.

dataitems[]videocaption
stringnullable

Caption text.

dataitems[]videocreatedAt
stringnullable

ISO-8601 timestamp when the post was created.

dataitems[]videoregion
stringnullableoptional

Two-letter country code when available.

dataitems[]videodurationMs
integernullable

Duration in milliseconds when available.

≥ 0

dataitems[]videomediaType
string

Whether the post is a video or photo slideshow.

one of: video, slideshow

dataitems[]videoisAd
boolean

Whether TikTok marks the post as an ad.

Creator of the trending post when available.

dataitems[]authorplatformUserId
stringoptional

Numeric user id.

dataitems[]authorsecUid
stringoptional

Stable opaque user id.

dataitems[]authorhandle
stringnullableoptional

Public username without a leading @.

dataitems[]authornickname
stringnullableoptional

Display name.

dataitems[]authorverified
booleanoptional

Whether the account is verified.

dataitems[]authoravatarUrl
stringnullableoptional

Profile picture URL.

dataitems[]authorsignature
stringnullableoptional

Profile bio text.

dataitems[]authorregion
stringnullableoptional

Two-letter country code when available.

Engagement metrics for a trending post.

dataitems[]metricsviews
integer

View count.

≥ 0

dataitems[]metricslikes
integer

Like count.

≥ 0

dataitems[]metricscomments
integer

Comment count.

≥ 0

dataitems[]metricsshares
integer

Share count.

≥ 0

dataitems[]metricssaves
integer

Save or collection count.

≥ 0

Media URLs for a trending post.

dataitems[]mediathumbnailUrl
stringnullable

Thumbnail or cover image URL.

dataitems[]mediadownloadUrl
stringnullable

Best available downloadable video URL.

dataitems[]mediadownloadWithoutWatermarkUrl
stringnullable

Download URL without watermark when available.

Ordered image URLs for photo slideshow posts.

dataitems[]mediaslideshowImages[]
stringoptional
dataitems[]details
objectoptional

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

datatotalResults
integer

Number of posts in data.items for this response.

≥ 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/tiktok/feed/trending?region=US" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Trending TikTok posts for this request.

On this page

No Headings