Douyin Xingtu (星图) KOL / Influencer Scraper

Search Douyin Xingtu (星图) influencers (KOLs) by keyword and enrich each one with profile basics, the Xingtu index marketing scores, and fans / audience demographic portraits — the data brands use to plan China influencer-marketing campaigns.

Unofficial. Not affiliated with, authorized, or endorsed by Douyin, Xingtu (星图), or ByteDance. This is an independent tool that retrieves publicly available data via a third-party API. Use it in compliance with Douyin's / Xingtu's terms and applicable law; you are responsible for how you use the data.

What it does

• Keyword search (searchKeywords) — searches the Xingtu KOL marketplace and pages through results (20 KOLs per page) until maxItems is reached. Each KOL carries rich marketing metrics straight from search: star index, e-commerce score & GMV range, 30-day fans growth, interaction rate, median views, suggested CPM price, content theme labels, and the creator's top-performing items.
• sec_user_id lookup (userIds) — resolves a Douyin sec_user_id to its Xingtu kolId and enriches it the same way.
• Per-KOL enrichment (each toggle is on by default except audience portrait):
  • Profile basics — nickname, follower count, avatar, gender, city/province, tags, unique ID, sec_uid, MCN.
  • Xingtu index — star / spread / convert / shopping / cooperation / cp scores, each with value, rank and rank percentile.
  • Fans portrait — top cities, provinces, age bands, gender split, devices, interests.
  • Audience portrait (optional) — viewer demographics.

Input

Field	Type	Default	Notes
searchKeywords	string[]	["美妆"]	Keywords to search. Chinese works best.
userIds	string[]	[]	Douyin sec_user_id values to resolve + enrich.
maxItems	integer	50	Total KOLs across all inputs.
enrichProfile	boolean	true	Add profile basics (1 API call/KOL).
enrichXingtuIndex	boolean	true	Add Xingtu index scores (1 API call/KOL).
enrichFansPortrait	boolean	true	Add fans demographics (1 API call/KOL).
enrichAudiencePortrait	boolean	false	Add audience demographics (1 API call/KOL).
proxyConfiguration	object	off	Optional Apify Proxy.

Example:

{
  "searchKeywords": ["美妆"],
  "maxItems": 5
}

Output

One dataset item per KOL, deduped by kolId. Shape (enrichment fields appear when enabled):

{
  "kolId": "6978702114235088932",
  "nickname": "中年美妆博母杨光",
  "follower": 270553,
  "starIndex": 81.25,
  "ecomScore": 82,
  "ecomLevel": "L1",
  "ecomGmv30dRange": "1k-3w",
  "fansIncrement30d": 11158,
  "interactRate30d": 0.054,
  "vvMedian30d": 24386,
  "assignCpmSuggestPrice": 97,
  "gender": "female",
  "city": "杭州市",
  "province": "浙江省",
  "tags": ["时尚"],
  "contentThemeLabels": ["唇妆教程", "护发技巧", "..."],
  "secUid": "MS4wLjABAAAA...",
  "uniqueId": "bomuyg",
  "xingtuIndex": {
    "link_star_index": { "value": 75.6, "rank": 17936, "rankPercent": 0.0087, "avgValue": 56.41 }
  },
  "fansPortrait": [
    { "type": "城市分布", "description": "分布最多的1个城市上海(16%)", "distribution": [ { "key": "上海", "value": 11131 } ] }
  ],
  "topItems": [ { "itemId": "7580711922930502073", "vv": 3228265, "videoTag": 3 } ],
  "url": "https://www.xingtu.cn/ad/creator/author-homepage/abstract/6978702114235088932",
  "source": "search:美妆"
}

How it works

Uses a fast, direct HTTP API (no headless browser, no cookies or login). Calls use a browser User-Agent (the edge is behind Cloudflare bot-management) and retry on transient 403/429/5xx responses as well as the occasional "HTTP 200 but please-retry" envelope the Xingtu upstream emits. The API key is supplied to the Actor as a secret environment variable, managed for you — you don't need to bring your own.

Notes & limits

• Search results are capped by the upstream marketplace; very broad keywords still page deep.
• Enrichment costs one extra API call per KOL per enabled portrait/index — turn off the ones you don't need to run cheaper and faster.
• userIds accepts Douyin sec_user_id strings (not numeric UIDs or @handles).

---

Why this Actor

• Direct API, no headless browser — fast, stable runs with nothing to babysit.
• No login, no cookies — we never touch your accounts, so there's no ban risk.
• Fresh, real-time data — every run reads the source live, not a stale cache.
• Pay per result — you're billed only for the rows actually delivered.
• Structured JSON — export to CSV, Excel, or JSON, or pull straight from the API / MCP.

Use cases

• Pull structured content + engagement for analytics dashboards.
• Track a creator's or topic's output and performance over time.
• Build training/research datasets of posts and metadata.
• Power competitor and trend monitoring.

FAQ

Do I need an account, cookies, or to log in anywhere? No. The Actor talks to a fast, direct HTTP API server-side — you just provide inputs and run it.

How am I billed? Pay-per-result: a fixed price per row returned, with no separate platform/compute charge. Caps like maxItems keep spend predictable.

Can I run it on a schedule or call it from my app? Yes — use Apify Schedules, the REST API, the JavaScript / Python clients, or the MCP server. See the API tab.

Is this affiliated with Douyin (抖音)? No. It's an independent tool that collects publicly available data. Use it in line with the platform's terms and applicable law.

How do I get a sec_user_id or aweme_id? A sec_user_id is the long MS4wLjAB... string in a profile share link; an aweme_id is the number in douyin.com/video/<id>.

More Douyin (抖音) scrapers by us

• Douyin Scraper — Search · profile · comments · 热榜 trending

Browse the full fleet → https://apify.com/ethereal_wool