Douyin 抖音 Search Scraper

🚀 What is Douyin Search Scraper?

Douyin Search Scraper is an Apify Actor that searches Douyin (抖音) by keyword, hashtag or search link and saves every matching video or image post as one clean row. Each row holds the text, author, music, likes, comments, shares, hashtags and quality links. You can sort the results and filter them by posting date and video length.

• Many keywords in one run: paste a list of words and get one merged result set. Each video is saved only once, so the Douyin keyword scraper never repeats a video across keywords.
• Hashtags and links too: enter tags such as #美食 or Douyin search links. It works as a Douyin hashtag scraper with the same filters.
• Filters that are checked row by row: sort by relevance, most liked or newest, and limit results to a recent period or a video length.
• Clean structured data: nine ready-made table views and JSON, CSV or Excel export, so the data fits spreadsheets and analysis tools.
• Built for repeat use: schedule the same search every day or week and compare new runs.
• Pay per result: you pay for the videos saved, with the prices shown in the pricing section below.

Teams use it as a Douyin scraper without writing code. Developers get a Douyin scraper API through the Apify platform. Anyone looking for a Chinese TikTok scraper gets Douyin, the Chinese short-video app, as the source. People who search for a TikTok China scraper find the same thing here.

Click Try for free on the Actor page, enter your keywords and press Start.

📊 What data can you extract from Douyin?

As a Douyin data extractor, the Actor returns one row per video or image post. The table lists the main fields; the full list is in the Output tab of the Actor. Examples are illustrative.

Field	Description	Example
id	Video or post ID	7500000000000000001
url	Link to the video or image post on Douyin	https://www.douyin.com/video/7500000000000000001
type	video or slideshow (image post)	video
text	Caption of the video	周末在家做红烧肉 #美食
createDate	Posting date in Beijing time	2026-10-20
authorMeta.name	Name of the creator	小厨房日记
authorMeta.followersCount	Followers of the creator	120000
statistics.diggCount	Likes	15400
statistics.commentCount	Comments	820
statistics.shareCount	Shares	310
statistics.collectCount	Saves	2100
musicMeta.title	Title of the sound used	原声
hashtags	Hashtags used in the post	["美食", "家常菜"]
videoMeta.duration	Video length in milliseconds	45000
videoMeta.playUrl	Link to the video file	https://...
searchKeyword	Keyword that found the video	美食
searchPosition	Position of the video in that search	3

Other fields cover author verification, location, mentions, chapters, permissions and shopping flags. The fields videoFile, coverFile and slideshowFiles exist in the dataset but are always empty, because this Actor does not download media. Links to the media in videoMeta can expire after some time.

💡 Use cases for Douyin data

• Follow rising topics: search a topic sorted by newest and read text, hashtags and statistics to follow Douyin trends. Run it weekly for Douyin trend research and compare the datasets.
• Find viral videos: sort by most liked and limit the period to find Douyin viral videos. List Douyin trending videos in a niche and compare likes, comments and shares side by side.
• Spot popular hashtags: count the values in hashtags across hundreds of results to find popular Douyin hashtags in a niche. Schedule runs to monitor Douyin hashtag use over time.
• Find creators in a niche: a keyword search returns authorMeta with name, followers and verification, which supports Douyin influencer research. Use the author names to find Douyin creators by keyword.
• Track a brand or competitor: search a brand name with the newest sort and a one-day filter to track brand mentions on Douyin. Compare statistics across brands for Douyin competitor research.
• Research a market: compare engagement across keywords for Douyin market research. The same rows support Chinese consumer trend research. Search a product term to see Douyin trending products. Words such as 口红 show Douyin beauty trends.
• Scout music: the musicMeta fields show which sounds are used in top videos, which helps with Douyin trending music. Sort dance results by likes to see Douyin viral songs. Search dance topics to follow Douyin dance trends.
• Feed analysis tools: you can export Douyin data to CSV with one click. Pass the JSON to a model for Douyin data for AI analysis.

🛠️ How to scrape Douyin search results

