Douyin Search Scraper

What is Douyin Search Scraper?

Douyin Search Scraper is a keyword video-search Actor for Douyin (抖音 / Chinese TikTok). Enter topics, products, brands, or phrases and receive structured public videos with engagement, media, music, hashtags, and creator details.

It is built for brands, agencies, researchers, publishers, and data teams that need automation-ready Douyin content discovery without supplying a login, cookies, a browser, or a proxy.

Why use this Douyin search scraper?

• Search up to 50 terms per run. Every row keeps its matching keyword in sourceQuery.
• Choose how results are ranked. Search by relevance, most liked, or newest.
• Filter by freshness and duration. Focus on recent posts or videos within a useful length range.
• Export up to 55 typed fields. Collect exact engagement counts, media links, music, hashtags, stable post IDs, and embedded creator context.
• Remove repeated results. Each query returns unique post rows and preserves its one-based resultPosition.
• Automate the output. Export JSON, CSV, Excel, XML, HTML, or JSONL and connect schedules, webhooks, Make, Zapier, or the Apify API.
• Control every run's spend. The Actor respects the maximum charge selected for the run.

How to search Douyin videos

1. Add one or more keywords such as 机器人, 户外露营, or a brand name.
2. Choose the maximum videos per keyword.
3. Select the result order, publication window, and video duration.
4. Run the Actor and open the Search results dataset.

Input example

{
  "searchQueries": ["机器人", "户外露营"],
  "maxPostsPerQuery": 100,
  "sortType": "most_liked",
  "publishTime": "last_week",
  "duration": "under_1m"
}

Duplicate keywords are removed before searching. Chinese and Latin text are supported.

What data can I extract?

Each dataset item is one unique public video matched by one search keyword.

Field group	Included data
Search context	sourceQuery, resultPosition, scrapeTimestamp
Post identity	awemeId, postUrl, description, createTimeIso, mediaTypeName
Engagement	playCount, likeCount, commentCount, shareCount, collectCount, downloadCount
Media	videoUrl, coverUrl, imageUrls, durationMs, width, height
Music and topics	musicId, musicTitle, musicAuthor, musicUrl, hashtags
Creator identity	profileUid, profileSecUid, profileShortId, profileUniqueId, profileNickname, profileUrl
Creator audience	profileFollowerCount, profileFollowingCount, profileAwemeCount, profileTotalFavorited, profileFavoritingCount
Creator profile	Bio, avatar variants, verification, account flags, gender, region, location, language, live status, and published linked-account IDs

Fields that Douyin does not publish for a result are omitted. Large IDs are stored as strings so spreadsheets and JavaScript do not round them. Counts are returned as reported integers rather than abbreviated labels such as 42.8K.

Media links can be temporary. Download media you are entitled to retain soon after the run. Douyin may report zero when a counter is unavailable; the Actor preserves that value and does not estimate a replacement.

The example below is illustrative and does not represent a specific person or captured live row.

Output example

{
  "sourceQuery": "机器人",
  "resultPosition": 1,
  "awemeId": "7530000000000000001",
  "description": "机器人应用演示",
  "createTimeIso": "2026-08-20T08:30:00.000Z",
  "postUrl": "https://www.douyin.com/video/7530000000000000001",
  "playCount": 128400,
  "likeCount": 9600,
  "commentCount": 318,
  "shareCount": 504,
  "collectCount": 1200,
  "mediaTypeName": "video",
  "videoUrl": "https://example.com/video.mp4",
  "coverUrl": "https://example.com/cover.jpg",
  "hashtags": ["机器人", "科技"],
  "profileUniqueId": "example_creator",
  "profileNickname": "示例创作者",
  "profileFollowerCount": 428000,
  "profileVerified": true,
  "profileUrl": "https://www.douyin.com/user/MS4wLjABAAAA...",
  "scrapeTimestamp": "2026-08-27T10:30:00.000Z"
}

Input reference

Parameter	Type	Default	Limits	Description
searchQueries	string[]	required	1–50	Video-search keywords
maxPostsPerQuery	integer	50	1–5,000	Maximum unique rows for each keyword
sortType	string	relevance	—	relevance, most_liked, or latest
publishTime	string	any	—	Any time, last day, last week, or last six months
duration	string	any	—	Any length, under one minute, one to five minutes, or over five minutes

Reliable results and billing

Interrupted runs can continue without duplicating rows already delivered. Repeated matches are removed, charges track unique rows visible in the dataset, and incomplete work is reported with a clear sanitized error instead of questionable data.

How much does Douyin search data cost?

You pay for each unique video row returned. You are not charged a result event for missing or repeated rows.

Apify tier	Per result	Per 1,000 results
Free	$0.00549	$5.49
Bronze	$0.00549	$5.49
Silver	$0.00549	$5.49
Gold	$0.00549	$5.49

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 results	$0.276
2 keywords × 100 results	$1.099
30 daily runs × 50 results	$8.265

Examples include the run-start charge. Actual output can be lower than the requested maximum when fewer matching public videos are available. The Actor respects the maximum total charge configured for the run.

Common use cases

• Brand and competitor content research
• Product, category, and campaign monitoring
• High-engagement video discovery
• Editorial research and content ideation
• Creator discovery from successful posts
• Scheduled keyword snapshots
• Hashtag and music analysis
• Building public content datasets for compliant analysis

Integrations

Use the Actor with Apify Schedules, Webhooks, API clients, Make, Zapier, Google Sheets, Slack, a warehouse, or any system that accepts JSON, CSV, Excel, XML, HTML, or JSONL exports.

FAQ

Do I need a Douyin account or cookie?

No. The Actor does not ask you for login credentials or cookies.

Can I search in Chinese and English?

Yes. Chinese and Latin text are supported. Results depend on the public videos Douyin makes available for each keyword.

Why did I receive fewer rows than requested?

The requested maximum is a ceiling, not a guarantee. A narrow keyword, strict freshness or duration filter, repeated matches, removed posts, or current public availability can reduce the result count.

Can I schedule recurring searches?

Yes. Save the input as an Apify task, attach a schedule, and use a webhook or integration to send each completed dataset downstream.

Related Douyin Actors

Actor	Best for
Douyin Creator Scraper	Discover public accounts by keyword and audience filters
Douyin Profile Scraper	Resolve known profiles and optionally collect their public posts
Douyin Trend Scraper	Export current hot/rising topics or keyword interest over time

Legal and responsible use

This Actor extracts publicly available data. You are responsible for your lawful basis, retention, profiling, and other downstream processing. Review Douyin's User Service Agreement, Privacy Policy, and all laws that apply to your use case, including personal-data and platform-access rules.

Support

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