Douyin analytics Creator comparison API
Give it Douyin user IDs (numbers).
Douyin creator comparison (creatorCompare)
Give it Douyin user IDs (numbers). sec_uid values, links and names are not accepted by this mode; the creatorIndex mode shows the uid of a creator. Every ID is looked up on its own, so one unknown ID never spoils the others; an ID the source does not know returns nothing. comparePeriod is 7days (default) or 30days, ending yesterday.
| Field | What it is |
|---|---|
uid, secUid, nickname, url, avatar |
The creator |
followers, totalLikes, totalPosts |
Current totals |
periodDays |
Length of the compared period |
periodTotals |
Gains in the period: likes, comments, shares, newFollowers (can be negative), posts |
periodTotalsChange |
The same five figures as growth rates against the period before, as the source reports them |
perPostAverages |
Averages per post in the period: likes, comments, shares, newFollowers |
perPostAveragesChange |
The same four averages as growth rates against the period before, as the source reports them |
The figures are totals and averages of the period, not a daily series.
The input that produced this run
Mode creatorCompare. Parameters as sent, with what each one does.
| Parameter | Value | What it does |
|---|---|---|
mode | "creatorCompare" | What to fetch: an analysis record per account, video, creator, keyword or content category; or rows of similar creators, related words, suggestions, hot topics, videos and trend reports, and the creator center's... |
creators | ["100476191179"] | Douyin user IDs (numbers), sec_uid values, Douyin profile links, or creator names (the best match of a name search is used, so prefer an ID or link). Each creator is one record (creatorIndex) or up to 20 rows... |
maxResults | 10 | Maximum number of records or rows to return in total for this run. You are charged per record or row returned. |
14 fields in every creatorCompare
From the first record of the run above. Identity fields of ordinary users are masked on this site.
| Field | Type | Example |
|---|---|---|
type | str | creatorCompare |
uid | str | <masked> |
secUid | str | <masked> |
nickname | str | <masked> |
url | str | <masked> |
avatar | str | <masked> |
periodDays | int | 7 |
followers | int | 26432920 |
totalLikes | int | 246885637 |
totalPosts | int | 558 |
periodTotals | dict | {"likes": 51523, "comments": 1935, "shares": 2264, "newFollo |
periodTotalsChange | dict | {"likes": -0.7856923000133103, "comments": -0.81793375987956 |
perPostAverages | dict | {"likes": 7360.428571428572, "comments": 276.85714285714283, |
perPostAveragesChange | dict | {"likes": -0.7857029963232236, "comments": -0.81770294421973 |
A real run, 14 fields per record
Run on 2026-11-09 with input {"mode": "creatorCompare", "creators": ["100476191179"], "maxResults": 10}. Personal fields of ordinary users are masked here.
| totalLikes | followers | periodDays | totalPosts |
|---|---|---|---|
| 246885637 | 26432920 | 7 | 558 |
All 14 fields in one record
typecreatorCompareuidsecUidnicknameurlavatarperiodDays7followers26432920totalLikes246885637totalPosts558periodTotalsperiodTotalsChangeperPostAveragesperPostAveragesChange
What one creatorCompare costs
Run start · $0.00005 · Once per run, when the first request succeeds, even if that request returns nothing. These modes pay several at that moment: accountInsight 3, keywordSuggestions 3, videoInsight 2, categoryInsight 2. Not charged when the run fails from the start or rejects the inputs, or when your spending limit cannot cover it. In creatorCompare, reportDetail and reportRecommendations every input after the first one needs a request of its own, so it is charged one more run start before it is looked up
Run this request yourself
The same input as above, three ways.