Douyin Xingtu API
Get Douyin KOL data from Xingtu (巨量星图) for influencer marketing: search creators by keyword, category, gender and followers; pull video quotes, expected CPM/CPE, MCN and audience breakdown; read Xingtu ranking lists. No login or cookies needed. Export to JSON, CSV or Excel.
Douyin Xingtu API in one table
| Official public API for people outside China | No. This tool collects the publicly visible data instead. |
|---|---|
| What you send | A keyword, a link or an ID, depending on the request type |
| What you get back | JSON rows with English field names; 15 request types |
| Login, cookies, Chinese phone number | None needed |
| Output formats | JSON, CSV, Excel, or the Apify API |
| Price | $0.0092 per result on the Bronze tier, no subscription |
| Last verified with a real run | 2026-11-09 |
15 kinds of Douyin Xingtu request
Xingtu (巨量星图, often just called 星图) is Douyin's official marketplace where brands find creators and book sponsored videos. Creators set quotes for different video lengths, and Xingtu shows performance figures, audience statistics and weekly or monthly rankings of creators by commercial results or growth. This Actor reads the data Xingtu publishes about creators; it is not affiliated with Douyin or Xingtu.
- Find creators
- Creator profiles
- Ranking lists
- Creator analytics (audience, commerce, trends)
- Creator videos
- Similar creators
- Find streamers
- Find Toutiao creators
- Find MCN agencies
- Video report
- Creator rate cards
- Content trend guide
- IP marketing calendar
- IP activity details
- Marketing cases
A real run, 34 fields per record
Run on 2026-10-26 with input {"mode": "search", "keyword": "美食", "category": "food", "sort": "followers-desc", "maxResults": 10}. Personal fields of ordinary users are masked here.
| nickname | price20To60s | price60sPlus | followers | followersGrowth30d | followersGrowthRate15d |
|---|---|---|---|---|---|
| 麻辣德子 | 266000 | 288000 | 27456914 | -137091 | -0.0016607201509950607 |
| 阿蔡美食教学 | 260000 | 260000 | 26133301 | 140692 | -0.0019800100434351265 |
All 34 fields in one record
typecreatoruserId6662322230669606919urlhttps://www.xingtu.cn/ad/creator/author-homepage/douyin-v...nickname麻辣德子avatarhttps://p11.douyinpic.com/aweme/1080x1080/aweme-avatar/mo...douyinUserId69746644058gendermalecityprovince山东省followers27456914followersGrowth30d-137091followersGrowthRate15d-0.0016607201509950607categoriessubCategoriescontentThemesprice20To60s266000price60sPlus288000expectedPlaysmedianPlays30d7338medianInteractions30d21interactionRate30d0.0023playCompletionRate30d0.0269expectedCpm20To60sexpectedCpe20To60sexpectedCpm60sPlusexpectedCpe60sPlusstarIndex53.01274078553152spreadIndex68.57conversionIndex55.72shoppingIndex69.58ecommerceEnabledecommerceLevelL0ecommerceGmv30dRangerecentVideos
Call the Douyin Xingtu API
Every run is one HTTP call: send the input as JSON, get the rows back. The same works from Make, Zapier or n8n.
Pay per result
Bronze tier prices from the tool's listing; higher Apify tiers pay less. Free Apify users get two trial runs with their own input.
Full price table and worked examples
The Actor uses pay-per-event pricing. These are the current prices:
| Event | Price | When it is charged |
|---|---|---|
| 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 |
| 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 |
| Detail | $0.0368 | Per full creator profile (mode creator) and per video report (mode videoReport) |
| Analytics | $0.08 | Per creator analytics record (mode creatorAnalytics) and per creator rate card (mode rateCard) |
| Video | $0.005 | Per video (mode creatorVideos) |
Worked examples:
- 100 creators from a search: $0.00005 + 100 x $0.0092 = $0.92005.
- One ranking with 100 rows: $0.00005 + 100 x $0.0092 = $0.92005.
- 10 full creator profiles: 6 x $0.00005 + 10 x $0.0368 = $0.3683.
- 5 creator analytics records: 7 x $0.00005 + 5 x $0.08 = $0.40035.
- 100 videos of a creator: $0.00005 + 100 x $0.005 = $0.50005.
- 3 video reports: 5 x $0.00005 + 3 x $0.0368 = $0.11065.
You never pay for more than maxResults items, items that were not delivered are never charged, and the run stops by itself if your spending limit is reached. Before each creator analytics record the run checks that your limit still covers its $0.08, and stops without fetching it if not; sections that cannot be delivered stay empty and do not change the price.
On the free Apify plan you get 2 free trial runs of this Actor with your own input, up to 10 results each, and nothing is charged; after that, runs return a stored sample dataset (a real result of the prefilled input). Use any paid Apify plan for full runs.
Douyin Xingtu API questions
Do I need a Douyin or Xingtu account?
No. You do not need a Douyin account, API keys, proxies or cookies.
Is it legal to scrape Xingtu?
The Actor returns only data that Xingtu itself publishes about creators: creator IDs, names, avatars, location, quotes, performance figures, audience statistics and the business contact details a creator chose to publish for brands. Phone numbers are masked by the platform and not returned, and no private messages are collected. You are responsible for how you use the data, including compliance with data-protection laws in your country.
How fresh is the data?
Every run reads the figures Xingtu shows at that moment. Rankings are published weekly or monthly; use `rankingDate` to read an earlier edition.
Why are some fields empty?
Some data only exists for some creators (for example quotes for one video length, e-commerce figures, or contact details), and ranking rows carry fewer fields than search rows. See Fields that are often empty above.
How many results can I get?
Up to 5,000 items per run with `maxResults`. A search page holds up to 20 creators and a ranking request returns up to 100.
Can I schedule runs and export the data?
Yes. You can schedule runs in Apify Console or start them through the API, and export every dataset as JSON, CSV or Excel.