Douyin Analytics Scraper

🔥 Douyin analytics scraper for hot search trends

Douyin Analytics Scraper collects current hot search trend data from Douyin. Run it to export ranked Douyin hot search topics with hot values, video counts, discussion-video counts, source IDs, cover image URLs, source timestamps, and scrape timestamps.

Use this Actor when you need a repeatable Douyin trend export for social listening, China market research, content planning, newsroom research, brand monitoring, or internal dashboards. Instead of checking the Douyin hot search page by hand, you get structured trend data in an Apify dataset that you can download as JSON, CSV, Excel, XML, RSS, or HTML, or send through the Apify API, scheduler, webhooks, and integrations.

For a small first run, set Trend limit to 30. Hot search trends work without a Douyin login.

✅ What this Actor does

• Collects Douyin hot search trends.
• Saves one result per hot search trend.
• Preserves Douyin's source rank order.
• Adds hot value, video count, discussion-video count, room count, and max-rank fields when Douyin returns them.
• Adds article counts when Douyin returns them.
• Adds Douyin source identifiers such as sentence ID or group ID when available.
• Adds source URL, source-returned timestamp, snapshot ID, and scrape timestamp for traceability.
• Can include cover image URLs for each trend.
• Caps each run at the current public hot search list size returned by Douyin.
• Runs without a user-provided Douyin login, cookies, or API key for hot search trends.

This Actor is focused on Douyin hot search analytics. It does not download videos, scrape comments, extract emails or phone numbers, automate logged-in Douyin accounts, translate trend text, or run sentiment analysis.

📦 Data you can extract

Each dataset item represents one Douyin hot search trend. Fields include:

• rowType - hotSearchTrend for trend rows.
• inputMode and inputValue - the source mode used for the row.
• rank - Douyin's source rank for the trend.
• titleOrKeyword - the hot search topic text.
• douyinId - Douyin sentence ID or group ID when available.
• sentenceId and groupId - flat source ID fields for spreadsheet compatibility.
• sourceIds.sentenceId and sourceIds.groupId - Douyin source identifiers when available.
• sourceUrl - source URL used for the trend list.
• scrapedAt - UTC timestamp when the row was saved.
• snapshotId - source snapshot identifier when Douyin returns one.
• trend.hotValue - Douyin hot value.
• trend.videoCount and trend.discussVideoCount - visible trend-related video counts.
• trend.roomCount, trend.maxRank, trend.eventTime, trend.sentenceTag, trend.wordType, and trend.label when available.
• media.coverImageUrl and media.coverImageUrls when Douyin returns cover images.
• creator.username, creator.nickname, and creator.followerCount when Douyin attaches a creator to the trend.
• video.videoId, video.description, and engagement fields when Douyin attaches a video to the trend.
• Flat username, nickname, followerCount, videoId, description, playCount, likeCount, commentCount, and shareCount aliases for easier CSV comparison with other Douyin trend exports.
• sourceReturnedAt - timestamp reported by the source, converted to UTC when available.

Some fields can be null when Douyin does not return that value for a specific trend.

🚀 Common use cases

• Track current Douyin hot search topics for social listening.
• Export Douyin trend ranks and hot values into a spreadsheet.
• Watch China social trends for content, PR, or market research.
• Feed Douyin hot search topics into dashboards, alerts, or AI workflows.
• Compare trend lists across scheduled Apify runs.
• Keep source IDs and timestamps for repeatable research notes.
• Collect cover image URLs for quick trend review.

▶️ How to run it

1. Set Trend limit to 30 for a quick sample or 50 for the full current public list returned by Douyin.
2. Start the Actor and open the dataset when the run finishes.

For scheduled monitoring, keep the same input and use Apify schedules. Each run saves a fresh trend snapshot with scrape timestamps and source metadata.

🛠️ Input

🧪 Example input

{
	"maxResults": 30
}

🔢 Trend limit

Set how many Douyin hot search trends to save. Use 30 for a small first run or 50 for the full current hot search list returned by the public source.

📊 Output example

