Douyin Trend Scraper

What is Douyin Trend Scraper?

Douyin Trend Scraper is a Douyin (抖音 / Chinese TikTok) trends and hot-search intelligence Actor with two focused modes:

• Current trends exports the live hot-topic and rising-topic ranking.
• Keyword trend analysis compares interest over time for up to five terms, nationwide or for selected Chinese regions.

Use it for China-market research, social listening, content planning, editorial monitoring, and scheduled trend datasets. No Douyin login, cookie, browser, or proxy configuration is required from you.

Why use this Douyin trend scraper?

• Choose the product you need. Export a current ranking snapshot or buy deeper keyword history only when you need it.
• Compare up to five keywords. Analyze daily interest nationwide or across selected Chinese regions in one request.
• Get consistent structured output. Current and keyword rows share one typed schema with documented mode-specific fields.
• Keep measurements machine-ready. Trend indexes, ranks, changes, and daily values are numeric—not abbreviated display text.
• Control spend. Every visible row is priced transparently, and the Actor respects the run's maximum charge.
• Automate recurring research. Save a task, schedule snapshots, trigger webhooks, and export JSON, CSV, Excel, XML, HTML, or JSONL.

How to get Douyin trends

Current hot and rising topics

{
  "mode": "current",
  "trendType": "all",
  "maxResults": 50
}

Choose hot, rising, or all. Each row contains rank and topic, with the reported topic index and rank movement when available.

Compare keyword popularity

{
  "mode": "keyword",
  "keywords": ["新能源汽车", "人工智能"],
  "regions": ["北京", "上海"],
  "startDate": "2026-07-01",
  "endDate": "2026-07-31"
}

Each returned keyword row includes a daily interestOverTime series. If dates are omitted, the Actor uses the latest 30 UTC calendar days. Leave regions empty for nationwide data.

What data can I extract?

Current trend fields

Field	Description
sourceMode	current
trendType	Requested hot/rising selection
rank	One-based position in the returned ranking
topic	Trend text
hotIndex	Topic index reported by Douyin
rankChange	Reported ranking movement
scrapeTimestamp	UTC collection time

Keyword analysis fields

Field	Description
sourceMode	keyword
keyword	Analyzed term
interestOverTime	Array of {"date": "YYYY-MM-DD", "value": number} points
regions	Requested regional filters; empty means nationwide
startDate, endDate	Inclusive analysis window
scrapeTimestamp	UTC collection time

Fields unavailable for a particular topic are omitted. Video counts, view counts, topic IDs, covers, and event timestamps are not part of this product's published output.

Current trend output example

{
  "sourceMode": "current",
  "trendType": "hot",
  "rank": 1,
  "topic": "示例热点",
  "hotIndex": 9823412,
  "rankChange": 3,
  "scrapeTimestamp": "2026-08-26T12:00:00.000Z"
}

Keyword output example

{
  "sourceMode": "keyword",
  "keyword": "新能源汽车",
  "interestOverTime": [
    { "date": "2026-07-30", "value": 73 },
    { "date": "2026-07-31", "value": 81 }
  ],
  "regions": ["北京", "上海"],
  "startDate": "2026-07-01",
  "endDate": "2026-07-31",
  "scrapeTimestamp": "2026-08-26T12:00:00.000Z"
}

Both examples show the published output shape and are not presented as captured live rows.

Input reference

Parameter	Used in	Default	Limits	Description
mode	both	current	—	Current ranking or keyword analysis
trendType	current	all	—	all, hot, or rising
maxResults	current	50	1–200	Maximum current-topic rows
keywords	keyword	required	1–5	Terms to compare
startDate	keyword	latest 30 days	YYYY-MM-DD	First analysis date
endDate	keyword	current UTC date	YYYY-MM-DD	Last analysis date
regions	keyword	nationwide	0–20	Chinese province or city names

Impossible dates and reversed date ranges are rejected before billable work begins.

Reliable results and billing

The selected date window remains consistent throughout a run. Interrupted runs can continue without duplicating rows already delivered, and charges track visible results. If a result cannot be validated, the run reports a clear sanitized error instead of returning questionable data.

How much does Douyin trend data cost?

You pay for each visible result. Current topics and keyword analyses have separate total prices, shown below.

Current trend result

Apify tier	Per topic	Per 1,000 topics
Free	$0.00899	$8.99
Bronze	$0.00799	$7.99
Silver	$0.00749	$7.49
Gold	$0.00699	$6.99

Keyword trend result

Apify tier	Per keyword	Per 1,000 keywords
Free	$0.01099	$10.99
Bronze	$0.00999	$9.99
Silver	$0.00899	$8.99
Gold	$0.00799	$7.99

An additional $0.001 run-start charge applies.

Platinum and Diamond users receive the listed Gold price.

Example on the Free tier	Estimated cost
50 current topics	$0.451
5 keyword comparisons	$0.056
30 daily runs × 50 topics	$13.515

Examples include the run-start charge. You are charged only for rows written to the dataset. The Actor respects the maximum total charge configured for the run.

What can I build with it?

• Daily or hourly China trend dashboards
• Editorial and newsroom monitoring
• Content ideation based on rising topics
• Product-category and brand-interest comparisons
• Regional demand research
• Alerts when a keyword's interest changes
• Historical trend archives using Apify schedules

Integrations

Connect results to Apify Schedules and Webhooks, Make, Zapier, Google Sheets, Slack, dashboards, warehouses, or your own API client. JSON and JSONL preserve the nested keyword time series most naturally; CSV and Excel remain available for spreadsheet workflows.

FAQ

How fresh are current trends?

Current mode requests a fresh ranking during the run. scrapeTimestamp records exactly when each row was produced.

Is keyword analysis the same as the current hot-topic board?

No. Current mode is a ranking snapshot. Keyword mode returns a date-indexed interest series for terms you choose.

Can I analyze more than five keywords?

Each run supports up to five keywords. Use multiple tasks or runs for larger sets.

Can I export the nested time series to CSV?

Yes, though JSON or JSONL preserves interestOverTime most naturally. CSV and Excel serialize the nested array in one cell.

Related Douyin Actors

Actor	Best for
Douyin Creator Scraper	Discover public accounts from a niche, name, or brand
Douyin Profile Scraper	Resolve known accounts and optionally export public posts
Douyin Search Scraper	Find public videos by keyword with engagement and creator data

Legal and responsible use

Trend rows are public topic-level data, but downstream use can still be regulated. Review Douyin's User Service Agreement, Privacy Policy, and the laws applicable to your collection, storage, publication, and analysis.

Support

For a bug or feature request, open an Apify issue. Include the run ID, selected mode, expected behavior, and input with sensitive values removed.