Douyin Search Scraper: Videos, Likes, Authors by Keyword avatar

Douyin Search Scraper: Videos, Likes, Authors by Keyword

Pricing

from $3.14 / 1,000 videos

Go to Apify Store
Douyin Search Scraper: Videos, Likes, Authors by Keyword

Douyin Search Scraper: Videos, Likes, Authors by Keyword

Search Douyin (抖音) by keyword and get one row per video: caption, hashtags, likes, comments, shares, saves, publish time, length, author name, id and followers, sound, cover and link. Sort by relevance, most liked or newest; filter by date and length. No login.

Pricing

from $3.14 / 1,000 videos

Rating

0.0

(0)

Developer

The Mine Works

The Mine Works

Maintained by Community

Actor stats

0

Bookmarked

4

Total users

2

Monthly active users

8 days ago

Last modified

Features

Limited permissions

Share

300 Douyin videos with likes, saves and author followers in 102 seconds

Returns Douyin (抖音) search results by keyword, one row per video with caption, hashtags, likes, comments, shares, saves, publish time, length, author name, id and follower count, sound, cover and video link. No login, no cookies, no API key. You pay $4.49 per 1,000 videos on the Free plan and $3.14 per 1,000 on the Gold plan, plus a $0.003 start fee per run.

From The Mine Works, with over 335,000 runs across 330+ public actors.

Updated 12 Nov 2026: first release. Keyword search with Douyin's own sort (most relevant, most liked, newest), publish time and video length filters, author follower counts on every row in our tests, and a video found by two keywords charged once. Bookmark this Actor on its Store page so it is one click away next time.

Why choose this actor?

  • Follower counts on the row, at no extra charge. Each video row carries the author's nickname, Douyin id, sec_uid, profile link, bio and follower count. In our test runs authorFollowers was filled on 824 of 824 rows, so you can rank creators for a keyword straight from one export.
  • Douyin's own sort and filters. Most liked, newest, last day, last week, last 6 months, under 1 minute, 1 to 5 minutes, over 5 minutes. Douyin applies them on its side, so a "newest, last week" search returns the newest videos of that week, not a sorted sample of old ones.
  • Several hundred videos per keyword. Douyin ends one result list at about 180 to 200 videos. When you ask for more, the actor reads the keyword again sorted by likes, by date and by length and adds only new videos: 291 unique videos for 新能源汽车 in our test, against 183 from one list.

Run it on Apify

Part of The Mine Works Social media and video family: Threads Scraper, Reddit Scraper, Threads Search Scraper, Instagram Profile Scraper, Instagram Followers & Following, Reddit Search Scraper.

Try it in one minute

Paste this into the input (JSON view) and press Start. It returns the first 20 videos for 美食 (food). It took 31 seconds in our test run:

{
"keywords": ["美食"],
"maxResultsPerKeyword": 20
}

Put several keywords on separate lines to search them in one run. A video that two of your keywords find is delivered and charged once.

Apify's free plan includes $5 of credit every month, which covers about 1,100 videos at this actor's price.

Copy to your AI assistant

