Douyin Influencer Marketing Analytics — Xingtu KOL Data 🚀

🎉 The only Apify actor that reads Douyin's Xingtu (星图) creator marketplace the way ByteDance shows it to brands — CPM/CPE pricing, audience demographics, and conversion ROI

Built for influencer agencies, brand marketers, and China market-entry teams who vet and price Douyin KOL deals

---

📋 Overview

Stop guessing what a Douyin creator is worth. This actor pulls the brand-side data straight from the Xingtu (星图) creator marketplace — the same numbers ByteDance shows advertisers when they match brands with creators. Every other "Douyin influencer" tool scrapes public video data; this one returns the marketplace economics agencies actually negotiate on.

Why influencer teams choose us:

• ✅ Brand-side marketplace data nobody else has: CPM/CPE suggested price tiers, e-commerce GMV ranges, cost-performance and conversion ROI — pulled from Xingtu, not reconstructed from public posts.
• ⚡ Filterable B2B creator discovery: search the Douyin creator square by follower range, price tier, and content category. Build qualified shortlists in minutes, not weeks.
• 🎯 Exact audience demographics: age, gender, geo, and device distribution of any creator's followers — critical for campaign-fit decisions before you spend.
• 💰 Xingtu's own ROI ranges: expected CPM, CPE, GPM, CPC, and conversion-ability scores to benchmark pricing against real performance.
• 💎 14 operations, one clean dataset out: pick one mode per run; no Douyin account, no login, no manual triage.

---

✨ Features

• 👤 Creator Profile: full Xingtu profile — handle, followers, MCN, lowest price, tags, location, verified Douyin profile link.
• 📊 Creator Core Metrics: marketing metrics, per-format price tiers, and industry tags.
• 📺 Creator Channel Metrics: per-channel intro and channel-level info.
• 👥 Audience Distribution: device / consumption / interest distribution dimensions.
• 🌍 Follower Distribution: fan geo, age, gender, and device breakdowns.
• 📈 Follower Growth Trend: daily follower count and deltas over any date range.
• 💰 Cost-Performance Analysis: expected CPM / CPE / VV — the core pricing-vetting field.
• 🔁 Conversion Analysis: GPM / CPC / sales ranges and recommended product counts.
• 🔍 Creator Search: paginated creator-square discovery with follower / price / content-tag filters.
• 🔎 KOL Keyword Search: simpler keyword search across Douyin, Toutiao, and Xigua.
• 🎬 Item Report Trends: time-series performance of a single video/item.
• 💬 Comment Keyword Analysis: hot comment tokens that reveal audience language.
• 🏷️ Content Keyword Analysis: the creator's content hot-keyword map.
• 🛍️ Showcase Items: the creator's latest and top-performing videos/items.

---

🎬 Quick Start

Pick one operation, supply the matching input, run. Results land in a clean Apify dataset you can export to JSON, CSV, or Excel.

curl -X POST "https://api.apify.com/v2/acts/sian.agency~douyin-xingtu-kol-analytics/runs?token=YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"operation": "creatorSearch", "keyword": "美妆", "maxPages": 2}'

---

🚀 Getting Started (3 Simple Steps)

Step 1: Choose your operation

Pick one of the 14 modes — e.g. creatorSearch to discover creators, or creatorProfile to drill into one.

Step 2: Provide the input

Search ops need a keyword; per-creator ops need an oAuthorId (you get these from any search result row).

Step 3: Run and export

Launch the run. In seconds you'll have a structured dataset ready to export.

That's it! In under a minute, you'll have:

• A qualified shortlist of Douyin creators with marketplace pricing
• Audience demographics and ROI metrics per creator
• Clean rows you can pipe into a sheet, CRM, or KOL-matching tool

---

📥 Input Configuration

Field	Type	Required	Description
operation	string	Yes	One of the 14 operations (see Features)
oAuthorId	string	Per-creator ops	Xingtu creator ID — find it in any search result row
keyword	string	Search ops	Search term (Chinese or English)
itemId	string	Item Report Trends	Douyin video/item ID from Showcase Items
platform	string	No	SHORT_VIDEO (default) / LIVE_STREAMING / PICTURE_TEXT / SHORT_DRAMA
followerRange	string	No	Creator Search filter, e.g. 10-100 (10k–1M followers)
kolPriceType / kolPriceRange	string	No	Creator Search price-tier filters
contentTag	string	No	Creator Search content-category filter
platformSource	string	No	KOL Keyword Search: Douyin / Toutiao / Xigua
startDate / endDate	string	No	Follower Growth Trend date range (yyyy-MM-dd)
maxPages	integer	No	Pages for paginated ops (1–50, default 3)

Example — discover creators:

{
  "operation": "creatorSearch",
  "keyword": "美妆",
  "followerRange": "10-100",
  "maxPages": 2
}

Example — vet one creator's pricing:

{
  "operation": "costPerformance",
  "oAuthorId": "7015873824226820127"
}

---

📤 Output

Results are saved to the Apify dataset. Each operation returns a flat row shape with curated camelCase aliases plus the raw upstream fields spread alongside. Filter by _operation to split modes.

Field	Type	Description
oAuthorId	string	Xingtu creator ID
nickname	string	Creator handle
uniqueId	string	Douyin @handle
follower	number	Follower count
lowestPrice	number	Lowest marketplace price
assignCpmSuggestPrice	number	Suggested CPM price
ecomScore	number	E-commerce capability score
dimension	string	Distribution dimension (audience/follower ops)
distributionList	array	Distribution buckets
date / fansCount / fansDelta	mixed	Follower growth time-series
commentToken / hotRate	mixed	Comment keyword analysis
itemTitle / playCount / likeCount	mixed	Showcase item metrics
userPageUrl	string	Creator profile link
status	string	success or error

