# Douyin Search Scraper: Videos, Likes, Authors by Keyword (`themineworks/douyin-search-scraper`) Actor

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.

- **URL**: https://apify.com/themineworks/douyin-search-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Social media, Videos, Automation
- **Features:** Limited permissions
- **Stats:** 4 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.14 / 1,000 videos

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

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

[![300 Douyin videos with likes, saves and author followers in 102 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/douyin-search-scraper-hero.png)](https://console.apify.com/actors/szm7SIxd6m52atejR/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

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](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/szm7SIxd6m52atejR/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Part of The Mine Works Social media and video family:** [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Instagram Followers & Following](https://apify.com/themineworks/instagram-followers-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Reddit Search Scraper](https://apify.com/themineworks/reddit-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

### 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:

```json
{
  "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

```text
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

```json
{
  "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

```json
{
  "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

```json
{
  "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

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

Reviews, explainers and vlogs over 5 minutes.

### Input parameters

| Parameter | Type | Default | What it does |
|---|---|---|---|
| `keywords` | array of strings | required | Words to search, one search each, for example `美食`. Up to 50 per run. |
| `maxResultsPerKeyword` | integer | `50` | Most videos per keyword, 1 to 1,000. |
| `sort` | string | `relevance` | `relevance`, `most_liked` or `newest`. |
| `publishTime` | string | `any` | `any`, `day`, `week` or `half_year`. |
| `duration` | string | `any` | `any`, `under_1m`, `1_to_5m` or `over_5m`. |
| `expandResults` | boolean | `true` | With no sort or filter set, reads the keyword again in other orders to go past Douyin's list end of about 200 videos. |
| `includeAds` | boolean | `false` | Keep sponsored videos (with `isAd: true`). |
| `proxyConfiguration` | object | none | Not 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:

| Field | What it is |
|---|---|
| `videoId` | The key to store and join on |
| `url` | Video page on douyin.com |
| `description` | Caption |
| `createdAt` | Publish time |
| `durationSec` | Length in seconds |
| `likes`, `comments`, `shares`, `collects` | Engagement |
| `authorNickname` | Creator name |
| `authorUniqueId` | Creator's Douyin id |
| `authorSecUid` | Creator id for profile links |
| `authorFollowers` | Followers (824 of 824 test rows) |
| `coverUrl` | Cover picture |
| `keyword`, `rank` | Search 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

```json
{
  "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"
}
```

```json
{ "_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.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `video-scraped` | Once 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-start` | Once 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

| Actor | Price per 1,000 on the Free plan | Other charges | Login or cookies needed | Sort and date filter | Author followers |
|---|---|---|---|---|---|
| **This actor** | $4.49 | $0.003 per run | None needed | Yes, plus length | Yes, no extra charge |
| [Douyin Search Scraper (Zen Studio)](https://apify.com/zen-studio/douyin-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $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,000 | No account or cookies (stated) | Yes, plus length | Yes, when available (stated) |
| [抖音 API: Douyin Video Search, Comments, Profiles (SocialDataX)](https://apify.com/socialdatax/socialdatax-douyin-data-api?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $4.99 per 1,000 dataset items | $0.00005 per run | not stated | Yes, plus length | not stated for search |
| [Douyin Scraper: Search Videos, Creators (vulnv)](https://apify.com/vulnv/douyin-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $4.50 | MP4 download $0.90 per 1,000 | No login or cookies (stated) | Yes, plus length | Yes (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](https://apify.com/themineworks/douyin-video-stats-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) 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"`

#### Is it legal to scrape Douyin?

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**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Followers & Following](https://apify.com/themineworks/instagram-followers-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Search Scraper](https://apify.com/themineworks/reddit-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Twitter / X Scraper](https://apify.com/themineworks/twitter-x-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [YouTube Transcript](https://apify.com/themineworks/youtube-transcript-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Xiaohongshu (RED) Scraper](https://apify.com/themineworks/xiaohongshu-explore-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Telegram Channel Scraper](https://apify.com/themineworks/telegram-channel-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Telegram Channel Finder](https://apify.com/themineworks/telegram-channel-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Pinterest Profile Scraper](https://apify.com/themineworks/pinterest-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### 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.*

# Actor input Schema

## `keywords` (type: `array`):

Words to search on Douyin, one per line, as you would type them in the Douyin search box. Chinese, English, brand names and hashtags all work. Example: 美食, 咖啡, iphone. Up to 50 keywords per run.

## `maxResultsPerKeyword` (type: `integer`):

The most videos to return for each keyword, 1 to 1,000. One search call returns about 17 videos. Douyin usually has a few hundred results for a keyword. Example: 200.

## `sort` (type: `string`):

Douyin's own sort order: most relevant, most liked first, or newest first.

## `publishTime` (type: `string`):

Only videos published in this window. Douyin applies the filter on its side.

## `duration` (type: `string`):

Only videos of this length.

## `expandResults` (type: `boolean`):

Douyin ends one result list at about 180 to 200 videos. On: when you ask for more and no sort or filter is set, the keyword is read again sorted by likes, by date and by length, and only new videos are added, so a keyword can return several hundred. Off: one list only.

## `includeAds` (type: `boolean`):

Off: sponsored videos in the results are skipped and not charged. On: they are returned with isAd true.

## `proxyConfiguration` (type: `object`):

Not needed in normal use: Douyin's search page answers without a proxy. Set one only if your runs report a verification page.

## Actor input object example

```json
{
  "keywords": [
    "美食"
  ],
  "maxResultsPerKeyword": 20,
  "sort": "relevance",
  "publishTime": "any",
  "duration": "any",
  "expandResults": true,
  "includeAds": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "美食"
    ],
    "maxResultsPerKeyword": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/douyin-search-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": ["美食"],
    "maxResultsPerKeyword": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/douyin-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "美食"
  ],
  "maxResultsPerKeyword": 20
}' |
apify call themineworks/douyin-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/douyin-search-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/szm7SIxd6m52atejR/builds/JwgFrlKjJKrJaEcBf/openapi.json