{
	"rowType": "hotSearchTrend",
	"inputMode": "hotSearch",
	"inputValue": "hotSearch",
	"rank": 1,
	"titleOrKeyword": "神舟二十三号点火发射",
	"douyinId": "2510281",
	"sentenceId": "2510281",
	"groupId": "7640647881717110026",
	"sourceIds": {
		"sentenceId": "2510281",
		"groupId": "7640647881717110026"
	},
	"sourceUrl": "https://www.douyin.com/aweme/v1/web/hot/search/list/?device_platform=webapp&aid=6383&channel=channel_pc_web",
	"scrapedAt": "2026-05-24T15:23:47.080Z",
	"snapshotId": "202605242323462B975C9C801B104FB016",
	"trend": {
		"hotValue": 12126931,
		"videoCount": 9,
		"discussVideoCount": 1,
		"articleDetailCount": 0,
		"roomCount": 2,
		"maxRank": 1,
		"eventTime": "2026-05-24T03:49:16.000Z",
		"sentenceTag": 6000,
		"wordType": 1,
		"label": 6
	},
	"media": {
		"coverImageUrl": "https://p11-sign.douyinpic.com/example.jpeg",
		"coverImageUrls": ["https://p11-sign.douyinpic.com/example.jpeg"]
	},
	"creator": {
		"username": null,
		"nickname": null,
		"followerCount": null
	},
	"video": {
		"videoId": null,
		"description": null,
		"playCount": null,
		"likeCount": null,
		"commentCount": null,
		"shareCount": null
	},
	"username": null,
	"nickname": null,
	"followerCount": null,
	"videoId": null,
	"description": null,
	"playCount": null,
	"likeCount": null,
	"commentCount": null,
	"shareCount": null,
	"status": "ok",
	"warning": null,
	"unavailableReason": null,
	"targetSucceeded": true,
	"sourceReturnedAt": "2026-05-24T15:21:34.000Z"
}

💳 Pricing

This Actor uses pay-per-event pricing. You are charged for each Douyin hot search trend found and saved. Runs that stop without saving trends do not charge for trend results.

Use Trend limit to keep run size predictable. The current public hot search source returns up to 50 trends per run.

⚠️ Limits and caveats

• Hot search trends are collected from Douyin's public no-login source surface.
• Video search and profile analytics currently require login on Douyin's web source and are not part of this no-login hot-search Actor.
• The Actor saves the trend metrics Douyin returns at run time; it does not calculate historical trend growth.
• Trend text is returned as Douyin provides it. The Actor does not translate, classify, or score sentiment.
• Cover image URLs can expire or change because they are source-hosted media links.
• The Actor does not download videos, audio, comments, private data, emails, phone numbers, or logged-in-only content.

❓ FAQ

🔐 Does this Douyin analytics scraper need a Douyin account?

No account, cookies, or API key is needed for Hot search trends. Other Douyin surfaces can require login, so this Actor does not claim to scrape video search or profile analytics until those surfaces can be collected safely.

🔢 Can I get all 50 current Douyin hot search trends?

Yes. Set Trend limit to 50. The Actor saves results in Douyin's source rank order.

📅 Can I schedule repeat trend checks?

Yes. Use Apify schedules to run the same input repeatedly. Each run saves a fresh dataset with scrape timestamps and source snapshot fields.

🌐 Does the Actor translate Chinese trend text?

No. It saves trend text as Douyin returns it. You can translate or classify the exported dataset in your own workflow.

📝 Changelog

• 0.2: Added richer trend output fields, a Console dataset table view, lower result pricing, and more reliable handling when Douyin is temporarily unavailable.
• 0.1: Initial release.

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Other actors

• TikTok Keywords Discovery Tool ↗ - collect TikTok autocomplete keyword ideas for social search research.
• TikTok Transcript Scraper ↗ - extract transcript text and public metadata from TikTok video URLs.
• Twitter Scraper ↗ - collect public X posts or current trending topics for social monitoring.
• YouTube Channel Scraper ↗ - export public YouTube channel profiles and recent video data.
• Pinterest Keyword Scraper ↗ - collect Pinterest autocomplete keyword suggestions for content planning.

Made with ❤️ by Maxime Dupré