Example — Creator Profile row:

{
  "oAuthorId": "7015873824226820127",
  "nickname": "美妆神手红 大大（红哒哒）",
  "uniqueId": "hongbaby777",
  "follower": 2589759,
  "lowestPrice": 0,
  "city": "杭州",
  "userPageUrl": "https://www.douyin.com/user/MS4wLjABAAAA...",
  "_operation": "creatorProfile",
  "status": "success"
}

---

💼 Use Cases & Examples

1. Influencer Agency Creator Vetting

Agency strategists pulling marketplace profiles before pitching Douyin creators to brand clients.

Input: oAuthorId of a shortlisted creator. Output: CPM/CPE tiers, audience distribution, cost-performance, growth history. Use: Walk into a client pitch with the same numbers ByteDance uses to price the deal.

2. B2B Creator Discovery with Filters

Brand marketers building qualified Douyin creator shortlists.

Input: creatorSearch with keyword + follower range + content tag. Output: A paginated list of creators matching your brand brief. Use: Replace weeks of manual triage with a filtered shortlist in minutes.

3. Audience Demographics for Campaign Fit

CPG / beauty / fashion brands targeting specific demographic segments.

Input: followerDistribution + audienceDistribution for a candidate creator. Output: Exact age, gender, geo, and device breakdowns. Use: Confirm a creator's audience matches your target before you pay for content.

4. Cost-Performance & Conversion ROI Benchmarking

Performance marketers benchmarking creator pricing vs results.

Input: costPerformance + conversionAnalysis across a creator set. Output: CPM/CPE/GPM/CPC ranges and conversion-ability scores. Use: Spot under-priced rising stars and over-priced veterans.

5. China KOL Database Building

KOL-matching SaaS founders and market-research firms.

Input: Recurring creatorSearch runs across categories. Output: A proprietary, structured Douyin KOL database. Use: Power matching products, market reports, and in-house brand tooling.

---

🔗 Integration Examples

JavaScript/Node.js

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/douyin-xingtu-kol-analytics').call({
  operation: 'creatorSearch',
  keyword: '美妆',
  maxPages: 2
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);

Python

from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')

run = client.actor('sian.agency/douyin-xingtu-kol-analytics').call(
    run_input={'operation': 'creatorProfile', 'oAuthorId': '7015873824226820127'}
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)

cURL

curl -X POST 'https://api.apify.com/v2/acts/sian.agency~douyin-xingtu-kol-analytics/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"operation": "audienceDistribution", "oAuthorId": "7015873824226820127"}'

Automation Workflows (N8N / Zapier / Make)

1. Trigger: Schedule or webhook
2. HTTP Request: Call the actor API with your chosen operation
3. Process: Handle the JSON dataset rows
4. Action: Save to a sheet/CRM, score creators, or notify your team

---

📊 Performance & Pricing

FREE Tier (Try It Now)

• Full feature access across all 14 operations, same data quality
• No credit card required
• Perfect for testing and small shortlists

PAID Tier (Production Ready)

• Unlimited creators and pages per run
• Pay-per-result: you're only charged for successful rows — error rows are free

💰 Premium, transparent pricing — the headline rate is the high-volume Creator Search at $0.012/row. Deep single-creator ROI ops (cost-performance, conversion, profile) are priced higher because the data has no substitute anywhere else on the market.

🔗 View current pricing

---

❓ Frequently Asked Questions

Q: What is Xingtu (星图)? A: Xingtu is Douyin's official creator marketplace where brands find, vet, and pay creators. This actor surfaces that brand-side data — pricing, audience, ROI — as a structured dataset.

Q: How do I get a creator's oAuthorId? A: Run creatorSearch or kolKeywordSearch first — every result row includes oAuthorId. Then use it in any per-creator operation.

Q: How many creators can I pull? A: FREE tier covers testing; PAID is unlimited. Paginated search ops return ~20 creators per page, up to 50 pages.

Q: What output formats are available? A: JSON, CSV, and Excel — export directly from the Apify dataset.

Q: Does it need a Douyin or Xingtu account? A: No. No login, no account, no API key from your side.

Q: Why is some data thin for a given creator or item? A: Smaller creators and low-traffic items have less marketplace data on file. The actor returns a clear status row when a particular endpoint has no data for that input.

Q: Is this legal? A: We only extract publicly accessible marketplace data. See the legal section below.

---

🐛 Troubleshooting

"Missing required input" error

• Per-creator ops need oAuthorId; kolKeywordSearch needs keyword; itemReportTrends needs itemId. Check the operation's required field.

A creator returns "No distribution data available"

• That creator has no marketplace data on file for that dimension. Try a larger creator or a different operation.

Search returns fewer pages than maxPages

• The marketplace ran out of matching creators; the actor stops automatically when there are no more results.

"Data source temporarily unavailable"

• A transient upstream hiccup. The actor retries automatically; re-run if it persists.

---

⚠️ Trademark Disclaimer

This is an independent scraping tool. It is not affiliated with, endorsed by, or sponsored by ByteDance Ltd., Douyin, or the Xingtu (星图) creator-marketplace platform. The Douyin®, 抖音®, and Xingtu®/星图® names appear under nominative fair use to describe the data this tool works with.

---

⚖️ Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the legality of web scraping.

---

🤝 Support

Join our active support community

• For issues or questions, open an issue in the actor's Issues tab
• Check the SIÁN Agency Store for more automation tools
• 📧 apify@sian-agency.online

---

Built by SIÁN Agency | More Tools