Douyin Analytics Scraper

🔥 Douyin hot-search analytics for current trend signals

For social-listening teams, China market researchers, content planners, newsroom researchers, brand teams, and developers, this Actor collects current public Douyin hot-search topics. Each saved row includes the source rank, topic text, hot and video metrics, source IDs, cover-image URLs, and source times. You get structured trend data in an Apify dataset for reports and dashboards.

Use the dataset in Apify, export it as JSON, CSV, Excel, XML, RSS, or HTML, or read it through the Apify API.

• Review current hot-search metrics for social listening with Douyin Analytics Scraper.
• Monitor a scheduled trend snapshot with Douyin Trends.
• Export ranked topics for content planning with Douyin Trending Topics.
• Compare topic lists across runs with Douyin Hot Search Trends.
• Feed hot-search data into a dashboard with Douyin Hot Search Scraper.

📈 What you get from each Douyin trend row

Each dataset row contains one hot-search topic returned by Douyin. The Actor keeps the source rank order and saves the topic fields returned for that row. Some source fields are null when Douyin does not return them.

The Actor keeps source IDs, the source URL, a snapshot ID, source and scrape times, trend metrics, and cover-image URLs. It does not collect video search or profile analytics, scrape comments, collect emails or phone numbers, download videos, audio, or images, automate logged-in accounts, translate or classify topic text, score sentiment, or access private or logged-in-only data. Other Douyin surfaces may require login. Cover-image URLs are source-hosted links and can expire or change.

▶️ Run a current Douyin hot-search snapshot

1. Set Trend limit to 30 for a small first run or choose a higher value for more current topics.
2. Start the Actor and open the dataset when the run finishes.
3. Leave the limit empty when you want all available topics until the source is exhausted.

Run the Actor again when you need another current list. Each saved row keeps the source and scrape times returned with it.

⚙️ Input

Input fields

Field	Type	What it does
maxResults	integer	Sets the maximum number of current Douyin hot-search topics to return. Use 30 for a small sample or a higher value for more topics.

Example input

This public input is copied from a successful current-beta default-input run.

{
  "maxResults": 30
}

Work limit

Leave Trend limit empty to return all available topics until the source is exhausted. The source can return fewer topics than the limit. Use 30 for a quick sample or a higher value for more topics.

🧾 Output

Output panel

Field	Type	What it does
results	string URL	Opens the run dataset with the saved Douyin trend rows.

Trend row fields

Field	Type	What it does
rowType	string	Identifies the row as a hotSearchTrend row.
inputMode	string	Names the Douyin source mode used for the row.
inputValue	string	Gives the source value used to create the row.
rank	integer	Gives the topic's rank in Douyin's hot-search list.
titleOrKeyword	string	Gives the hot-search topic text from Douyin.
douyinId	string or null	Gives the main Douyin sentence or group ID when available.
sentenceId	string or null	Gives the Douyin sentence ID when available.
groupId	string or null	Gives the Douyin group ID when available.
sourceIds	object	Groups the source sentence and group IDs.
sourceIds.sentenceId	string or null	Gives the source sentence ID when available.
sourceIds.groupId	string or null	Gives the source group ID when available.
sourceUrl	string URL	Gives the Douyin hot-search URL used for the row.
scrapedAt	date-time string	Gives the UTC time when the Actor saved the row.
snapshotId	string	Gives the Douyin hot-search snapshot ID.
trend	object	Groups the trend metrics and source attributes.
trend.hotValue	number or null	Gives Douyin's hot value when available.
trend.videoCount	number or null	Gives the video count reported by Douyin when available.
trend.discussVideoCount	number or null	Gives the discussion-video count reported by Douyin when available.
trend.articleDetailCount	number or null	Gives the article count reported by Douyin when available.
trend.roomCount	number or null	Gives the live-room count reported by Douyin when available.
trend.maxRank	number or null	Gives the maximum rank reported by Douyin when available.
trend.eventTime	date-time string or null	Gives the trend or event time reported by Douyin in UTC when available.
trend.sentenceTag	number or null	Gives Douyin's sentence tag when available.
trend.wordType	number or null	Gives Douyin's word type when available.
trend.label	number or null	Gives Douyin's category label when available.
media	object	Groups the cover-image URLs returned by Douyin.
media.coverImageUrl	string URL or null	Gives the first cover-image URL when available.
media.coverImageUrls	array of URL strings	Lists the cover-image URLs returned for the topic. The list can be empty.
sourceReturnedAt	date-time string or null	Gives the UTC time reported by Douyin for the hot-search response when available.

Example trend row

This unshortened row is copied from the successful current-beta run with a 50-topic limit.