1. Create an Apify account and open the Douyin Search Scraper Apify page in the Store.
2. Add one or more keywords, hashtags or Douyin search links, one per line.
3. Set Max videos per keyword, then pick Sort by, Posted within and Video length.
4. Click Start and watch the log; it shows progress per keyword.
5. Open the Output tab to browse the tables.
6. Download the data as JSON, CSV, Excel, XML or HTML, or connect it to another app.

💰 How much does it cost to scrape Douyin?

This Douyin scraper tool uses pay-per-event pricing with two events: main_result for every video or image post saved, and apify-actor-start once per run. The price per result depends on your Apify plan.

Apify plan	Price per result	Price per 1,000 results
Free	$0.0045	$4.50
Bronze	$0.0040	$4.00
Silver	$0.0036	$3.60
Gold, Platinum, Diamond	$0.0032	$3.20

The start event costs $0.00005 per GB of memory, with a minimum of one event. The Actor runs with 4096 MB (4 GB), so each run costs 4 x $0.00005 = $0.0002 for the start.

Examples:

• 1,000 results on the Free price tier: 1,000 x $0.0045 = $4.50, plus $0.0002 for the start, so $4.5002.
• 10,000 results on the Gold tier: 10,000 x $0.0032 = $32.00, plus $0.0002 for the start, so $32.0002.

Apify platform usage (compute) is billed on top of the events above. You can set a maximum cost per run in the Apify Console; the run stops cleanly when it is reached and keeps the videos already saved. See the Pricing tab of the Actor for the current prices.

⬇️ Input

You need at least one keyword or one Douyin search link. All other fields have defaults. Open the Input tab for the full form; this is the README version of the same fields.

