Real run · 2026-11-09 · 10 records

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.

Resultready
JSON
10records in this run
46fields per record
7srun time, start to finish
$0.0092per record, Bronze tier
What it returns

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.

Request

The input that produced this run

Mode ranking. Parameters as sent, with what each one does.

ParameterValueWhat 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...
maxResults10Maximum number of items to return in total for this run. You are charged per item returned.
Response fields

46 fields in every rankedCreator

From the first record of the run above. Identity fields of ordinary users are masked on this site.

FieldTypeExample
typestrrankedCreator
userIdstr<masked>
urlstr<masked>
nicknamestr<masked>
avatarstr<masked>
douyinUserIdstr<masked>
genderstr<masked>
citystr<masked>
provincenullnull
followersint144115
followersGrowth30dnullnull
followersGrowthRate15dnullnull
categorieslist["美食"]
subCategorieslist["美食产品测评"]
contentThemeslist[]
price20To60snullnull
price60sPlusnullnull
expectedPlaysnullnull
medianPlays30dnullnull
medianInteractions30dnullnull
interactionRate30dnullnull
playCompletionRate30dnullnull
expectedCpm20To60snullnull
expectedCpe20To60snullnull
expectedCpm60sPlusnullnull
expectedCpe60sPlusnullnull
starIndexnullnull
spreadIndexnullnull
conversionIndexnullnull
shoppingIndexnullnull
ecommerceEnablednullnull
ecommerceLevelnullnull
ecommerceGmv30dRangenullnull
recentVideoslist[]
rankint1
previousRankint0
isNewbooltrue
scorefloat0.6476023000055825
primaryCategorystr美食
averagePlaysint20818479
cpmnullnull
followersGainedint5288
videoCountint2
completedOrdersnullnull
repurchaseRatenullnull
orderRateint0
Sample output

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.

followersfollowersGainedaveragePlaysrankpreviousRankscore
144115528820818479100.6476023000055825
1852811791357177652600.6373242733054609
175982166841996163460.4704895073902888
5255215451947349440.4540315581999045
168590141291306707500.4257617289893037
239976137781540073600.4215691553653899
All 46 fields in one record
  • type rankedCreator
  • userId
  • url
  • nickname
  • avatar
  • douyinUserId
  • gender
  • city
  • province
  • followers 144115
  • followersGrowth30d
  • followersGrowthRate15d
  • categories
  • subCategories
  • contentThemes
  • price20To60s
  • price60sPlus
  • expectedPlays
  • medianPlays30d
  • medianInteractions30d
  • interactionRate30d
  • playCompletionRate30d
  • expectedCpm20To60s
  • expectedCpe20To60s
  • expectedCpm60sPlus
  • expectedCpe60sPlus
  • starIndex
  • spreadIndex
  • conversionIndex
  • shoppingIndex
  • ecommerceEnabled
  • ecommerceLevel
  • ecommerceGmv30dRange
  • recentVideos
  • rank 1
  • previousRank 0
  • isNew
  • score 0.6476023000055825
  • primaryCategory 美食
  • averagePlays 20818479
  • cpm
  • followersGained 5288
  • videoCount 2
  • completedOrders
  • repurchaseRate
  • orderRate 0
Pricing

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

Full Douyin Xingtu price table and calculator

Developers

Run this request yourself

The same input as above, three ways.

Request
Response · 200application/json