Douyin Xingtu Creator profiles API
The base profile decides whether a creator record exists.
Xingtu creator profiles (creatorDetail)
| Field | What it is |
|---|---|
price20To60s, price60sPlus |
Video quotes in CNY |
expectedCpm20To60s, expectedCpe20To60s, expectedCpm60sPlus, expectedCpe60sPlus |
Expected CPM and CPE (CNY) per video length |
salesExpectedCpm20To60s, salesExpectedCpm60sPlus |
Expected CPM (CNY) in sales campaigns per video length |
audience |
Audience breakdown by kind: gender, age, province, city, cityTier, deviceBrand, interest, crowd. Each is a list of {label, count, share} with share in percent |
mcnName, mcnId, mcnLogo, mcnIntroduction |
Agency (MCN) the creator belongs to, its ID, logo link and introduction |
medianPlays |
Median plays per video |
averageLikes, averageComments, averageShares |
Averages per video |
averageVideoSeconds |
Average video length in seconds |
interactionRate, playCompletionRate |
Interaction and play completion rates, as fractions |
ecommerceEnabled |
Whether the creator sells products |
selfIntroduction |
The creator's own pitch to brands |
creditScore |
Xingtu credit score |
cooperationBrands |
Brands the creator lists as past partners |
email, wechat, hasWechat |
Business e-mail and WeChat ID the creator published for brands, and whether a WeChat contact is on file |
douyinSecUid |
Douyin sec_uid, usable for Douyin profile lookups |
douyinShortId, douyinUniqueId |
Douyin short ID and Douyin ID (the public handle) |
joinedAt, updatedAt |
When the creator joined Xingtu and when the profile was last updated (ISO 8601) |
The base profile decides whether a creator record exists. If a later section (reach, audience, business card, quotes) is empty for this creator, its fields are empty and the record is still delivered and charged as one detail.
The input that produced this run
Mode creator. Parameters as sent, with what each one does.
| Parameter | Value | What it does |
|---|---|---|
mode | "creator" | 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... |
douyinIds | ["851097441"] | Douyin account names (抖音号, for example 851097441 or an @name). Each is looked up on Xingtu first and then handled like an entry of 'creators'. Use it together with or instead of 'creators'. An account that is not on... |
maxResults | 1 | Maximum number of items to return in total for this run. You are charged per item returned. |
45 fields in every creatorDetail
From the first record of the run above. Identity fields of ordinary users are masked on this site.
| Field | Type | Example |
|---|---|---|
type | str | creatorDetail |
userId | str | <masked> |
url | str | <masked> |
nickname | str | <masked> |
avatar | str | <masked> |
douyinUserId | str | <masked> |
douyinSecUid | str | <masked> |
douyinShortId | str | 851097441 |
douyinUniqueId | str | 851097441 |
gender | str | <masked> |
city | str | <masked> |
province | str | <masked> |
followers | int | 2149941 |
categories | list | ["美食"] |
subCategories | list | ["美食教程"] |
contentThemes | list | ["家常菜教程", "下饭菜教程", "家常菜谱", "荤菜教程", "海鲜烹饪", "汤品教程", "下酒菜", "凉 |
mcnName | str | 蓝色星空 |
mcnId | str | 1861329355541577 |
mcnLogo | str | https://p26-star-fe-sign.byteimg.com/tos-cn-i-9hvokabxw2/... |
mcnIntroduction | str | 中国头部MCN机构,打造达人签约孵化与品牌营销的超级引擎! ✅ 1000+全品类达人矩阵,覆盖抖音/小红书等主流平... |
ecommerceEnabled | bool | true |
joinedAt | str | 2020-06-19T01:47:28Z |
updatedAt | str | 2026-11-08T17:35:17Z |
price20To60s | int | 13000 |
price60sPlus | int | 15000 |
medianPlays | int | 560708 |
averageLikes | int | 7013 |
averageComments | int | 240 |
averageShares | int | 2792 |
averageVideoSeconds | float | 13.5 |
interactionRate | float | 0.0206 |
playCompletionRate | float | 0.0533 |
expectedCpm20To60s | float | 39.78 |
expectedCpm60sPlus | float | 45.9 |
expectedCpe20To60s | float | 2.33 |
expectedCpe60sPlus | float | 2.69 |
salesExpectedCpm20To60s | float | 49.11 |
salesExpectedCpm60sPlus | float | 56.67 |
selfIntroduction | null | null |
creditScore | null | null |
cooperationBrands | null | null |
email | null | null |
wechat | null | null |
hasWechat | null | null |
audience | dict | {"age": "<masked>", "deviceBrand": [{"label": "华为", "count": |
A real run, 45 fields per record
Run on 2026-11-09 with input {"mode": "creator", "douyinIds": ["851097441"], "maxResults": 1}. Personal fields of ordinary users are masked here.
| mcnName | price20To60s | price60sPlus | salesExpectedCpm20To60s | salesExpectedCpm60sPlus | averageLikes |
|---|---|---|---|---|---|
| 蓝色星空 | 13000 | 15000 | 49.11 | 56.67 | 7013 |
All 45 fields in one record
typecreatorDetailuserIdurlnicknameavatardouyinUserIddouyinSecUiddouyinShortId851097441douyinUniqueId851097441gendercityprovincefollowers2149941categoriessubCategoriescontentThemesmcnName蓝色星空mcnId1861329355541577mcnLogohttps://p26-star-fe-sign.byteimg.com/tos-cn-i-9hvokabxw2/...mcnIntroduction中国头部MCN机构,打造达人签约孵化与品牌营销的超级引擎! ✅ 1000+全品类达人矩阵,覆盖抖音/小红书等主流平...ecommerceEnabledjoinedAt2020-06-19T01:47:28ZupdatedAt2026-11-08T17:35:17Zprice20To60s13000price60sPlus15000medianPlays560708averageLikes7013averageComments240averageShares2792averageVideoSeconds13.5interactionRate0.0206playCompletionRate0.0533expectedCpm20To60s39.78expectedCpm60sPlus45.9expectedCpe20To60s2.33expectedCpe60sPlus2.69salesExpectedCpm20To60s49.11salesExpectedCpm60sPlus56.67selfIntroductioncreditScorecooperationBrandsemailwechathasWechataudience
Good to know before you run it
- The
userIdof a search or ranking row is the ID to give modecreator.
What one creatorDetail 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: creator 6, creatorAnalytics 7, rateCard 7, videoReport 5, mcnSearch 2. Not charged when the run fails from the start or rejects the IDs, or when your spending limit cannot cover it
Run this request yourself
The same input as above, three ways.