# Douyin 抖音 Search Scraper & Video Downloader — 1080p MP4 & Shop (`axon-studio/douyin-scraper`) Actor

\[100% No Cookie / No Login — $4.5/1k] All-in-one Douyin (抖音 / Chinese TikTok) API. Extract keyword videos, 1080p no-watermark MP4 & MP3 links, AI transcripts, comments with English IP provinces, KOL profiles, Douyin Shop products & Top 50 hot search. Ready for n8n & Claude MCP.

- **URL**: https://apify.com/axon-studio/douyin-scraper.md
- **Developed by:** [Axon Studio](https://apify.com/axon-studio) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.70 / 1,000 item scrapeds

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

Scrape **Douyin (抖音 / Chinese TikTok, `douyin.com`)** and **download 1080p unwatermarked MP4 videos** with **100% no personal cookies or login required**. Extract viral short videos (`search_videos`, `video_details`), **direct 1080p no-watermark MP4 streams & Key-Value Store video downloads** (`videoUrlNoWatermark`, `downloadedVideoUrl`), **MP3 audio & AI subtitle transcripts** (`musicUrl`, `transcriptText`), **Douyin Shop e-commerce products & sales volume** (`search_products`), **video comments with IP province geolocation** (`video_comments`), **KOL / influencer profiles & timelines** (`user_profile`, `user_videos`, `search_users`), and **Real-Time Hot Search Top 50** (`hot_search`).

Built for **global brands, cross-border e-commerce sellers, KOL marketing agencies, multimodal AI/LLM pipelines, Claude MCP workflows, and n8n automations** with automatic English-to-Chinese brand localization (`autoLocalize`) and universal `v.douyin.com` short-link resolution. **Free plan preview: up to 15 results per run (5 lifetime preview runs)**; upgrade to any paid Apify plan to unlock up to **5,000 results per run**.

[![Try Free in Apify Console](https://img.shields.io/badge/▶_Try_Free_in_Apify_Console-00C853?style=for-the-badge\&logo=apify\&logoColor=white)](https://console.apify.com/actors/axon-studio~douyin-scraper/input)
[![1080p MP4 Video Downloader](https://img.shields.io/badge/📥_1080p_No--Watermark_MP4_Downloader-FF0050?style=for-the-badge\&logo=tiktok\&logoColor=white)](https://console.apify.com/actors/axon-studio~douyin-scraper/input)
[![API & MCP Ready](https://img.shields.io/badge/⚡_Ready_for_n8n,_Make_&_Claude_MCP-2962FF?style=for-the-badge\&logo=fastapi\&logoColor=white)](https://apify.com/axon-studio/douyin-scraper/api)

| Need | Actor |
| :--- | :--- |
| **Douyin Search Scraper & 1080p MP4 Video Downloader (抖音搜索与无水印下载)** | **[axon-studio/douyin-scraper](https://apify.com/axon-studio/douyin-scraper)** *(Current)* |
| **Video Frame, Thumbnail & Scene Cut Extractor (视频抽帧与AI分镜截图工具)** | **[axon-studio/video-frame-extractor](https://apify.com/axon-studio/video-frame-extractor)** |
| **Taobao & Tmall Real-Time Sales & Stock Search (淘宝天猫销量与实时库存搜索)** | **[axon-studio/taobao-tmall-scraper](https://apify.com/axon-studio/taobao-tmall-scraper)** |
| **Taobao & Tmall Detail, Search, Shop & Reviews (淘宝详情/店铺/评价四合一)** | **[axon-studio/taobao-detail-scraper](https://apify.com/axon-studio/taobao-detail-scraper)** |
| **Weidian Products, SKUs, Stock, Shops & Agent Links (微店商品与尺码库存)** | **[axon-studio/weidian-scraper](https://apify.com/axon-studio/weidian-scraper)** |
| **WeChat Official Account Articles & Markdown (微信公众号文章深搜)** | **[axon-studio/wechat-official-account-scraper](https://apify.com/axon-studio/wechat-official-account-scraper)** |
| **Goofish / Xianyu Second-Hand Deals & Arbitrage (闲鱼二手商品与卖家)** | **[axon-studio/goofish-xianyu-scraper](https://apify.com/axon-studio/goofish-xianyu-scraper)** |
| **Sina Weibo Search, Posts & Hot Trends (新浪微博全能数据抓取)** | **[axon-studio/weibo-scraper](https://apify.com/axon-studio/weibo-scraper)** |
| **Bilibili Videos, Danmaku & Comments Suite (哔哩哔哩 B站全能母舰)** | **[axon-studio/bilibili-scraper](https://apify.com/axon-studio/bilibili-scraper)** |

#### Copy to your AI assistant (Claude, ChatGPT, Cursor & Windsurf)

```text
Help me use axon-studio/douyin-scraper on Apify to search Douyin (抖音) videos, download 1080p unwatermarked MP4 streams, extract AI transcripts, Douyin Shop products, comments with IP geolocation, or KOL profiles. Read https://apify.com/axon-studio/douyin-scraper.md for complete documentation, input schema, output fields, and pricing. Configure the optimal input JSON for my use case.
```

***

### What Can This Douyin Scraper & Video Downloader Do? (Features)

| Feature / Mode | What It Extracts & Built-in Advantages |
| :--- | :--- |
| **1. Search Videos + MP4 Downloader (`search_videos`)** | Search Douyin short videos by English, Pinyin, or Chinese keywords with sort order (`0` Relevance, `1` Most Liked, `2` Newest), publish time window (`0` Any, `1` 24h, `7` 7d, `180` 6m), and optional **Key-Value Store MP4 file download (`downloadVideos: true`)**. |
| **2. Video Details, 1080p MP4 & AI Subtitles (`video_details`)** | Extract 1080p no-watermark MP4 (`videoUrlNoWatermark`), permanent Key-Value Store MP4 link (`downloadedVideoUrl`), MP3 audio (`musicUrl`), AI subtitle transcript (`transcriptText`), and **`collectToLikeRatio`**. |
| **3. Douyin Shop Product Search (`search_products`)** | Extract Douyin Shop (抖音商城) e-commerce items including `productId`, `title`, `price` (CNY ¥), **`priceUsd`** (USD $), `originalPrice`, **`salesCount`**, `commissionRate`, `shopName`, and `productUrl`. |
| **4. Video Comments & IP Geolocation (`video_comments`)** | Extract top comments, inline nested replies (`topReplies`), author-liked flags (`isAuthorLiked`), comment photos (`commentImages`), and standardized English IP province (`regionEn`, e.g., `"Guangdong"`, `"Shanghai"`). |
| **5. Creator / KOL Profile Vetting (`user_profile`)** | Audit any Douyin influencer's `authorUniqueId` (抖音号), `authorSecUid`, **`followersCount`**, `followingCount`, **`totalFavorited`** (获赞总数), `videosCount`, `officialVerify` badge, and bio. |
| **6. Creator Uploaded Videos (`user_videos`)** | Extract the historical timeline of uploaded videos, engagement metrics, and 1080p unwatermarked MP4 links from any creator or brand account. |
| **7. KOL / Influencer Search (`search_users`)** | Discover vertical Douyin creators and influencers by niche keyword (e.g., `"Xiaomi SU7"`, `"skincare"`, `"OOTD"`) with follower and total favorited metrics. |
| **8. Real-Time Hot Search Top 50 (`hot_search`)** | 100% cookie-free extraction of Douyin's real-time Hot Search Top 50 billboard (`word_list`) and rising trends (`trending_list`) with `rank`, `hotValue`, `label`, and `videoCount`. |

***

### How to Scrape Douyin & Download Videos in 3 Easy Steps

1. **Add Keywords or Select a Mode**: Open the **Input** tab, enter English or Chinese keywords in `searchQuery` (e.g., `["Xiaomi SU7", "Shanghai travel"]`), or select one of the 8 workflows.
2. **Optional MP4 Download & Filters**: Enable **`downloadVideos: true`** if you want MP4 video files saved directly to your Apify Key-Value Store, or filter by `sortBy` and `publishTime`.
3. **Click Start & Export**: Export your dataset in **JSON, CSV, Excel, or Parquet**, or connect directly to n8n, Make, Python/JS SDKs, and Claude MCP.

***

### Input

| Input Field | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| **`mode`** | `string` | `"search_videos"` | `"search_videos"`, `"video_details"`, `"search_products"`, `"video_comments"`, `"user_profile"`, `"user_videos"`, `"search_users"`, or `"hot_search"`. |
| **`searchQuery`** | `array` | `["Xiaomi SU7", "Shanghai travel"]` | Keywords in English, Pinyin, or Chinese for video, product, or KOL search. |
| **`maxResults`** | `integer` | `30` | Maximum primary records to collect (`1`–`5,000`; Free plan preview: up to 15 results per run). |
| **`sortBy`** | `string` | `"0"` | `"0"` (Relevance), `"1"` (Most Liked / Highest Sales), or `"2"` (Newest Published / Price). |
| **`publishTime`** | `string` | `"0"` | `"0"` (Any Time), `"1"` (Last 24 Hours), `"7"` (Last 7 Days), or `"180"` (Last 6 Months). |
| **`autoLocalize`** | `boolean` | `true` | Automatically translates English queries into native Chinese Douyin keywords. |
| **`minPrice`** / **`maxPrice`** | `integer` | `0` | Minimum and maximum CNY price filters for `"search_products"`. |
| **`downloadVideos`** | `boolean` | `false` | Saves 1080p MP4 video files to your run's Key-Value Store and returns `downloadedVideoUrl`. |
| **`scrapeComments`** | `boolean` | `false` | Cascade switch: extracts up to `maxCommentsPerVideo` comments per video. |
| **`maxCommentsPerVideo`** | `integer` | `10` | Maximum comments per video (`1`–`200`). |
| **`includeCreatorProfiles`** | `boolean` | `false` | Cascade switch: generates 1 `user_profile` record per unique video creator. |
| **`videoUrls`** / **`userUrls`** | `array` | `[]` | Direct `awemeId`s, `sec_uid`s, web URLs, or `v.douyin.com` mobile share links. |
| **`onlyNewResults`** | `boolean` | `false` | Delta deduplication across scheduled runs. |
| **`proxyConfiguration`** | `object` | `{"useApifyProxy": false}` | Optional proxy configuration. |

#### 1. Mode `search_videos` — Keyword Video Search + Optional MP4 Download (JSON)

```json
{
  "mode": "search_videos",
  "searchQuery": ["Xiaomi SU7", "Shanghai travel"],
  "autoLocalize": true,
  "sortBy": "1",
  "publishTime": "7",
  "downloadVideos": false,
  "maxResults": 30
}
```

#### 2. Mode `video_details` & `video_comments` — Extract 1080p MP4, AI Subtitles & Comments (JSON)

```json
{
  "mode": "video_details",
  "videoUrls": [
    "7398451029384719650",
    "7.56 复制打开抖音，看看【极客评车的作品】https://v.douyin.com/iYxxxx/"
  ],
  "downloadVideos": true,
  "scrapeComments": true,
  "maxCommentsPerVideo": 15,
  "maxResults": 20
}
```

#### 3. Mode `search_products` — Douyin Shop E-Commerce Product Discovery (JSON)

```json
{
  "mode": "search_products",
  "searchQuery": ["Dyson", "sunscreen"],
  "minPrice": 50,
  "maxPrice": 5000,
  "sortBy": "1",
  "maxResults": 30
}
```

***

### Output

```json
{
  "mode": "search_videos",
  "awemeId": "7398451029384719650",
  "title": "小米SU7 Max提车满月真实车主测评！智驾与续航到底怎么样？",
  "text": "小米SU7 Max提车满月真实车主测评！智驾与续航到底怎么样？ #小米SU7 #新能源汽车",
  "hashtags": ["小米SU7", "新能源汽车"],
  "likesCount": 68400,
  "collectsCount": 19200,
  "commentsCount": 5430,
  "sharesCount": 12800,
  "collectToLikeRatio": 0.2807,
  "videoUrlNoWatermark": "https://aweme.snssdk.com/aweme/v1/play/?video_id=v0300fg10000cqkn2efog65j9a1b2c30&ratio=1080p&line=0",
  "downloadedVideoUrl": "https://api.apify.com/v2/key-value-stores/default/records/douyin_7398451029384719650.mp4",
  "coverUrl": "https://p3-pc-sign.douyinpic.com/tos-cn-i-0813/o8A1B2C3D4E5.jpeg",
  "duration": 145,
  "videoTimeFormatted": "02:25",
  "musicTitle": "极客评车创作的原声",
  "musicUrl": "https://sf3-cdn-tos.douyinstatic.com/obj/ies-music/7398451029384719650.mp3",
  "transcriptText": "大家好，今天这台小米SU7 Max我们已经深度开了三千公里...",
  "authorId": "109283746512",
  "authorSecUid": "MS4wLjABAAAA8xYzAbCdEfGhIjKlMnOpQrStUvWxYz1234567890",
  "authorUniqueId": "AutoLab_SH",
  "authorName": "极客评车",
  "followersCount": 845000,
  "regionName": "上海",
  "regionEn": "Shanghai",
  "queryUsed": "小米SU7",
  "createdAtIso": "2026-10-30T11:20:00Z",
  "videoUrl": "https://www.douyin.com/video/7398451029384719650",
  "scrapedAt": "2026-11-17T18:30:00Z"
}
```

#### Data Coverage (Always Populated vs. Conditional)

| Coverage Tier | Fields |
| :--- | :--- |
| **Always Populated (`100%`)** | `mode`, `awemeId` / `productId` / `commentId`, `title`, `text`, `likesCount`, `videoUrl`, `scrapedAt` |
| **Video Mode Fields** | `videoUrlNoWatermark`, `coverUrl`, `duration`, `videoTimeFormatted`, `collectsCount`, `commentsCount`, `sharesCount`, `collectToLikeRatio`, `hashtags`, `authorName`, `authorSecUid`, `regionEn` |
| **Optional / Conditional** | `downloadedVideoUrl` (populated when `downloadVideos: true`), `transcriptText` (when subtitles/captions exist), `topReplies` (on comments with replies) |

***

### Automated Daily Douyin Monitoring (Python, JavaScript & cURL)

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_API_TOKEN")
run = client.actor("axon-studio/douyin-scraper").call(run_input={
    "mode": "search_videos",
    "searchQuery": ["Xiaomi SU7", "Shanghai travel"],
    "autoLocalize": True,
    "sortBy": "1",
    "publishTime": "7",
    "maxResults": 30,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item.get("awemeId"), item.get("title"), item.get("likesCount"), item.get("videoUrlNoWatermark"))
```

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

const client = new ApifyClient({ token: 'YOUR_APIFY_API_TOKEN' });
const run = await client.actor('axon-studio/douyin-scraper').call({
    mode: 'search_videos',
    searchQuery: ['Xiaomi SU7'],
    maxResults: 30,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

```bash
curl -X POST "https://api.apify.com/v2/acts/axon-studio~douyin-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"hot_search","maxResults":50}'
```

***

### How Much Does It Cost to Scrape Douyin? (Pricing)

**From $3.80 / 1,000 results on Gold plans (`$4.50 / 1,000` base rate) + `$0.02` per Actor start**

- **Free Tier Preview**: Free accounts get **5 lifetime preview runs** (up to **15 results per run**) with no credit card required; upgrade to any paid Apify plan to unlock unlimited runs and up to 5,000 results per run.
- **No Extra Compute Fees**: Platform memory and CPU are included in the Pay-Per-Event rate.

***

### FAQ & Legal Compliance

#### Do I need to provide my own Douyin cookies?

**No.** The Actor uses a built-in managed session pool, ByteDance visitor cookies (`ttwid`), and keyless `iesdouyin.com` endpoints automatically.

#### How do I download 1080p Douyin videos without watermarks?

Every video record includes `videoUrlNoWatermark` (`aweme.snssdk.com/aweme/v1/play/?video_id=...&ratio=1080p`), or enable **`downloadVideos: true`** to save `.mp4` files directly into your Apify Key-Value Store (`downloadedVideoUrl`).

#### Is scraping public Douyin data legal?

This Actor extracts only publicly visible videos, shop listings, comments, and hot search rankings. Comply with GDPR, CCPA, and PIPL when processing public creator metadata.

# Actor input Schema

## `mode` (type: `string`):

Select what to extract from Douyin. All inputs (keywords, video links, share text, or creator links) go directly into Box #2 below!

## `searchQuery` (type: `array`):

Universal input box:
• For Video / KOL Search: Enter keywords in English or Chinese (e.g., 'Xiaomi SU7', 'Shanghai travel', '美食')
• For Video Details / Comments: Paste Douyin video URLs (https://www.douyin.com/video/...), 19-digit awemeIds, or v.douyin.com mobile share links
• For Creator Profile / Videos: Paste creator profile URLs (https://www.douyin.com/user/...) or sec_uid

## `maxResults` (type: `integer`):

Maximum number of records to extract (1 to 5,000; Free plan preview: up to 15 results per run, 5 lifetime preview runs).

## `sortBy` (type: `string`):

Sort matching Douyin videos by relevance ('0'), most liked ('1'), or newest published ('2').

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

Filter videos by publication window: any time ('0'), last 24 hours ('1'), last 7 days ('7'), or last 6 months ('180').

## `downloadVideos` (type: `boolean`):

When enabled, downloads the unwatermarked MP4 video file directly into your Apify Key-Value Store and outputs a permanent 'downloadedVideoUrl' link.

## `scrapeComments` (type: `boolean`):

When enabled, automatically extracts up to 'maxCommentsPerVideo' comments (with IP province geolocation) for each scraped video.

## `maxCommentsPerVideo` (type: `integer`):

Maximum comments to extract per video when 'scrapeComments' is enabled.

## `includeCreatorProfiles` (type: `boolean`):

When enabled, emits a dedicated 'user_profile' record (followers, total likes, Douyin ID) for each unique video author.

## `autoLocalize` (type: `boolean`):

Automatically translates English brand or topic queries into native Simplified Chinese Douyin search terms.

## `onlyNewResults` (type: `boolean`):

Remembers previously scraped IDs in persistent storage so scheduled runs only output new Douyin items.

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

Optional proxy settings. Works out-of-the-box without proxies.

## Actor input object example

```json
{
  "mode": "search_videos",
  "searchQuery": [
    "Xiaomi SU7",
    "Shanghai travel"
  ],
  "maxResults": 30,
  "sortBy": "0",
  "publishTime": "0",
  "downloadVideos": false,
  "scrapeComments": false,
  "maxCommentsPerVideo": 10,
  "includeCreatorProfiles": false,
  "autoLocalize": true,
  "onlyNewResults": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `dataset` (type: `string`):

Complete dataset containing all extracted Douyin videos, 1080p unwatermarked MP4 links, Douyin Shop products, comments, KOL profiles, and real-time hot search trends.

## `overview` (type: `string`):

Curated overview table highlighting core Douyin metrics: Mode, Aweme ID, Title, Text, Author Name, Likes, Collects, Comments, Shares, Collect-to-Like Ratio, Price (CNY), Price (USD), Sales Count, Region (EN), No-Watermark MP4 URL, Transcript Text, Followers Count, Created At, Video URL, and Scraped At.

# 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 = {
    "mode": "search_videos",
    "searchQuery": [
        "Xiaomi SU7",
        "Shanghai travel"
    ],
    "maxResults": 30,
    "sortBy": "0",
    "publishTime": "0"
};

// Run the Actor and wait for it to finish
const run = await client.actor("axon-studio/douyin-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 = {
    "mode": "search_videos",
    "searchQuery": [
        "Xiaomi SU7",
        "Shanghai travel",
    ],
    "maxResults": 30,
    "sortBy": "0",
    "publishTime": "0",
}

# Run the Actor and wait for it to finish
run = client.actor("axon-studio/douyin-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 '{
  "mode": "search_videos",
  "searchQuery": [
    "Xiaomi SU7",
    "Shanghai travel"
  ],
  "maxResults": 30,
  "sortBy": "0",
  "publishTime": "0"
}' |
apify call axon-studio/douyin-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,axon-studio/douyin-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/bPNbRO8z5tq3JCzZg/builds/gX928eiiGvMcSSTAg/openapi.json