themineworks/douyin-search-scraper on Apify. Searches Douyin (抖音, the Chinese TikTok) by keyword and returns one flat row per video with no login. Call ApifyClient("TOKEN").actor("themineworks/douyin-search-scraper").call(run_input={"keywords": ["美食"], "maxResultsPerKeyword": 100}), then client.dataset(run["defaultDatasetId"]).list_items().items. Required: keywords (list of strings, up to 50). Optional: maxResultsPerKeyword (default 50, 1 to 1000), sort (relevance, most_liked, newest), publishTime (any, day, week, half_year), duration (any, under_1m, 1_to_5m, over_5m), expandResults (default true; with no sort or filter set, reads the keyword again in other orders to go past Douyin's list end of about 200), includeAds (default false), proxyConfiguration (not needed). Video rows have no _type field and carry videoId, url, shareUrl, postType, title, description, hashtags, createdAt, createTime, durationSec, likes, comments, shares, collects, playCount (usually empty: Douyin hides views in search), authorNickname, authorId, authorUniqueId, authorSecUid, authorUrl, authorFollowers, authorVerified, authorSignature, authorAvatarUrl, musicTitle, musicAuthor, musicId, musicIsOriginal, coverUrl, width, height, imageCount, videoTags, location, province, city, isAd, keyword, rank, sort, publishTime, duration, scrapedAt. Each run also writes one row with _type "summary", one with _type "info" when videos were delivered, and a row with _type "error" for each keyword Douyin did not return; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~douyin-search-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme. Token: https://console.apify.com/account/integrations?fpr=ymnoit&utm_source=apify-readme&utm_medium=referral

Key features

  • Any keyword Douyin's search box takes. Chinese words and phrases, English words, brand and product names, a creator's name, hashtags without the # sign.
  • Engagement in number columns. likes, comments, shares and collects (saves) are plain integers, ready to sort and sum. createdAt is ISO 8601 and createTime a Unix timestamp.
  • Creator columns. authorNickname, authorUniqueId (the 抖音号), authorId, authorSecUid, authorUrl, authorFollowers, authorVerified, authorSignature and avatar.
  • Content columns. Full caption, short title when the creator set one, hashtags as a list, Douyin's own content tags (videoTags, for example 美食, 吃播), sound title and author, length in seconds, width and height, cover image, tagged place with province and city.
  • Sponsored videos skipped by default. Ads in the results are dropped and not charged; turn on includeAds to keep them with isAd: true.
  • Stops cleanly. Two calls in a row with no new video end a keyword. A verification answer, a login answer or a failed call opens a fresh browser session once; two failed page opens or four failed calls in a row end the run. The run stops before its time limit and keeps every row. The summary row says why.

How to use it

Basic: one keyword, 200 videos

{
"keywords": ["咖啡"],
"maxResultsPerKeyword": 200
}

Sort the rows by likes or authorFollowers to see what works in the niche and who makes it.

Most liked videos for several brands

{
"keywords": ["iphone", "华为", "小米"],
"maxResultsPerKeyword": 100,
"sort": "most_liked"
}

Each keyword is its own search, labelled in keyword, with its own rank from 1. In our test, 3 keywords and 300 videos took 102 seconds.

Newest short clips of the week

{
"keywords": ["露营"],
"maxResultsPerKeyword": 150,
"sort": "newest",
"publishTime": "week",
"duration": "under_1m"
}

Good for daily trend and brand monitoring on a schedule. Narrow filters return fewer videos: Douyin decides how many match.

Long form only

{
"keywords": ["新能源汽车"],
"maxResultsPerKeyword": 100,
"duration": "over_5m"
}

Reviews, explainers and vlogs over 5 minutes.

Input parameters

ParameterTypeDefaultWhat it does
keywordsarray of stringsrequiredWords to search, one search each, for example 美食. Up to 50 per run.
maxResultsPerKeywordinteger50Most videos per keyword, 1 to 1,000.
sortstringrelevancerelevance, most_liked or newest.
publishTimestringanyany, day, week or half_year.
durationstringanyany, under_1m, 1_to_5m or over_5m.
expandResultsbooleantrueWith no sort or filter set, reads the keyword again in other orders to go past Douyin's list end of about 200 videos.
includeAdsbooleanfalseKeep sponsored videos (with isAd: true).
proxyConfigurationobjectnoneNot needed. Set one only if your runs report a verification page.

What data do you get?

One row per video. Every row has the same fields; a field Douyin did not show is left out of that row rather than filled with a guess.

Video: videoId, url, shareUrl, postType, title, description, hashtags, createdAt, createTime, durationSec, width, height, coverUrl, videoTags, location, province, city, isAd.

Engagement: likes, comments, shares, collects, playCount.

Author: authorNickname, authorId, authorUniqueId, authorSecUid, authorUrl, authorFollowers, authorVerified, authorSignature, authorAvatarUrl.

Sound: musicTitle, musicAuthor, musicId, musicIsOriginal.

Search: keyword, rank, sort, publishTime, duration (the list the video came from), scrapedAt.

Summary row (_type: "summary", never charged): keywords_requested, keywords_read, keywords_failed, search_calls, videos_found, videos_delivered, charged_for, duplicates_skipped, ads_skipped, browser_sessions, megabytes_total, ended_on_deadline, stopped_by_max_cost, stopped_by_block_guard, shortfall_reason when fewer videos came back than asked, and per_keyword, one entry per keyword with calls, videos_found, videos_delivered and why it stopped. The same summary is saved as the OUTPUT record of the run.

Error rows (_type: "error", never charged): one per keyword Douyin did not return, with error_type, identifier and reason.

Stable fields for automations

These were present in every video row of our test runs (824 rows from 8 keywords), and their names will not change:

FieldWhat it is
videoIdThe key to store and join on
urlVideo page on douyin.com
descriptionCaption
createdAtPublish time
durationSecLength in seconds
likes, comments, shares, collectsEngagement
authorNicknameCreator name
authorUniqueIdCreator's Douyin id
authorSecUidCreator id for profile links
authorFollowersFollowers (824 of 824 test rows)
coverUrlCover picture
keyword, rankSearch and position

Optional, present only when Douyin shows a value: hashtags (806 of 824), videoTags (814), title (480), location with province and city (79), authorVerified (52). playCount is almost always empty: Douyin does not show view counts in its search results.

Output example

{
"videoId": "7510430154377334075",
"url": "https://www.douyin.com/video/7510430154377334075",
"postType": "video",
"title": "咖啡不再傻傻分不清",
"description": "咖啡不再傻傻分不清 #咖啡#中国成都国际非遗节 #百young非遗计划",
"hashtags": ["咖啡", "中国成都国际非遗节", "百young非遗计划"],
"createdAt": "2025-05-31T02:24:50.000Z",
"createTime": 1748658290,
"durationSec": 36.6,
"likes": 2153232,
"comments": 42438,
"shares": 961306,
"collects": 448093,
"authorNickname": "名做茶友会",
"authorId": "2340191371013143",
"authorUniqueId": "moyedecha",
"authorSecUid": "MS4wLjABAAAA7ykAFL0tIPNFsSI-K32TH6nm64EAochAGDbB86EBW-AdIsD7lvMVD17TQumf5gbL",
"authorUrl": "https://www.douyin.com/user/MS4wLjABAAAA7ykAFL0tIPNFsSI-K32TH6nm64EAochAGDbB86EBW-AdIsD7lvMVD17TQumf5gbL",
"authorFollowers": 2224164,
"musicTitle": "@名做茶友会创作的原声",
"musicIsOriginal": true,
"coverUrl": "https://p26-sign.douyinpic.com/tos-cn-p-0015c000-ce/...",
"width": 1080,
"height": 1920,
"videoTags": ["美食", "美食教程", "饮品教程"],
"isAd": false,
"keyword": "咖啡",
"rank": 1,
"sort": "most_liked",
"publishTime": "any",
"duration": "any",
"scrapedAt": "2026-11-11T19:14:02.513Z"
}
{ "_type": "error", "error_type": "blocked", "identifier": "美食", "reason": "Douyin's search page did not open twice in a row (load_failed: page.goto: Timeout 75000ms exceeded.)." }

Pricing

Pay per event: you pay for the videos you receive, plus a flat $0.003 per run, whatever memory you choose. Sort and filters cost nothing extra.

EventWhen it is chargedFree planBronze (Starter)Silver (Scale)Gold (Business)
video-scrapedOnce per video row stored in your dataset$4.49 per 1,000$4.19 per 1,000$3.74 per 1,000$3.14 per 1,000
run-startOnce per run, after the first search call returned videos$0.003$0.003$0.003$0.003

The price of one video is the price per 1,000 divided by 1,000. There is no charge per keyword.

Never charged:

  • a video that a second keyword of the same run finds again;
  • sponsored videos, unless you turn on includeAds;
  • videos past your maxResultsPerKeyword;
  • the summary, info and error rows;
  • a run with no keywords, or one whose searches return no videos: the start fee is charged only once a search has returned videos;
  • anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit, so the run ends SUCCEEDED with a partial result and a status message saying so.

How it compares

ActorPrice per 1,000 on the Free planOther chargesLogin or cookies neededSort and date filterAuthor followers
This actor$4.49$0.003 per runNone neededYes, plus lengthYes, no extra charge
Douyin Search Scraper (Zen Studio)$4.99; Free plan: 2 preview runs of 10 results (stated)$0.02 per keyword from 13 Nov 2026; MP4 download $0.99 per 1,000No account or cookies (stated)Yes, plus lengthYes, when available (stated)
抖音 API: Douyin Video Search, Comments, Profiles (SocialDataX)$4.99 per 1,000 dataset items$0.00005 per runnot statedYes, plus lengthnot stated for search
Douyin Scraper: Search Videos, Creators (vulnv)$4.50MP4 download $0.90 per 1,000No login or cookies (stated)Yes, plus lengthYes (stated)

Checked 11 Nov 2026 from the public Store listings.

Run it on a schedule

  1. Open the actor in Apify Console, set your input (for example sort: newest, publishTime: day) and click Save as a new task.
  2. In the task, open Schedules, click Add schedule and pick how often (every morning, every Monday at 08:00 and so on).
  3. Compare runs on videoId to see new videos for your keywords, and on likes to see which ones grow.
  4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

FAQ

What does this actor read?

Douyin's own public search, the results a logged out visitor sees on Douyin's mobile search site, read in a real browser. It does not log in, follow, like, comment or read anything private.

How many videos can I get per keyword?

Up to 1,000. Douyin ends one result list at about 180 to 200 videos. With no sort or filter set and expandResults on, the actor reads the keyword again sorted by likes, by date and in three length buckets and keeps only new videos; in our test that took 新能源汽车 from 183 to 291 unique videos. Narrow filters (one day, one week) can return far fewer, sometimes under 10: that is how many Douyin matches.

Why is playCount empty?

Douyin does not show view counts in search results; every search answer carries 0 for them. The field is filled only if Douyin ever shows a real number. Likes, comments, shares and saves are always there.

Why are some fields missing on a row?

title exists only when the creator set a short title, location only when a place is tagged, authorVerified only for verified accounts. Fields Douyin did not show are left out of the row rather than set to 0.

Are image posts included?

The actor reads Douyin's video results. In our tests every row was a video; if Douyin returns a picture post, it comes with postType: "image_post" and imageCount.

How long does a run take?

In our tests: 31 seconds for the "Try it" input (20 videos), 102 seconds for 300 videos across 3 keywords, 137 seconds for 291 videos of one keyword with expandResults, and 14 seconds for a filtered search. The default time limit is 3,600 seconds; the actor stops before it and keeps every row.

Do I need an account, cookies or an API key?

No account, no cookies and no API key. No proxy is needed either: the actor reads Douyin's search directly. Nothing to set up.

Can I download the videos?

Not in this actor. Each row has the video page link (url), the share link and the cover. For one video's stats, first comments and related videos, use Douyin Scraper: Video Stats with the url from this actor.

Which formats can I download?

JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API. The dataset has two ready views: Videos and Authors. In CSV and Excel, hashtags and videoTags are flattened into columns such as hashtags/0.

Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/douyin-search-scraper

  • Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
  • ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
  • Cursor or VS Code: add it as an HTTP MCP server with that URL.
  • Claude Code: claude mcp add -t http douyin-search-scraper "https://mcp.apify.com/?tools=themineworks/douyin-search-scraper"

The actor reads only public search results that anyone can see without logging in. Captions, nicknames and bios can be personal data under China's PIPL, the GDPR and similar laws: use them for a legitimate purpose such as market or trend research, and honor deletion requests. You are responsible for how you use the data, including Douyin's terms. This is general information, not legal advice.

Integrations

  • Google Sheets: send each run's videos to a sheet with Apify's Google Sheets integration; one row per video fits a sheet as is.
  • Make, Zapier and n8n: start a run and read its dataset with the Apify apps and nodes, for example "new Douyin videos for our brand every morning to Slack".
  • Webhooks: have Apify call your URL when a run succeeds, then fetch the dataset.
  • API and SDKs: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
  • MCP clients: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

If this actor saved you time, a short rating on the Store helps other buyers find it.

More from The Mine Works

Social media and video

Leads and business directories

Marketing, SEO and reviews

LinkedIn

Real estate

Science, health and government data

Jobs and hiring

Company and business data

E-commerce and marketplaces

Food and local services

Developer and AI tools

More tools

Support

Found a keyword that returns fewer videos than Douyin shows, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new source, email dmineworks@gmail.com.

Search Douyin by keyword and get every video back as one row, with likes, comments, shares, saves, caption, hashtags, publish time and the author's follower count, no login.