Douyin

Get Douyin trending

Get Douyin's hot search board: about 50 trending phrases with heat scores, plus the rising list.

GET/v1/douyin/trending
x-api-keystringheader

API key (`sfk_...`)

Response fields
32

Endpoint-specific response payload.

dataupdatedAt
stringnullable

When Douyin last updated the board, ISO 8601 UTC.

The hot search board: about 50 phrases, pinned entry first.

dataitems[]rank
integernullable

Position on the board, from 1; null for the pinned entry.

dataitems[]isPinned
boolean

True for the entry Douyin pins above the ranked list.

dataitems[]word
string

The trending search phrase.

dataitems[]hotValue
integernullable

Douyin's heat score for the phrase.

dataitems[]views
integernullable

Views of the phrase's topic page, when Douyin reports it.

dataitems[]videoCount
integernullable

Videos Douyin groups under the phrase.

dataitems[]labelCode
integernullable

Douyin's badge code beside the phrase (0 none; others mark new, hot, exclusive, live and so on).

dataitems[]labelImageUrl
stringnullable

The badge image Douyin shows, when any.

dataitems[]coverUrl
stringnullable

The phrase's cover image. Signed; it expires.

dataitems[]eventTime
stringnullable

When the event behind the phrase happened, ISO 8601 UTC.

dataitems[]url
string

Douyin's search page for the phrase.

The rising phrases Douyin shows beside the board.

datarising[]rank
integernullable

Position on the board, from 1; null for the pinned entry.

datarising[]isPinned
boolean

True for the entry Douyin pins above the ranked list.

datarising[]word
string

The trending search phrase.

datarising[]hotValue
integernullable

Douyin's heat score for the phrase.

datarising[]views
integernullable

Views of the phrase's topic page, when Douyin reports it.

datarising[]videoCount
integernullable

Videos Douyin groups under the phrase.

datarising[]labelCode
integernullable

Douyin's badge code beside the phrase (0 none; others mark new, hot, exclusive, live and so on).

datarising[]labelImageUrl
stringnullable

The badge image Douyin shows, when any.

datarising[]coverUrl
stringnullable

The phrase's cover image. Signed; it expires.

datarising[]eventTime
stringnullable

When the event behind the phrase happened, ISO 8601 UTC.

datarising[]url
string

Douyin's search page for the phrase.

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

Responses

Douyin's hot search board.