Douyin Xingtu Ranking lists API
The dataset has table views for Creators, Creator profiles, Rankings, Creator videos, Creator analytics, MCN agencies and Short-drama actor ranking.
Xingtu creator ranking rows (rankedCreator)
| Field | What it is |
|---|---|
rank |
Position in the ranking (also in rankedActor) |
previousRank |
Position in the previous edition |
isNew |
Whether the creator is new in this edition |
score |
Ranking score |
primaryCategory |
Main content category |
averagePlays |
Average plays per video |
cpm |
Cost per thousand plays |
followersGained, videoCount |
Followers gained and videos published in the period (rising-stars list) |
completedOrders |
Completed Xingtu orders as a band, for example > 20 (brand lists) |
repurchaseRate |
Advertiser repurchase rate as a band, for example > 0.75 (brand lists) |
orderRate |
Share of the creator's videos that are paid orders (brand lists) |
The dataset has table views for Creators, Creator profiles, Rankings, Creator videos, Creator analytics, MCN agencies and Short-drama actor ranking.
The input that produced this run
Mode ranking. Parameters as sent, with what each one does.
| Parameter | Value | What it does |
|---|---|---|
mode | "ranking" | What to scrape: creators matching a search, full profiles or deep analytics of given creators, a creator's videos, similar creators, streamers, Toutiao creators, MCN agencies, a video report, or an official ranking... |
rankingList | "rising-stars" | Which official ranking to read. The list ranks creators by their commercial results or growth; the short-drama actor ranking is monthly and takes no category. |
rankingPeriod | "weekly" | Weekly or monthly edition (the short-drama actor ranking is monthly only). The latest published edition is read unless you give a date. |
rankingCategory | "food" | Advertiser industry (lists brand-preferred, a3-seeding, search-after-view, ecommerce, ad-traffic, high-potential) or content category (rising-stars, top-picks). Leave unset for the default of the chosen list. A... |
maxResults | 10 | Maximum number of items to return in total for this run. You are charged per item returned. |
46 fields in every rankedCreator
From the first record of the run above. Identity fields of ordinary users are masked on this site.
| Field | Type | Example |
|---|---|---|
type | str | rankedCreator |
userId | str | <masked> |
url | str | <masked> |
nickname | str | <masked> |
avatar | str | <masked> |
douyinUserId | str | <masked> |
gender | str | <masked> |
city | str | <masked> |
province | null | null |
followers | int | 144115 |
followersGrowth30d | null | null |
followersGrowthRate15d | null | null |
categories | list | ["美食"] |
subCategories | list | ["美食产品测评"] |
contentThemes | list | [] |
price20To60s | null | null |
price60sPlus | null | null |
expectedPlays | null | null |
medianPlays30d | null | null |
medianInteractions30d | null | null |
interactionRate30d | null | null |
playCompletionRate30d | null | null |
expectedCpm20To60s | null | null |
expectedCpe20To60s | null | null |
expectedCpm60sPlus | null | null |
expectedCpe60sPlus | null | null |
starIndex | null | null |
spreadIndex | null | null |
conversionIndex | null | null |
shoppingIndex | null | null |
ecommerceEnabled | null | null |
ecommerceLevel | null | null |
ecommerceGmv30dRange | null | null |
recentVideos | list | [] |
rank | int | 1 |
previousRank | int | 0 |
isNew | bool | true |
score | float | 0.6476023000055825 |
primaryCategory | str | 美食 |
averagePlays | int | 20818479 |
cpm | null | null |
followersGained | int | 5288 |
videoCount | int | 2 |
completedOrders | null | null |
repurchaseRate | null | null |
orderRate | int | 0 |
A real run, 46 fields per record
Run on 2026-11-09 with input {"mode": "ranking", "rankingList": "rising-stars", "rankingPeriod": "weekly", "rankingCategory": "food", "maxResults": 10}. Personal fields of ordinary users are masked here.
| followers | followersGained | averagePlays | rank | previousRank | score |
|---|---|---|---|---|---|
| 144115 | 5288 | 20818479 | 1 | 0 | 0.6476023000055825 |
| 185281 | 17913 | 5717765 | 2 | 60 | 0.6373242733054609 |
| 175982 | 16684 | 199616 | 3 | 46 | 0.4704895073902888 |
| 52552 | 15451 | 947349 | 4 | 4 | 0.4540315581999045 |
| 168590 | 14129 | 1306707 | 5 | 0 | 0.4257617289893037 |
| 239976 | 13778 | 1540073 | 6 | 0 | 0.4215691553653899 |
All 46 fields in one record
typerankedCreatoruserIdurlnicknameavatardouyinUserIdgendercityprovincefollowers144115followersGrowth30dfollowersGrowthRate15dcategoriessubCategoriescontentThemesprice20To60sprice60sPlusexpectedPlaysmedianPlays30dmedianInteractions30dinteractionRate30dplayCompletionRate30dexpectedCpm20To60sexpectedCpe20To60sexpectedCpm60sPlusexpectedCpe60sPlusstarIndexspreadIndexconversionIndexshoppingIndexecommerceEnabledecommerceLevelecommerceGmv30dRangerecentVideosrank1previousRank0isNewscore0.6476023000055825primaryCategory美食averagePlays20818479cpmfollowersGained5288videoCount2completedOrdersrepurchaseRateorderRate0
What one rankedCreator costs
Result · $0.0092 · Per creator from a search, per ranking row, and per row of the modes similarCreators, anchorSearch, toutiaoSearch, mcnSearch, contentTrendGuide, ipCalendar, ipActivityDetail and marketingCases
Run this request yourself
The same input as above, three ways.