Field	Description	Default
keywords	Keywords, hashtags (for example #美食), brand names; one per line	["美食", "iphone"] in the form
urls	Douyin search links; the keyword inside each link is searched	empty
maxResultsPerQuery	Videos per keyword, 0 to 2000; 0 collects everything Douyin returns	10
sort	general, most_liked or latest	general
publishTime	unlimited, one_day, one_week or half_year	unlimited
duration	unlimited, under_1m, one_to_five or over_5m	unlimited
maxConcurrency	Keywords searched at the same time, 1 to 10	2
maxRetries	Retries for a failed or blocked request, 0 to 10	3
maxScanned	Safety cap on videos checked per keyword, 0 = no cap	20000
proxyConfiguration	Your own proxy; the Actor switches to a proxy automatically if requests are blocked	none

{
  "keywords": ["美食", "#家常菜"],
  "maxResultsPerQuery": 100,
  "sort": "latest",
  "publishTime": "one_week",
  "duration": "under_1m"
}

💡 Plain words in urls are treated as keywords, and a keyword that appears in both fields is searched once.

How to run a Douyin video search by date

Set publishTime to one_day, one_week or half_year and sort to latest. Videos outside the period are left out, and the log reports how many were skipped.

Douyin search by keyword, most liked first

Set sort to most_liked and raise maxResultsPerQuery. A single keyword can return fewer videos than you ask for, because Douyin only returns a limited number of matching videos.

⬆️ Output

The Actor stores one dataset row per video or image post. Open the Output tab of the run to see nine table views (overview, content, author, engagement, video quality, music, tags, permissions and commerce, search details). The table view does not show every field; download the dataset to get them all. Formats: JSON, CSV, Excel, XML and HTML. As a Douyin search results scraper it keeps searchKeyword and searchPosition on every row. Every row is one video, which makes it a Douyin video data scraper for spreadsheets. The run also stores a SUMMARY record with the keywords, videos saved, videos billed, duplicates removed, videos skipped outside your filters and the duration.

Illustrative example for the input above (shortened, not a real video):

{
  "id": "7500000000000000001",
  "url": "https://www.douyin.com/video/7500000000000000001",
  "type": "video",
  "text": "周末在家做红烧肉 #美食",
  "createDate": "2026-10-20",
  "authorMeta": { "name": "小厨房日记", "followersCount": 120000 },
  "statistics": { "diggCount": 15400, "commentCount": 820, "shareCount": 310, "collectCount": 2100 },
  "musicMeta": { "title": "原声" },
  "hashtags": ["美食", "家常菜"],
  "videoMeta": { "duration": 45000 },
  "searchKeyword": "美食",
  "searchPosition": 3
}

⚠️ Limitations and error handling

• This Douyin search tool reads public search results only. Private or removed videos, and anything behind a login, are not available to this Douyin video scraper.
• Douyin decides how many videos a search returns, so a keyword can yield fewer results than maxResultsPerQuery.
• This Douyin data scraper does not download video files; it returns links. Play counts and some other fields can be empty or zero when Douyin hides them in search results.
• Dataset rows hold only successful videos. There are no error rows; problems are reported in the log and the run status.
• The Actor is not a Douyin crawler that follows links around the site; it reads the search results for your keywords. Memory is set to 4096 MB.

Run status message	Meaning
N videos saved	The run finished and saved N videos
No videos found - try another keyword or looser filters	Nothing matched; loosen the filters or change the keyword
Douyin could not be reached - see the log	Nothing was saved and Douyin did not answer; check your proxy settings and try again
Stopped early - N videos saved	The run stopped unexpectedly; the saved videos are kept
Spend limit reached before the run started - nothing to do	Your maximum cost per run was already used up

⚠️ If a log line says that results may not be in the requested order, run the search again; a different connection usually fixes it.

🔌 Integrating Douyin Search Scraper with other apps

• API: start runs and read datasets through the Apify API. Use the Actor ID data_wiki/douyin-search-scraper. Developers can treat it as a Douyin search API.
• Schedules: run the same search every day or week with Apify schedules and compare datasets over time.
• Webhooks and apps: send finished runs to other tools with Apify integrations, such as Google Sheets, Make, Zapier or n8n. The Apify Douyin scraper also works with webhooks.
• AI agents: the Actor can be found and called through the Apify MCP server at https://mcp.apify.com; see the Apify MCP documentation.

🔗 Other Douyin and short-video scrapers by data_wiki

Actor	What it extracts	When to use it
Douyin profile scraper	Followers, bio, posts and hashtags of Douyin creators	You know the creators already. After a keyword search, look at their creator profiles with followers and posts.
Instagram Hashtag Scraper	Instagram reels by hashtag or keyword	You want the same kind of trend data from Instagram. You can track hashtag trends on Instagram next to your Douyin results.
1688 Wholesale Products Scraper	Wholesale prices, MOQ and suppliers from 1688.com	You found a product on Douyin and want suppliers; see 1688 wholesale product data.
Instagram Comment Scraper	Comments on public Instagram posts and reels	You want to read audience comments on Instagram.
TikTok keyword and hashtag video extractor	Public TikTok videos by keyword, hashtag, profile or link	When you need the international TikTok app instead of Douyin

⚖️ Is it legal to scrape Douyin?

The Actor reads only public data that any visitor can see, without logging in. Public does not mean free of rules: the results can contain personal data such as creator names, so you are responsible for following GDPR, CCPA, copyright and the terms of Douyin. Keep your request volume reasonable. If you are unsure, ask a lawyer; Apify explains the topic in its guide to the legality of web scraping and in its article on ethical web scraping.

❓ FAQ

Is it legal to scrape Douyin?

It is legal in many places to collect public data, but you must respect personal data laws and the site's terms. See the legal section above.

Do I need a Douyin account or API key?

No. You only need an Apify account. The Actor needs no Douyin login and no key.

How much does Douyin Search Scraper cost?

The price is $3.20 to $4.50 per 1,000 videos depending on your Apify plan, plus $0.0002 per run for the start event. Platform usage is billed on top.

How many videos can I get per keyword?

You can ask for up to 2000 per keyword. How many you receive depends on how many matching videos Douyin returns, so run a small test first.

Can I scrape private videos or accounts?

No. Only public search results are read.

Do I need proxies?

No. By default the Actor connects directly and switches to a proxy automatically if requests are blocked. You can also set your own proxy in the input.

Can I use Douyin Search Scraper with the API or an MCP server?

Yes. Start it through the Apify API, or let an AI agent call it through the Apify MCP server at https://mcp.apify.com.

Why did I get fewer results than I asked for?

Your filters may be strict, or Douyin may have returned fewer matches. The log shows how many videos were checked and how many were left out.

💬 Your feedback

Found a bug or missing a field? Open the Issues tab of the Actor and describe your input. Need a custom solution? Contact hello.datawiki@gmail.com.