List TikTok trending feed

List currently trending TikTok posts for a region.

GET/v1/tiktok/feed/trending
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
regionstringrequiredquery

Two-letter ISO 3166-1 country code for the request.

trimbooleanoptionalquery

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

Response fields
40

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

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

Responses

Trending TikTok posts for this request.