Douyin Search Scraper
Pricing
from $1.60 / 1,000 results
Douyin Search Scraper
Search Douyin by keyword across six formats: hashtags, sounds, image posts, experience posts, schools, and keyword suggestions. Each mode returns its own fields -- view and creator counts, sound titles, post captions and stats, school names, or suggested terms. One actor, six Douyin search types.
Pricing
from $1.60 / 1,000 results
Rating
0.0
(0)
Developer
ToolzerHub
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
2 days ago
Last modified
Categories
Share
Search Douyin by keyword across seven formats in one Actor — hashtags, sounds, image posts, experience posts, schools, and two flavors of live keyword suggestion. Pick a mode with scraperType; each mode returns its own fields.
Modes
scraperType | Returns | Extra filters |
|---|---|---|
searchHashtags (default) | Hashtags matching the keyword — name, view count, creator count | sort, recency, length, content type |
searchMusic | Sounds matching the keyword — title, artist, duration, creator count, play URL | sort, recency, length, content type |
searchImages | Image posts matching the keyword — caption, author, stats, share link | none |
searchExperiences | Experience posts matching the keyword — caption, author, stats, share link | sort, recency, length, content type |
searchSchools | School names matching the keyword | none |
searchSuggestions | Live search suggestions for a partial term | none |
searchHashtagSuggestions | Hashtag-specific suggestions — name, ID, view count | none |
Input
| Field | Use it for |
|---|---|
keyword | Search term. Required for every mode. |
sort_type | 0 Most relevant (default), 1 Most liked, 2 Most recent. Applies to searchHashtags, searchMusic, searchExperiences only. |
publish_time | 0 Any time (default), 1 Past day, 7 Past week, 180 Past six months. Same three modes. |
filter_duration | 0 Any length (default), 0-1, 1-5, 5-10000. Same three modes. |
content_type | 0 Any (default), 1 Video, 2 Image and text, 3 Article. Same three modes. |
maxItems | Caps the run. Default 100. Set 0 for no limit. |
{"scraperType": "searchMusic","keyword": "猫咪","maxItems": 50}
Output
Which columns are populated depends on scraperType — one table covers seven result shapes, not fields going missing.
| Field | Populated on |
|---|---|
cha_name, view_count, user_count | searchHashtags, searchHashtagSuggestions |
id_str, title, author, duration, play_url | searchMusic |
aweme_id, desc, create_time, statistics, share_url | searchImages, searchExperiences |
name | searchSchools |
content | searchSuggestions |
source_keyword | Every mode — the term this row was collected for |
{"cha_name": "猫咪","view_count": 545471418072,"user_count": 40052285,"source_keyword": "猫咪"}
That row is searchHashtags. On searchMusic the same keyword returns rows like { "title": "猫咪", "author": "鸟神星", "duration": 180, "user_count": 2 } instead — a different entity, a different subset of the table above.
Questions
Why does content_type only work for three of the seven modes?
searchHashtags, searchMusic, and searchExperiences accept Douyin's sort, recency, length, and content-type filters. searchImages, searchSchools, searchSuggestions, and searchHashtagSuggestions do not take them at all — the fields are simply not sent on those modes.
Why does searchImages, searchSchools, or searchSuggestions stop well short of maxItems?
Those endpoints answer with a single batch and no cursor or has_more flag, so there is nothing to page into. Raising maxItems will not pull more rows out of a mode that only ever returns one page.
Do I need to handle pagination for the other modes myself?
No. searchHashtags, searchMusic, and searchExperiences page on Douyin's own continuation token; the Actor reads it off the previous response and resends it automatically.
Related Actors
| Actor | Purpose |
|---|---|
| Douyin Video Search Scraper | Search for videos, not the entities around them |
| Douyin User Search Scraper | Search for accounts |
| Douyin Hashtag Scraper | Have a hashtag_id from searchHashtags? Get its full stats and every video under it |
| Douyin Sound Scraper | Have a music_id from searchMusic? Get the sound's full detail and every video using it |
Support
Questions, bugs, or feature requests: contact@toolzerhub.com
Browse the rest: apify.com/toolzerhub