{
  "rowType": "hotSearchTrend",
  "inputMode": "hotSearch",
  "inputValue": "hotSearch",
  "rank": 1,
  "titleOrKeyword": "茸主将对阵拉法加西亚",
  "douyinId": "2646005",
  "sentenceId": "2646005",
  "groupId": "7684219191230584127",
  "sourceIds": {
    "sentenceId": "2646005",
    "groupId": "7684219191230584127"
  },
  "sourceUrl": "https://www.douyin.com/aweme/v1/web/hot/search/list/?device_platform=webapp&aid=6383&channel=channel_pc_web",
  "scrapedAt": "2026-09-12T19:10:16.659Z",
  "snapshotId": "202609130310165D27982E6281D9573819",
  "trend": {
    "hotValue": 12110684,
    "videoCount": 1,
    "discussVideoCount": 1,
    "articleDetailCount": 0,
    "roomCount": null,
    "maxRank": 1,
    "eventTime": "2026-09-12T00:47:37.000Z",
    "sentenceTag": 5000,
    "wordType": 1,
    "label": 3
  },
  "media": {
    "coverImageUrl": "https://p3-sign.douyinpic.com/tos-cn-p-0015/ogK2IaIGJ1eB83SClVSkBfQIydLjv7ASfFCMkA~noop.jpeg?lk3s=bfd515bb&x-expires=1789261200&x-signature=ufXotg47DxdIkaabvncgwVvDSXc%3D&from=3218412987",
    "coverImageUrls": [
      "https://p3-sign.douyinpic.com/tos-cn-p-0015/ogK2IaIGJ1eB83SClVSkBfQIydLjv7ASfFCMkA~noop.jpeg?lk3s=bfd515bb&x-expires=1789261200&x-signature=ufXotg47DxdIkaabvncgwVvDSXc%3D&from=3218412987",
      "https://p26-sign.douyinpic.com/tos-cn-p-0015/ogK2IaIGJ1eB83SClVSkBfQIydLjv7ASfFCMkA~noop.jpeg?lk3s=bfd515bb&x-expires=1789261200&x-signature=8T7ew1Nz%2FGsRHFgtm1u%2BLVAr1sQ%3D&from=3218412987",
      "https://p11-sign.douyinpic.com/tos-cn-p-0015/ogK2IaIGJ1eB83SClVSkBfQIydLjv7ASfFCMkA~noop.jpeg?lk3s=bfd515bb&x-expires=1789261200&x-signature=lE2attkP%2BxYKNV9oSWgEh5n7JQw%3D&from=3218412987"
    ]
  },
  "sourceReturnedAt": "2026-09-12T19:07:47.000Z"
}

💳 Pricing

This Actor uses pay-per-event pricing. You are charged for each hot-search trend saved to the dataset. A run that saves no trend has no trend event to charge.

Charged event

Hot-search trend: One hot-search trend saved to the dataset.

🔌 Integrations

Open the dataset in Apify, read it through the Apify API, or use an Apify schedule for repeated runs.

Video walkthrough

❓ FAQ

Can I collect Douyin videos or profiles?

No. This Actor covers the current public hot-search topic list. Video search, profile analytics, comments, and other Douyin surfaces are outside its scope.

What happens when I leave Trend limit empty?

The Actor returns all available topics until the source is exhausted. It can return fewer rows when the source has fewer topics.

What does one dataset row represent?

One row contains one hot-search topic returned by Douyin. The row keeps the topic's source rank and topic text.

Are all trend metrics always present?

No. Douyin can omit a metric or identifier for a topic, so optional fields can be null. Cover-image lists can also be empty.

Does this Actor calculate historical growth?

No. It collects current public hot-search rows. It does not calculate growth from earlier runs.

📝 Changelog

v1.0 (08-09-2026)

• Trend rows now focus on hot-search topics, source IDs, trend metrics, cover images, and source times. Creator and video detail fields are no longer returned.
• The Actor retries temporary Douyin source failures and reports a clear run failure when no usable response arrives.
• Repeated topics are saved only once, and the Trend limit can request more than 50 topics when Douyin returns them.

v0.2

• Added richer trend output fields.
• Added a dataset table view in Console.
• Lowered the price for each result.
• Improved handling when Douyin is temporarily unavailable.

v0.1

• Initial release.

🆘 Support

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

🔗 Related Actors

• Weibo Scraper for Posts and Feeds - collect Weibo hot-search topics and public social data for Chinese-platform comparison.
• Kuaishou Scraper - track Kuaishou hot-board topics and source metrics for another Chinese trend feed.
• YouTube Trending Videos Scraper - compare ranked YouTube trends by region and category.
• Twitter Scraper - add regional X trends and public posts to a broader social-monitoring workflow.
• Douyin Hot Search Scraper - compare current Douyin hot-search topics with another direct hot-search Actor.

Made with ❤️ by Maxime Dupré