Douyin Video & Content Scraper

Scrape Douyin (抖音) content four ways: keyword video search, user profile videos, video comments, and the hot-search trending list (热榜). Returns clean, structured data for each record — description, play / like / comment / share / collect counts, cover and video URLs, music title, author info, and the canonical video URL.

Unofficial. This Actor is not affiliated with, authorized, or endorsed by Douyin or ByteDance (字节跳动). It is an independent tool that retrieves publicly available data via a third-party API. Use it in compliance with Douyin's terms and all applicable laws; you are responsible for how you use the retrieved data.

What it does

• Keyword search — give one or more keywords; the Actor paginates Douyin video search results for each. Sort by comprehensive / most-liked / latest and filter by publish time.
• User profile — give one or more sec_user_id values (the long MS4wLjAB... id from a profile URL or share link) to scrape the videos a creator has posted.
• Video comments — give one or more video IDs (aweme_id) to scrape their comments; one dataset item is pushed per comment.
• Hot-search trending list — enable includeHotSearch to also pull the current Douyin 热榜, one item per trending word.

Input

Field	Type	Default	Description
searchKeywords	string[]	["美食"]	Keywords to search. Each is paginated independently. Chinese keywords return the most results.
userIds	string[]	[]	Douyin sec_user_id values whose posted videos to scrape.
awemeIds	string[]	[]	Douyin video IDs (aweme_id) to scrape comments from.
includeHotSearch	boolean	false	Also scrape the hot-search trending list.
maxItems	integer	50	Max total items across all modes.
sortType	enum	_0	_0 comprehensive / _1 most liked / _2 latest (search only).
publishTime	enum	_0	_0 no limit / _1 last day / _7 last week / _180 last 6 months (search only).
maxCommentsPerVideo	integer	50	Cap on comments fetched per video ID.

Example input

{
  "searchKeywords": ["美食", "穿搭"],
  "userIds": ["MS4wLjABAAAAgYvMaLdCBKJ_4vwmBkxDnv8ZbC8pL1gYRBA7sbgV_E0"],
  "awemeIds": ["7614772719099333894"],
  "includeHotSearch": true,
  "maxItems": 200,
  "sortType": "_1"
}

Output

Video item (from search / user modes):

{
  "id": "7614772719099333894",
  "type": "video",
  "url": "https://www.douyin.com/video/7614772719099333894",
  "shareUrl": "https://www.iesdouyin.com/share/video/...",
  "description": "茄子放入肉馅，这个是最近很火的茄子新吃法 #茄子新吃法",
  "createTime": 1772964000,
  "durationMs": 41402,
  "diggCount": 377385,
  "commentCount": 4280,
  "shareCount": 303968,
  "playCount": 0,
  "collectCount": 0,
  "coverUrl": "https://...",
  "playUrl": "https://...",
  "downloadUrl": "https://...",
  "musicTitle": "@小婷美食记创作的原声",
  "author": {
    "secUid": "MS4wLjABAAAA...",
    "uid": "391894996886567",
    "uniqueId": "...",
    "nickname": "小婷美食记",
    "followerCount": 12345,
    "verified": false
  },
  "source": "search:美食"
}

Comment item (from awemeIds mode) and hot-search item (from includeHotSearch) share the same flat shape with a type of comment / hotSearch respectively.

Notes

• Data is sourced live; Douyin occasionally rate-limits, so the Actor retries transient Cloudflare / upstream blocks with exponential backoff.
• IDs are de-duplicated within a run.
• A bare run (no input) defaults to searching 美食 so it always returns data.

---

Why this Actor

• Direct API, no headless browser — fast, stable runs with nothing to babysit.
• No login, no cookies — we never touch your accounts, so there's no ban risk.
• Fresh, real-time data — every run reads the source live, not a stale cache.
• Pay per result — you're billed only for the rows actually delivered.
• Structured JSON — export to CSV, Excel, or JSON, or pull straight from the API / MCP.

Use cases

• Pull structured content + engagement for analytics dashboards.
• Track a creator's or topic's output and performance over time.
• Build training/research datasets of posts and metadata.
• Power competitor and trend monitoring.

FAQ

Do I need an account, cookies, or to log in anywhere? No. The Actor talks to a fast, direct HTTP API server-side — you just provide inputs and run it.

How am I billed? Pay-per-result: a fixed price per row returned, with no separate platform/compute charge. Caps like maxItems keep spend predictable.

Can I run it on a schedule or call it from my app? Yes — use Apify Schedules, the REST API, the JavaScript / Python clients, or the MCP server. See the API tab.

Is this affiliated with Douyin (抖音)? No. It's an independent tool that collects publicly available data. Use it in line with the platform's terms and applicable law.

How do I get a sec_user_id or aweme_id? A sec_user_id is the long MS4wLjAB... string in a profile share link; an aweme_id is the number in douyin.com/video/<id>.

More Douyin (抖音) scrapers by us

• Douyin Xingtu KOL — Influencer search · fans portrait · Xingtu index

Browse the full fleet → https://apify.com/ethereal_wool