douyin

Douyin trend-index creator top videos

Get the videos the platform's own index tool lists as a Douyin account's top videos for a span of up to 30 days, by the account's numeric ID: up to twenty, most liked first, each with caption, link, day published, its engagement counts and followers gained. As recorded, the tool picks from what was published on the last day or two of the span, not from all of it: set the end date to the day you want. One page; no view counts.

Price: $0.002 per call.

20 items on a usual page, 20 at most. Given whole: there is no next page.

An account that does not exist cannot be told from an account with no videos in the span: both return an empty result, not a 404.

get/v1/douyin/index/creators/videos/list

Request

  • Base URL
    https://api.dataxapi.com
  • Auth
    HTTP bearer

Query parameters

idstring required

The account's numeric Douyin ID (uid), a string of digits; not the token starting with MS4w that the profile endpoint takes. Nor is it the Douyin handle (username, often digits too): the uid is ext.uid in what douyin.users.get returns with view=full. Accounts with very few followers have no such data (a few hundred followers failed, over thirty thousand worked when tried), and retrying does not help

sincestring date-time required

The first day counted: the China-time (UTC+8) calendar day this moment falls on

untilstring date-time required

The last day counted, read the same way; no more than 30 days after the first

view'compact' | 'standard' | 'full'

How much of each item: compact (the most used fields, long text cut short), standard, or full (adds ext).

fieldsstring[]

Return only these fields of each item, by path (author.name).

Response

OK

code'ok' required
request_idstring uuid required

Changes

No recorded changes to this operation across all 1 revision of this API.