# Douyin Xingtu Creator Rankings - Brand-Deal KOLs & Rates (`zen-studio/douyin-xingtu-rankings-scraper`) Actor

Extract top Douyin (抖音) commercial creators with CPM rates, follower counts, brand-order metrics, and stable creator IDs from Xingtu (巨量星图) leaderboards. 7 industries: 美妆, 3C及电器, 食品饮料, 服装配饰, 汽车, 母婴宠物, 日化. Bucketed repurchase rates, top videos, optional similar-creator (达人) expansion. JSON/CSV/Excel.

- **URL**: https://apify.com/zen-studio/douyin-xingtu-rankings-scraper.md
- **Developed by:** [Zen Studio](https://apify.com/zen-studio) (community)
- **Categories:** Videos, Social media, SEO tools
- **Stats:** 123 total users, 86 monthly users, 95.7% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $6.99 / 1,000 creators

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Douyin (Xingtu) Creator Rankings Scraper (抖音 · 巨量星图) | Brand-Deal KOLs with Rates (2026)

<blockquote style="border-left:4px solid #4C945E;background:#F0FDF4;padding:12px 16px">
<span style="font-size:16px;font-weight:700;color:#1C1917">Find the top Douyin (抖音) commercial creators in your category with CPM rates, follower counts, brand-order metrics, and a stable creator ID,</span> <span style="font-size:15px;color:#57534E">driven by Xingtu's (巨量星图) official leaderboards across 7 industries. Optional one-hop similar-creator (达人) expansion. Clean structured JSON, billed per result.</span>
</blockquote>

![Douyin (抖音) Xingtu (巨量星图) creator rankings scraper: brand-deal KOLs with CPM rates and follower counts as structured JSON](https://iili.io/C9gdf7R.png)

#### Copy to your AI assistant

```
zen-studio/douyin-xingtu-rankings-scraper on Apify. Returns top Douyin commercial creators with rates, follower counts, brand-order metrics, and stable starId: driven by Xingtu (巨量星图) leaderboards across 7 industries (美妆, 3C及电器, 食品饮料, 服装配饰, 汽车, 母婴宠物, 日化). One flat row per creator, ~30 fields with a 'source' discriminator ('ranking' or 'similar_to:<starId>'). Call ApifyClient("TOKEN").actor("zen-studio/douyin-xingtu-rankings-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items. Required: industries (string[]), creatorType (top_creators|rising_stars|sales_champions|viral_drivers|paid_ad_performers|head_tier|all_top), timeWindow (latest_weekly|latest_monthly|all_history_weekly|all_history_monthly). Optional: maxResults (1–10000, default 100), includeSimilarCreators (bool, default false), similarExpandTopN (1–100, default 20), similarType (content|comprehension|audience|commercial). Pricing: $7.99 per 1,000 creators on the Free and Bronze plans, $7.49 on Silver, $6.99 on Gold, Platinum and Diamond, plus $0.01 per 1,000 dataset rows and Apify's platform start fee; Free-plan accounts get 15 lifetime preview runs capped at 20 results. Full spec: GET https://api.apify.com/v2/acts/zen-studio~douyin-xingtu-rankings-scraper/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Token: https://console.apify.com/account/integrations To reach the maintainers, add feedback="<what you needed and did not get>" to any run, including one that worked: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. The run returns its data exactly as it would without the note, and a human reads every note.
```

<table style="width:100%">
<tr>
<td colspan="5" style="padding:10px 14px;background:#4C945E;border:none;border-radius:4px 4px 0 0">
<span style="color:#FAFAF9;font-size:14px;font-weight:700;letter-spacing:0.5px">Zen Studio · Douyin 抖音 suite</span>
<span style="color:#E8F5E9;font-size:13px">&nbsp;&nbsp;&bull;&nbsp;&nbsp;Rankings, creators, search, profiles, videos</span>
</td>
</tr>
<tr>
<td style="padding:10px 12px;border:1px solid #E7E5E4;background:#D3EDD9;border-right:none;border-top:none;vertical-align:top;width:20%">
<span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-3TJaaOJDU1AMiOoJM-Vu2eVr0P6N-douyin-profile-scraper-logo.png" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/zen-studio/douyin-xingtu-rankings-scraper" style="color:#4C945E;text-decoration:none;font-weight:700;font-size:13px">Rankings</a></span><br>
<span style="color:#4C945E;font-size:11px;font-weight:600">&#10148; You are here</span>
</td>
<td style="background:#E8F5E9;padding:10px 12px;border:1px solid #E7E5E4;border-right:none;border-top:none;vertical-align:top;width:20%">
<span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-6UnaeaCriWpruDugz-BbpxqjZI7f-douyin-profile-scraper-logo.png" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/zen-studio/douyin-user-search-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">User&nbsp;Search</a></span><br>
<span style="color:#78716C;font-size:11px">Creators by keyword</span>
</td>
<td style="background:#E8F5E9;padding:10px 12px;border:1px solid #E7E5E4;border-right:none;border-top:none;vertical-align:top;width:20%">
<span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-3TJaaOJDU1AMiOoJM-Vu2eVr0P6N-douyin-profile-scraper-logo.png" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/zen-studio/douyin-search-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Search</a></span><br>
<span style="color:#78716C;font-size:11px">Videos by keyword</span>
</td>
<td style="background:#E8F5E9;padding:10px 12px;border:1px solid #E7E5E4;border-right:none;border-top:none;vertical-align:top;width:20%">
<span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-3TJaaOJDU1AMiOoJM-Vu2eVr0P6N-douyin-profile-scraper-logo.png" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/zen-studio/douyin-profile-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Profile</a></span><br>
<span style="color:#78716C;font-size:11px">Followers + posts</span>
</td>
<td style="background:#E8F5E9;padding:10px 12px;border:1px solid #E7E5E4;border-top:none;vertical-align:top;width:20%">
<span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-3TJaaOJDU1AMiOoJM-Vu2eVr0P6N-douyin-profile-scraper-logo.png" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/zen-studio/douyin-video-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Video</a></span><br>
<span style="color:#78716C;font-size:11px">Metadata + MP4</span>
</td>
</tr>
</table>

### How to Pull Top Douyin Creators by Industry

#### Basic: top brand-deal creators in beauty (default run)

```json
{
  "industries": ["美妆"],
  "creatorType": "top_creators",
  "timeWindow": "latest_monthly",
  "maxResults": 100
}
```

Returns 100 priced creators ranked by Xingtu's monthly brand-premium leaderboard (品牌种草·品牌优选榜) in ~3 seconds.

#### Mega-run: all top creators across a single industry (~441 unique)

```json
{
  "industries": ["3C及电器"],
  "creatorType": "all_top",
  "timeWindow": "latest_monthly",
  "maxResults": 500
}
```

`all_top` combines all six brand-seeding boards (Brand-Premium, A3 Seeding, View-then-Search, Sales Champions, Paid-Ad Performers, Rising Stars) for the chosen industry. Cross-board dedup is automatic.

#### Cross-industry monthly snapshot

```json
{
  "industries": ["美妆", "3C及电器", "食品饮料", "服装配饰"],
  "creatorType": "top_creators",
  "timeWindow": "latest_monthly",
  "maxResults": 400
}
```

100 top creators per industry × 4 industries. Useful for monthly competitive intel decks.

#### Discovery with lookalike expansion

```json
{
  "industries": ["美妆"],
  "creatorType": "top_creators",
  "timeWindow": "latest_monthly",
  "maxResults": 220,
  "includeSimilarCreators": true,
  "similarExpandTopN": 10,
  "similarType": "content"
}
```

Pulls the top 100 creators, then for each of the first 10 ranked creators pulls up to 12 lookalikes via Xingtu's similar-creator graph. Size `maxResults` to at least `100 + (similarExpandTopN × 12)` so similar-expansion has room to emit.

### Input Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `industries` | string\[] | `["美妆"]` | One or more of: `美妆` / `3C及电器` / `食品饮料` / `服装配饰` / `汽车` / `母婴宠物` / `日化`. Each industry runs independently. |
| `creatorType` | string | `top_creators` | `top_creators` (brand-premium) / `rising_stars` (high-potential + fast-growing) / `sales_champions` (top brand orders) / `viral_drivers` (A3 seeding + view-then-search) / `paid_ad_performers` / `head_tier` (mega creators) / `all_top` (combined). |
| `timeWindow` | string | `latest_monthly` | `latest_weekly` / `latest_monthly` / `all_history_monthly` / `all_history_weekly`. Latest = most recent snapshot only; historical = every snapshot back to Xingtu's earliest. |
| `maxResults` | integer | `100` | Hard cap on emitted rows (1–10000). Each unique creator counts as one result. |
| `includeSimilarCreators` | boolean | `false` | When `true`, adds a second pass that pulls similar creators for the top-N ranked creators via Xingtu's lookalike graph. Each lookalike counts as one result. |
| `similarExpandTopN` | integer | `20` | Only matters when the toggle above is `true`. The first N ranked creators per board become seeds for lookalike expansion (1–100). |
| `similarType` | string | `content` | `content` (style + topics) / `comprehension` (weighted) / `audience` (audience overlap) / `commercial` (CPM + sales profile). |

#### Accepted industry values

| Value | English |
|---|---|
| `美妆` | Beauty |
| `3C及电器` | 3C & Electronics |
| `食品饮料` | Food & Beverage |
| `服装配饰` | Apparel & Accessories |
| `汽车` | Automotive |
| `母婴宠物` | Mother & Baby & Pets |
| `日化` | Household Goods |

#### Accepted creator types

| Value | What it returns |
|---|---|
| `top_creators` | 品牌优选: best for brand deals |
| `rising_stars` | 高潜 + 涨粉黑马: fast-growing breakouts |
| `sales_champions` | 带货: top by completed brand orders |
| `viral_drivers` | A3 种草 + 看后搜: best at sparking searches |
| `paid_ad_performers` | 投流: highest ROI on paid promotion |
| `head_tier` | 头部必选: the most-booked head creators |
| `all_top` | All six brand-seeding boards combined |

### What Data Can You Extract from Douyin Xingtu?

One row per creator. Every row carries **41 top-level fields** with a `source` discriminator that separates ranking-origin rows from similar-expansion rows. Similar rows additionally populate four enrichment fields (`taskPriceInfos`, `recommendTypes`, `similarityScore`, `tagContentLevelOne`) that ranking rows leave empty.

#### Output Example

Every top-level field is shown below. Long URLs are trimmed with `…`; the `items[]` array is shortened.

```json
{
  "starId": "7044191734988800014",
  "coreUserId": "686525298261278",
  "douyinProfileUrl": "https://www.douyin.com/user/686525298261278",
  "nickName": "李仁真",
  "avatarUri": "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/…",
  "gender": 1,
  "city": "广州",
  "province": null,
  "follower": 1426502,
  "cpm": 94,
  "finishOrderCnt": "> 20",
  "repurchaseRate": "> 0.75",
  "itemOrderRate": 0.2472,
  "vvAvg": 188086,
  "industryTags": ["生活"],
  "primaryTag": "随拍",
  "rank": 1,
  "oldRank": 5,
  "score": 0.5261324041811847,
  "isNew": false,
  "rankingBoard": "品牌种草·品牌优选榜",
  "rankingCode": 1,
  "industry": "美妆",
  "industryId": "1930",
  "period": 30,
  "snapshotDate": "20260430",
  "version": "flow_split",
  "source": "ranking",
  "seedStarId": null,
  "similarityType": null,
  "linkStarIndex": null,
  "processingOrderCount30d": null,
  "prospective20_60Cpm": null,
  "expectedPlayNum": null,
  "eCommerceEnable": null,
  "isPlanAuthor": null,
  "tagContentLevelOne": null,
  "taskPriceInfos": [],
  "recommendTypes": [],
  "similarityScore": null,
  "items": [
    {"id": "7593899313596468515", "url": "https://www.douyin.com/video/7593899313596468515", "playCount": 8592286, "videoTag": 3},
    {"id": "7592239296397020468", "url": "https://www.douyin.com/video/7592239296397020468", "playCount": 6001942, "videoTag": 3},
    {"id": "7583559544857513258", "url": "https://www.douyin.com/video/7583559544857513258", "playCount": 2598071, "videoTag": 4},
    {"id": "7616202710781660454", "url": "https://www.douyin.com/video/7616202710781660454", "playCount": 4691225, "videoTag": 5},
    {"id": "7640488401787030790", "url": "https://www.douyin.com/video/7640488401787030790", "playCount": 10131,   "videoTag": 6}
  ]
}
```

#### Similar-row example (when `includeSimilarCreators: true`)

Similar-expansion rows reuse the same 41-field shape but flip the provenance fields and populate four enrichment columns that are `null`/`[]` on ranking rows:

```json
{
  "starId": "7036246438489096229",
  "coreUserId": "1234567890123456",
  "douyinProfileUrl": "https://www.douyin.com/user/1234567890123456",
  "nickName": "阿螺不怕",
  "follower": 1044831,
  "cpm": null,
  "finishOrderCnt": null,
  "repurchaseRate": null,
  "vvAvg": null,
  "rank": null,
  "rankingBoard": null,
  "industry": null,
  "snapshotDate": null,
  "source": "similar_to:7044191734988800014",
  "seedStarId": "7044191734988800014",
  "similarityType": "content",
  "linkStarIndex": 78.42,
  "processingOrderCount30d": 0,
  "prospective20_60Cpm": 25,
  "expectedPlayNum": 1932954,
  "eCommerceEnable": 1,
  "isPlanAuthor": false,
  "tagContentLevelOne": "[{\"label_index\":130,\"label_type\":1,\"name\":\"随拍\",\"parent_index\":0,\"level\":1}]",
  "taskPriceInfos": [
    {"taskCategory": 1, "videoType": 91, "videoTypeStatus": 1, "priceFen": 9600,  "priceCny": 96.0,  "startTime": 1672502400, "endTime": 2145916800},
    {"taskCategory": 1, "videoType": 71, "videoTypeStatus": 1, "priceFen": 51300, "priceCny": 513.0, "startTime": 1759248000, "endTime": 2145916800},
    {"taskCategory": 1, "videoType": 2,  "videoTypeStatus": 1, "priceFen": 25000, "priceCny": 250.0, "startTime": 1759248000, "endTime": 2145916800}
  ],
  "recommendTypes": ["内容相似", "繁星企划达人"],
  "similarityScore": null,
  "items": []
}
```

#### Field reference

| Field | Type | Notes |
|---|---|---|
| `starId` | string | Stable universal creator ID. Joins to other Xingtu data. |
| `coreUserId` | string | Numeric Douyin user ID. |
| `douyinProfileUrl` | string | Direct profile link. Permanent. |
| `nickName` | string | Display name. |
| `avatarUri` | string | Avatar image URL. |
| `gender` | int | `1` = male, `2` = female, `0` = unknown. |
| `city`, `province` | string | null | Self-declared region. May be empty. |
| `follower` | int | Follower count. |
| `cpm` | int | null | Cost per mille in ¥ (ranking source only). |
| `finishOrderCnt` | string | null | Completed brand-deal orders. Bucketed by Xingtu (e.g. `"> 20"`). Ranking source only. |
| `repurchaseRate` | string | null | Client repurchase rate. Bucketed (e.g. `"> 0.75"`). Ranking source only. |
| `itemOrderRate` | float | null | Exact item order rate. Ranking source only. |
| `vvAvg` | int | null | Average video views. |
| `industryTags` | string\[] | Top-level industry tags from Xingtu's `tags_relation`. |
| `primaryTag` | string | null | Primary content tag. |
| `rank`, `oldRank` | int | null | Current and previous rank on this board. Ranking source only. |
| `score` | float | null | Xingtu's composite ranking score. |
| `isNew` | bool | null | New-entrant flag. |
| `rankingBoard` | string | null | Leaderboard display name (e.g. `品牌种草·品牌优选榜`). |
| `rankingCode` | int | null | Numeric leaderboard code. |
| `industry`, `industryId` | string | null | Industry display name and Xingtu qualifier ID. |
| `period` | int | null | `7` = weekly, `30` = monthly. |
| `snapshotDate` | string | null | `YYYYMMDD` of the leaderboard snapshot. |
| `version` | string | null | `flow_split` or `base` depending on the leaderboard. |
| `source` | string | `ranking` or `similar_to:<seedStarId>`. Provenance discriminator. |
| `seedStarId` | string | null | Populated on similar rows: the ranked creator whose lookalikes produced this row. |
| `similarityType` | string | null | The similarity dimension used for the expansion (`content` / `audience` / `commercial` / `comprehension`). |
| `linkStarIndex` | float | null | Xingtu's content-affinity index (similar source only). |
| `processingOrderCount30d` | int | null | Active brand-order count in the last 30 days (similar source only). |
| `prospective20_60Cpm` | int | null | Projected CPM for 20–60s videos (similar source only). |
| `expectedPlayNum` | int | null | Projected play count (similar source only). |
| `eCommerceEnable` | int | null | `1` = e-commerce enabled, `0` = not enabled (similar source only). |
| `isPlanAuthor` | bool | null | Whether the creator is part of Xingtu's commercial plan program (similar source only). |
| `tagContentLevelOne` | string | null | JSON-encoded content-level taxonomy (similar source only). |
| `taskPriceInfos` | object\[] | Rate-card pricing per video type (similar source only). Each entry has `taskCategory`, `videoType` (Xingtu integer code), `videoTypeStatus`, `priceFen` (cents), `priceCny`, `startTime`, `endTime`. |
| `recommendTypes` | string\[] | Why Xingtu recommended this creator (e.g. `["内容相似", "繁星企划达人"]`). Similar source only. |
| `similarityScore` | float | null | Xingtu's similarity score. Often `0` at visitor-level access: use `recommendTypes` to understand the match instead. |
| `items` | object\[] | The creator's top recent videos on this leaderboard. Ranking source only. Each entry: `id` (Douyin video ID, same naming as the other actors in this collection), `url` (constructed `https://www.douyin.com/video/<id>`, feed it straight into Douyin Video / Transcripts / Comments scrapers), `playCount` (播放量 view count, exact int), `videoTag` (Xingtu's internal content-classification code, small int 1–6+). |

### Advanced Usage

#### Monthly competitive intel: all top creators across multiple industries

```json
{
  "industries": ["美妆", "3C及电器", "食品饮料"],
  "creatorType": "all_top",
  "timeWindow": "latest_monthly",
  "maxResults": 1300
}
```

\~441 unique creators per industry × 3 industries ≈ 1,300 rows. One snapshot per month is enough for a competitive overview deck.

#### Historical trend analysis: every monthly snapshot in one industry

```json
{
  "industries": ["美妆"],
  "creatorType": "top_creators",
  "timeWindow": "all_history_monthly",
  "maxResults": 3000
}
```

Returns the brand-premium board for every monthly snapshot Xingtu has published. Same `starId` appears across snapshots so you can compute rank trajectories over time. `dedup_skipped` will be high: that's expected; creators stay on the board across months.

#### Talent scouting with similar expansion (commercial similarity)

```json
{
  "industries": ["3C及电器"],
  "creatorType": "rising_stars",
  "timeWindow": "latest_monthly",
  "maxResults": 250,
  "includeSimilarCreators": true,
  "similarExpandTopN": 20,
  "similarType": "commercial"
}
```

Pulls the latest rising stars (高潜 + 涨粉黑马) and expands each of the top 20 with creators that match on commercial profile (CPM + sales). Use `taskPriceInfos[]` on the similar rows to surface rate-card pricing per video type: those CNY values are exact, not bucketed.

#### Weekly rising-creator monitoring

```json
{
  "industries": ["美妆"],
  "creatorType": "rising_stars",
  "timeWindow": "latest_weekly",
  "maxResults": 200
}
```

Combine with a weekly Apify schedule and filter on `isNew == true` to surface fresh entrants week-over-week. Cross-run dedup via `starId` lets you build a velocity timeline.

### Pricing: Pay Per Event (PPE)

**$7.99 per 1,000 creators** on the Free and Bronze plans, plus $0.01 per 1,000 dataset rows (the `result` event) and Apify's platform start fee. Each row written to the dataset counts as one creator, whether from a ranking board or from similar-expansion. One creator, one row, one event. No charge for catalog reads, failed pages, or retries.

| Apify plan | Per 1,000 creators |
|---|---|
| Free | **$7.99** |
| Bronze | **$7.99** |
| Silver | **$7.49** |
| Gold | **$6.99** |
| Platinum | **$6.99** |
| Diamond | **$6.99** |

The Silver, Gold, Platinum and Diamond discounts are applied automatically by Apify for subscribers on those plans, so you don't need to do anything to claim them.

#### Per-run cost projections

Creator plus dataset-row charges at the Free/Bronze rate; Apify's platform start fee comes on top.

| Scenario | Rows | Bill |
|---|---|---|
| Default run (one industry, brand-premium, monthly) | 100 | $0.80 |
| One industry, `all_top` combined | ~441 unique | $3.53 |
| Cross-industry monthly snapshot (all 6 codes × 3 industries) | ~1,300 unique | $10.40 |
| Power-user with similar expansion (~10k rows) | 10,000 | $80.00 |
| Full historical pull (~100k rows) | 100,000 | $800 |

#### Free tier

**15 lifetime preview runs** on the Free plan, each capped at 20 results from your first industry's first board with similar-creator expansion switched off, billed at the Free rate above. No credit card. Plenty to evaluate the field shape and the buyer-money columns before committing.

### FAQ

**What are Douyin (抖音) and Xingtu (巨量星图)?**
Douyin is ByteDance's Chinese short-video platform, the domestic counterpart of TikTok. Xingtu (巨量星图) is its official creator-marketing marketplace, where brands book commercial creators (达人); this actor reads Xingtu's public leaderboards to surface those creators with their rates and brand-order metrics.

**How many creators are on each ranking board?**
Xingtu caps every leaderboard at 100 creators: that's a source-side limit, not ours. Scale comes from combining boards: `all_top` gives ~441 unique creators per industry (six boards, partial overlap), and multi-industry runs multiply that further.

**Why are `finishOrderCnt` and `repurchaseRate` strings like `"> 20"` and `"> 0.75"`?**
That's how Xingtu exposes them to visitor-level access: they're bucketed strings, not exact numbers. Still very usable as tiers (`> 20` brand orders is a strong signal even without the exact count). `cpm`, `vvAvg`, `follower`, and `itemOrderRate` are exact numerics.

**How fresh are the leaderboards?**
Latest monthly snapshots typically have `snapshotDate` from the previous month-end (e.g. `20260430` rolls over to `20260531` early in May). Weekly snapshots update each Monday. Use `all_history_monthly` for trend analysis across historical snapshots.

**How does similar-creator expansion work, and how should I size `maxResults`?**
The pipeline does rankings first, then similar. If `maxResults` is below the ranking yield (~100 per board), the global cap is hit before similar can fire. Set `maxResults` to at least `100 + (similarExpandTopN × 12)` to leave headroom: Xingtu returns up to 12 lookalikes per seed per call, and cross-set dedup runs automatically.

**How are `taskPriceInfos` prices denominated?**
`priceFen` is in 分 (Chinese yuan cents); `priceCny` is the same value as a float in ¥. So `priceFen: 49999` = `priceCny: 499.99` = ¥499.99 for that video type. `videoType` is Xingtu's integer code (1 = short, 2 = mid-length, 71 = 60s+, 91/92 = live-replay, etc.): exposed verbatim so consumers can map to their own taxonomy.

**Can I join this output to other Douyin actors?**
Yes: `coreUserId` is the Douyin user ID. Feed it into [Douyin Profile Scraper](https://apify.com/zen-studio/douyin-profile-scraper) for the full profile + post history, or into [Douyin Search Scraper](https://apify.com/zen-studio/douyin-search-scraper) and use the matching field on each video. `starId` is Xingtu's universal ID and stays stable across actors in this collection.

**Why are some fields `null` on ranking rows and others `null` on similar rows?**
Ranking and similar results have partially overlapping field sets. `cpm`, `finishOrderCnt`, `repurchaseRate`, `itemOrderRate`, `rank`, `rankingBoard`, `snapshotDate`, and the `items[]` array are ranking-only. `linkStarIndex`, `processingOrderCount30d`, `prospective20_60Cpm`, `expectedPlayNum`, `eCommerceEnable`, `isPlanAuthor`, `tagContentLevelOne`, `taskPriceInfos`, `recommendTypes`, and `similarityScore` are similar-only. The `source` discriminator tells you which path produced each row.

**Why doesn't the `家居建材` (Home & Building Materials) industry show up?**
Xingtu publishes `家居建材` only on the lead-collection leaderboards (codes 12–16), which aren't in scope for this actor's v1. Adding it without those boards would yield zero rows for buyers who pick it. Likely v1.1.

**Does the actor work for any Xingtu category?**
Currently the 7 commercial-creator industries listed in the input schema. Live-streamer rankings (different biz scene), app-download leaderboards (codes 7–11), short-drama actor rankings, and lead-collection boards are all v1.1 candidates: open a Feature request if you need one of these.

**Can I get the full creator dossier (audience demographics, bio, posting cadence) from this actor?**
Not in this actor: that's a separate dossier actor scoped for v1.1. This actor covers discovery (rankings + lookalikes); join to Profile Scraper for the deep per-creator view.

**Is the data real-time?**
Catalog reads are live; ranking-list data reflects the latest snapshot Xingtu has published (monthly or weekly cadence: see the freshness FAQ above). No caching on our side.

**Do I need a Douyin or Xingtu account or cookies?**
No. Choose industries and a board, then run; no account, cookie export, or QR login is involved.

**How do I export the rankings?**
The dataset downloads as JSON, CSV, Excel, XML, or HTML from the run's Storage tab, or via the Apify API. Rows are flat, so CSV and Excel work well for ranking spreadsheets.

**Is it legal to scrape Xingtu creator rankings?**
The actor reads publicly available leaderboard data only, nothing behind a login. You are responsible for complying with Douyin's and Xingtu's terms of service and applicable data protection law (GDPR, CCPA, PIPL); creator records are personal data, so check your legal basis before storing or republishing them.

### More Zen Studio scrapers for Chinese platforms

**🎬 Short-video & social**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-YOq90GHMVnTe8qtHO-UAXIIQ87Oj-zhihu-scraper-logo.png" alt="Zhihu 知乎 scraper" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Zhihu 知乎**
  - [Zhihu Scraper](https://apify.com/zen-studio/zhihu-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-wsZZkHvCzyyfZQdaJ-1H1H3xrBpO-weibo-scraper-logo.png" width="16" height="16" alt="Weibo 微博 scraper icon" style="vertical-align:middle;border-radius:3px"> **Weibo 微博**
  - [Weibo Search Scraper](https://apify.com/zen-studio/weibo-search-scraper)
  - [Weibo Comments Scraper](https://apify.com/zen-studio/weibo-comments-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-euYaQMbH2g53W4ds2-Woud1TIQ7x-kwai-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Kwai (Brazil)**
  - [Kwai Search Scraper](https://apify.com/zen-studio/kwai-search-scraper)
  - [Kwai Comments Scraper](https://apify.com/zen-studio/kwai-comments-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-CYLXgIAUzINmhWnzw-Cov56uxElo-kuaishou-scraper-logo.jpg" width="16" height="16" alt="Kuaishou 快手 scraper icon" style="vertical-align:middle;border-radius:3px"> **Kuaishou 快手**
  - [Kuaishou Scraper](https://apify.com/zen-studio/kuaishou-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-3TJaaOJDU1AMiOoJM-Vu2eVr0P6N-douyin-profile-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Douyin 抖音**
  - [Douyin Search Scraper](https://apify.com/zen-studio/douyin-search-scraper)
  - [Douyin Profile Scraper](https://apify.com/zen-studio/douyin-profile-scraper)
  - [Douyin Video Scraper](https://apify.com/zen-studio/douyin-video-scraper)
  - [Douyin Comments Scraper](https://apify.com/zen-studio/douyin-comments-scraper)
  - [Douyin Transcripts Scraper](https://apify.com/zen-studio/douyin-transcripts-scraper)
  - [Douyin Live Recorder](https://apify.com/zen-studio/douyin-live-recorder)
  - [Douyin Hot Search Scraper](https://apify.com/zen-studio/douyin-hot-search-scraper)
  - [Douyin Product Search Scraper](https://apify.com/zen-studio/douyin-product-search-scraper)
  - [Douyin User Search Scraper](https://apify.com/zen-studio/douyin-user-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-mHKEEgoDqr6btQQer-fUs5ZquIeN-xiaohongshu-search-scraper-logo-square.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **RedNote 小红书**
  - [RedNote User Profile Scraper](https://apify.com/zen-studio/rednote-user-profile-scraper)
  - [RedNote Search Scraper](https://apify.com/zen-studio/rednote-search-scraper)
  - [RedNote Comments Scraper](https://apify.com/zen-studio/rednote-comments-scraper)
  - [RedNote Product Search Scraper](https://apify.com/zen-studio/rednote-product-search-scraper)
  - [RedNote Note Detail Scraper](https://apify.com/zen-studio/rednote-note-detail-scraper)
  - [RedNote Product Reviews Scraper](https://apify.com/zen-studio/rednote-product-reviews-scraper)
  - [RedNote Live Recorder](https://apify.com/zen-studio/rednote-live-recorder)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-dexCSKEZtKS8hg4fT-lD4weyiYga-shigua-____-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Xigua 西瓜视频**
  - [Xigua Video Search Scraper](https://apify.com/zen-studio/xigua-video-search-scraper)
  - [Xigua Video Detail Scraper](https://apify.com/zen-studio/xigua-video-detail-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-oSxuPDE1h3HAsHZSu-x3uV98mgTe-bilibili-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Bilibili 哔哩哔哩**
  - [Bilibili Video Scraper](https://apify.com/zen-studio/bilibili-video-scraper)
  - [Bilibili Danmaku Scraper](https://apify.com/zen-studio/bilibili-danmaku-scraper)

**🛒 E-commerce**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-yK9Fwkji44bQkuS7P-f1uyK15FaQ-naver-shopping-scraper.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Naver Search 네이버 검색**
  - [Naver Search Scraper](https://apify.com/zen-studio/naver-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-LwARSYSMWLBZfXfdr-FrDaNbQarB-shopee-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Shopee**
  - [Shopee Product Detail Scraper](https://apify.com/zen-studio/shopee-product-detail-scraper)
  - [Shopee Product Reviews Scraper](https://apify.com/zen-studio/shopee-product-reviews-scraper)
  - [Shopee Product Scraper](https://apify.com/zen-studio/shopee-product-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-PsAKYWM55HG4AHXjK-ItywU7Bp0s-taobao-search-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Taobao 淘宝**
  - [Taobao Search Scraper](https://apify.com/zen-studio/taobao-search-scraper)
  - [Taobao Product Detail Scraper](https://apify.com/zen-studio/taobao-detail-scraper)
  - [Taobao Seller Products Scraper](https://apify.com/zen-studio/taobao-seller-products-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-uZy6tbKLKnSVtT4BN-emXnT123uR-jd-com-scraper-logo-square.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **JD.com 京东**
  - [JD.com Search Scraper](https://apify.com/zen-studio/jd-com-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-ghXSMZcW3GxsCrkiR-5hnvsKv4Yt-1688-wholesale-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **1688 阿里巴巴**
  - [1688 Wholesale Scraper](https://apify.com/zen-studio/1688-wholesale-scraper)
  - [Alibaba Scraper](https://apify.com/zen-studio/alibaba-scraper)
  - [1688 Reviews Scraper](https://apify.com/zen-studio/1688-reviews-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-eab843E8WtuH7V3oz-a9TgvZnNOZ-weidian-scraper-icon.png" width="16" height="16" alt="Weidian 微店 scraper icon" style="vertical-align:middle;border-radius:3px"> **Weidian 微店**
  - [Weidian Scraper](https://apify.com/zen-studio/weidian-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-5QcLc4BHaLMBUKYs3-f3CWQ60Row-goofish-search-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Goofish 闲鱼**
  - [Goofish (Xianyu) Search Scraper](https://apify.com/zen-studio/goofish-xianyu-search-scraper)
  - [Goofish (Xianyu) Seller Scraper](https://apify.com/zen-studio/goofish-xianyu-seller-scraper)
  - [Goofish (Xianyu) Item Detail Scraper](https://apify.com/zen-studio/goofish-xianyu-item-detail-scraper)
  - [Goofish (Xianyu) Item Comments & Q\&A Scraper](https://apify.com/zen-studio/goofish-xianyu-item-comments-scraper)
  - [Goofish (Xianyu) Reverse Image Search Scraper](https://apify.com/zen-studio/goofish-xianyu-visual-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-gs9qvJ0HhrF4yp4Cv-IbbfBu9zL1-dewu-scraper-logo.png" width="16" height="16" alt="Dewu 得物 scraper icon" style="vertical-align:middle;border-radius:3px"> **Dewu 得物**
  - [Dewu POIZON Scraper](https://apify.com/zen-studio/dewu-poizon-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-0hS9yNh3RU8DC6puG-LozxRJkdHN-coupang-review-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Coupang 쿠팡**
  - [Coupang Review Scraper](https://apify.com/zen-studio/coupang-review-scraper)
  - [Coupang Search Scraper](https://apify.com/zen-studio/coupang-search-scraper)
  - [Coupang Product Detail Scraper](https://apify.com/zen-studio/coupang-detail-scraper)

**🏠 Real estate & autos**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-1tAzNSf8Kz0v7Q2Lr-AINJ7FsZVU-anjuke-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Anjuke 安居客**
  - [Anjuke For-Sale Listings Scraper](https://apify.com/zen-studio/anjuke-real-estate-scraper)
  - [Anjuke New-Home Scraper](https://apify.com/zen-studio/anjuke-new-home-scraper)
  - [Anjuke Rental Listings Scraper](https://apify.com/zen-studio/anjuke-rent-scraper)
  - [Anjuke Listing Detail Scraper](https://apify.com/zen-studio/anjuke-sale-detail-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-32OkWqsiUywoq2ci3-7JhFlW1qg3-58__-real-estate-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **58.com 58同城**
  - [58.com Real Estate Scraper](https://apify.com/zen-studio/58-real-estate-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-ytaE4YpSmjXDmibPv-L1UMPHa2bO-che168-autohome-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Autohome 汽车之家**
  - [Autohome (Che168) Used-Car Scraper](https://apify.com/zen-studio/che168-car-scraper)

### Support

- **Bugs**: Issues tab
- **Features**: Issues tab

### Legal Compliance

Returns publicly available data from Douyin's Xingtu (巨量星图) creator-marketplace leaderboards. Users must comply with Douyin's and Xingtu's terms of service, and applicable data-protection regulations (GDPR, CCPA, PIPL) when storing or processing the output.

***

*Top Douyin commercial creators, ranked, with CPM rates, brand-order metrics, follower counts, and a stable creator ID. One row per creator, in clean JSON.*

# Actor input Schema

## `industries` (type: `array`):

Pick one or more industries. Each industry runs independently.<br><br>Some combinations of <b>creator type</b> may not be available for every industry — the actor will silently skip any combos with no published leaderboard.

## `creatorType` (type: `string`):

Which kind of creators to pull from the Xingtu leaderboards.<br><br>• <b>Top creators</b> — best for brand deals (品牌优选榜)<br>• <b>Rising stars</b> — fast-growing, high-potential breakouts<br>• <b>Sales champions</b> — top by completed brand orders & e-commerce sales<br>• <b>Viral content drivers</b> — best at sparking searches & engagement (A3种草 + 看后搜)<br>• <b>Paid-ad performers</b> — highest ROI on paid promotion<br>• <b>Head-tier mega creators</b> — the most-booked head creators<br>• <b>All top creators (combined)</b> — power-user mega-run, combines all 6 brand-seeding boards

## `timeWindow` (type: `string`):

<b>Latest monthly</b> is the recommended default — fresh rankings, clean data. Use <b>All historical monthly</b> for trend analysis (much larger result set).

## `maxResults` (type: `integer`):

Hard cap on emitted rows. Each unique creator counts toward your bill.<br><br>Defaults to 100 (one board's worth). Bump higher only if you've picked <b>All top creators</b> or multiple industries.

## `includeSimilarCreators` (type: `boolean`):

Adds a second pass: for each ranked creator (top N per board), pulls similar creators via Xingtu's lookalike graph. Each lookalike counts as one result (same price). Use this to discover emerging creators below the top-100 cap.<br><br><b>Tip:</b> rankings load first, then similar. If <b>Max results</b> is below the ranking total (~100 per board), similar never fires. Set Max results to at least <code>100 + (top-N seeds × 12)</code> for similar to have room to emit.

## `similarExpandTopN` (type: `integer`):

Only matters when the toggle above is ON. For each ranked creator board, the first N rows become 'seeds' for similar-creator expansion. Higher N = more lookalikes, more cost.

## `similarType` (type: `string`):

Which similarity dimension Xingtu uses to score lookalikes.<br><br>• <b>Content</b> — content style + topics (default; good general lookalikes)<br>• <b>Audience</b> — audience overlap<br>• <b>Commercial</b> — commercial profile (CPM, sales)<br>• <b>Comprehensive</b> — weighted combination

## `feedback` (type: `string`):

For AI agents. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns.

## Actor input object example

```json
{
  "industries": [
    "美妆"
  ],
  "creatorType": "top_creators",
  "timeWindow": "latest_monthly",
  "maxResults": 100,
  "includeSimilarCreators": false,
  "similarExpandTopN": 20,
  "similarType": "content"
}
```

# Actor output Schema

## `creators` (type: `string`):

Link to the dataset containing all ranked and similar Douyin commercial creators.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "industries": [
        "美妆"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("zen-studio/douyin-xingtu-rankings-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "industries": ["美妆"] }

# Run the Actor and wait for it to finish
run = client.actor("zen-studio/douyin-xingtu-rankings-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "industries": [
    "美妆"
  ]
}' |
apify call zen-studio/douyin-xingtu-rankings-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,zen-studio/douyin-xingtu-rankings-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/C2EwnkD3ZghKcF9F0/builds/3H4sdnANXTb5BTX8J/openapi.json
