Pricing

Rating

Developer

Actor stats

Categories

Share

Douyin Comments Scraper (抖音) | Comments, Replies, Author Profiles & Engagement (2026)

Scrape every top-level comment (评论) on any Douyin (抖音) video: author profile, like count, region, author-liked flags, and the full reply tree (回复) nested under each row. One row per comment, clean structured JSON, billed per result.

👁 Douyin (抖音) comments scraper: nested comment threads as structured JSON with author profiles, regions, and like counts

Copy to your AI assistant

zen-studio/douyin-comments-scraper on Apify. Scrapes Douyin video comments and (optionally) nested replies. One row per top-level comment with 14 top-level fields + 4-field user object + replies[] array of the same shape. Call ApifyClient("TOKEN").actor("zen-studio/douyin-comments-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items. Required: awemeUrls (string[]: full douyin.com/video/<id> URLs, iesdouyin.com share URLs, or bare numeric aweme IDs; short v.douyin.com share links not supported). Optional: maxCommentsPerAweme (int 1–5000, default 100), includeReplies (bool, default false), maxRepliesPerComment (int 1–2000, default 100). Pricing: $5.99 per 1,000 items; each comment AND each reply counts as one item (replies are nested in parent rows). Full spec: GET https://api.apify.com/v2/acts/zen-studio~douyin-comments-scraper/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Token: https://console.apify.com/account/integrations

How to Scrape Douyin Comments (抖音评论)

Basic: one video, top 100 comments

{
"awemeUrls":["https://www.douyin.com/video/7577614489533680959"],
"maxCommentsPerAweme":100
}

Top 500 comments + every reply tree under each one

{
"awemeUrls":["https://www.douyin.com/video/7577614489533680959"],
"maxCommentsPerAweme":500,
"includeReplies":true,
"maxRepliesPerComment":200
}

Batch: many videos at once, comments only

{
"awemeUrls":[
"https://www.douyin.com/video/7577614489533680959",
"https://www.douyin.com/video/7579679818335175483",
"7610711200906065509",
"https://www.iesdouyin.com/share/video/7584089129034761019/"
],
"maxCommentsPerAweme":250
}

Input Parameters

Accepted aweme formats

Short app share links like https://v.douyin.com/iAbc123/ are not supported. Open them in a browser first and paste the full douyin.com/video/<id> URL.

Duplicate aweme IDs (across formats) are deduped automatically, so you never pay twice for the same video's comments.

What Data Can You Extract from Douyin Comments (抖音评论)?

One row per top-level comment. Each row carries 14 top-level fields including the commenter's user object (4 fields nested under user). When includeReplies is on, every reply for that comment is nested under replies[] in the same shape.

Output Example

Every top-level field is shown below. Long avatar URLs and the reply array are trimmed with ….

{
"id":"7578047136747717434",
"text":"猪蹄爆米花，他们这么这么会吃[懵]",
"createTime":1764401595,
"createDate":"2025-11-29",
"likeCount":429409,
"replyCount":8165,
"isAuthorLiked":false,
"isLiked":false,
"region":null,
"user":{
"id":"74136233600",
"secUid":"MS4wLjABAAAAXX8Vg_PQJIvUQivRx6JFGTQrI45qmEi7UZJSgb6dwlk",
"nickname":"aiqi",
"avatarUrl":"https://p11.douyinpic.com/aweme-avatar/tos-cn-i-0813c000-ce_oYItx6w3nEABEAJpA4AaQoIlfGAEeCEoXD39kF~tplv-dy-shrink:64:64.jpeg?from=2956013662"
},
"replies":[
{
"id":"7580014842238174006",
"text":"[泪奔]也不是卤鸭脖卤鸭头",
"createTime":1764859738,
"createDate":"2025-12-04",
"likeCount":2624,
"replyCount":0,
"isAuthorLiked":false,
"isLiked":false,
"region":null,
"user":{
"id":"94540959329",
"secUid":"MS4wLjABAAAA8fN97d6ydIoiGVTCU2_yv8gZWjNAaECgm-21MiXqPsU",
"nickname":"_ 雷小姐",
"avatarUrl":"https://p26.douyinpic.com/aweme-avatar/tos-cn-i-0813c001_740645b1532d4fc88fbcadc6585267cd~tplv-dy-shrink:64:64.jpeg?from=2956013662"
}
},
{
"id":"7606775985363927848",
"text":"更不是干噎酸奶僵尸肉巨大串串[黑脸]",
"createTime":1771090555,
"createDate":"2026-02-14",
"likeCount":748,
"replyCount":0,
"isAuthorLiked":false,
"isLiked":false,
"region":null,
"user":{
"id":"102079005652",
"secUid":"MS4wLjABAAAAlQzbs1EDN7DefE-lGo0SSUSd8oPkfUeq02PqOD38gtU",
"nickname":"Cheese",
"avatarUrl":"https://p26.douyinpic.com/aweme-avatar/tos-cn-i-0813_o0BZ1NvoAM4V0iAAgi2CA3CCifIAaEpge9DA5z~tplv-dy-shrink:64:64.jpeg?from=2956013662"
}
}
],
"awemeId":"7579679818335175483",
"awemeUrl":"https://www.douyin.com/video/7579679818335175483",
"inputUrl":"https://www.douyin.com/video/7579679818335175483"
}

Field reference

Advanced Usage

Tracking the conversation under a viral video

{
"awemeUrls":["https://www.douyin.com/video/7579679818335175483"],
"maxCommentsPerAweme":5000,
"includeReplies":true,
"maxRepliesPerComment":200
}

Pulls every top-level comment Douyin will surface plus the full reply tree under each. Use the isAuthorLiked flag to separate creator-endorsed threads from organic discussion. The 3-rule stop policy ensures you don't pay for runaway pagination once Douyin starts repeating itself.

Sentiment / topic mining across a creator's catalog

{
"awemeUrls":[
"https://www.douyin.com/video/7577614489533680959",
"https://www.douyin.com/video/7579679818335175483",
"https://www.douyin.com/video/7584089129034761019",
"https://www.douyin.com/video/7610711200906065509",
"..."
],
"maxCommentsPerAweme":500
}

Up to 10 videos run in parallel. Each row carries awemeId so you can group by video downstream. Pair with the Profile scraper to enumerate a creator's catalog first.

Audience location: who's commenting from where

{
"awemeUrls":["https://www.douyin.com/video/7577614489533680959"],
"maxCommentsPerAweme":2000
}

Group by region to see which Chinese provinces engage most with a given video. Non-Mainland commenters surface as null; useful in itself as an overseas-engagement signal.

Author engagement signal: what does the creator like back?

{
"awemeUrls":["https://www.douyin.com/video/7577614489533680959"],
"maxCommentsPerAweme":1000,
"includeReplies":false
}

Filter rows where isAuthorLiked === true to see which top-level comments the video's creator endorsed. A reliable proxy for which audience reactions resonate.

Cross-actor pipeline: comments → commenter profiles

{
"awemeUrls":["https://www.douyin.com/video/7577614489533680959"],
"maxCommentsPerAweme":500
}

Take user.secUid from every row and feed it into the Douyin Profile Scraper to enrich each commenter with follower count, bio, total likes received, gender, IP location, and verified status. The secUid is the canonical cross-actor key.

Pricing: Pay Per Event (PPE)

$5.99 per 1,000 items. Each top-level comment counts as one item. Each reply nested under a comment counts as one item too. Failed pages, retries, and unparseable comments are not billed.

Because replies are delivered inside the parent row's replies[] array (not as separate dataset rows), your dataset row count will be lower than your billed item count when replies are on. Set a per-run charge cap on your Apify run to control spend.

Free tier

10 lifetime runs, capped at 2 pages of comments per video, replies disabled, and up to 3 videos per run. No credit card. Plenty for evaluation; combine 3 videos × ~40 comments = a ~120-row sample per run.

FAQ

What is Douyin (抖音)? Douyin is ByteDance's Chinese short-video platform, the domestic counterpart of TikTok: same company and format, separate app and catalogue. Its comment sections are where Chinese audiences react, ask, and debate, which is exactly what this actor collects.

How many fields are returned per comment? 14 top-level fields per row, with user containing 4 fields nested (id, secUid, nickname, avatarUrl). When includeReplies is on, the replies[] array carries replies in the exact same shape.

How many comments can I expect per video? Most videos surface 200–5,000 unique comments before Douyin's backend stops returning new ones, even on videos with comment counts in the hundreds of thousands. The actor uses a 3-rule stop policy: when Douyin starts returning mostly duplicates or repeats the same window, pagination ends early. You're only billed for unique comments delivered to your dataset.

Are pinned comments included? Yes. Pinned comments are returned alongside all other top-level comments. They typically come first in the result order because that's how Douyin surfaces them.

Are likes-on-replies returned? Yes. When includeReplies is on, each reply carries its own likeCount. Replies don't have their own nested replies[] (Douyin's comment threads are 2-level deep: top-level comment + flat reply list), so reply rows have replies: [].

Does the order of comments matter? Comments are returned in the order Douyin surfaces them, typically a mix of recency, like count, and platform signals. The exact algorithm is server-side and not documented; if you need a strict sort, do it client-side after collection using likeCount or createTime.

Can I get the full commenter profile (followers, bio, etc.)? Not from this actor. Each row carries the commenter's user.secUid and user.id; feed secUid into the Douyin Profile Scraper to enrich each commenter with 46 author fields. The suite is designed for exactly this fan-out.

How fresh is the data? Live: every comment and reply is fetched on demand at run time. No caching.

Are the avatar URLs permanent? No. user.avatarUrl is a short-lived signed CDN URL that typically expires within 7–14 days. If you need long-term avatars, copy user.secUid and use the Douyin Profile Scraper, which returns multiple avatar size variants per run, or download the image bytes during your own pipeline.

Do I need a Douyin account or cookies? No. Paste video URLs or aweme IDs and run; no account, cookie export, or QR login is involved.

How do I export the comments? The dataset downloads as JSON, CSV, Excel, XML, or HTML from the run's Storage tab, or via the Apify API. JSON preserves the nested replies[] threads best.

Can I scrape direct messages / private comments? No. Public top-level comments and their replies only: anything publicly visible on the video page.

Is it legal to scrape Douyin comments? The actor collects publicly visible comments only, nothing behind a login. You are responsible for complying with Douyin's terms of service and applicable data protection law (GDPR, CCPA, PIPL); comments carry personal data such as nicknames and province-level region.

What's the maximum maxCommentsPerAweme? 5,000. In practice most videos cap out below this: Douyin returns increasingly duplicate pages once you exhaust the surfaced pool, and the 3-rule stop policy ends pagination automatically when yield drops.

Does the actor work for any Douyin video? Any public video. Private videos, age-gated content, and region-restricted videos may return zero or partial results depending on what Douyin's public comment endpoint exposes.

More Zen Studio scrapers for Chinese platforms

🎬 Short-video & social

• 👁 Image
  Douyin 抖音
  • Douyin Search Scraper
  • Douyin Profile Scraper
  • Douyin Video Scraper
  • Douyin Transcripts Scraper
  • Douyin Creator Rankings Scraper
  • Douyin Live Recorder
  • Douyin Hot Search Scraper
  • Douyin Product Search Scraper
• 👁 Image
  RedNote 小红书
  • RedNote User Profile Scraper
  • RedNote Search Scraper
  • RedNote Comments Scraper
  • RedNote Product Search Scraper
  • RedNote Note Detail Scraper
  • RedNote Product Reviews Scraper
  • RedNote Live Recorder
• 👁 Image
  Xigua 西瓜视频
  • Xigua Video Search Scraper
  • Xigua Video Detail Scraper

🛒 E-commerce

• 👁 Image
  Taobao 淘宝
  • Taobao Search Scraper
  • Taobao Product Detail Scraper
  • Taobao Seller Products Scraper
• 👁 Image
  JD.com 京东
  • JD.com Search Scraper
• 👁 Image
  1688 阿里巴巴
  • 1688 Wholesale Scraper
  • Alibaba Scraper
• 👁 Image
  Goofish 闲鱼
  • Goofish (Xianyu) Search Scraper
  • Goofish (Xianyu) Seller Scraper
  • Goofish (Xianyu) Item Detail Scraper
  • Goofish (Xianyu) Item Comments & Q&A Scraper

🏠 Real estate & autos

• 👁 Image
  Anjuke 安居客
  • Anjuke For-Sale Listings Scraper
  • Anjuke New-Home Scraper
  • Anjuke Rental Listings Scraper
  • Anjuke Listing Detail Scraper
• 👁 Image
  58.com 58同城
  • 58.com Real Estate Scraper
• 👁 Image
  Autohome 汽车之家
  • Autohome (Che168) Used-Car Scraper

Support

• Bugs: Issues tab
• Features: Issues tab

Legal Compliance

Extracts publicly available data from Douyin (抖音). Users must comply with Douyin's terms of service and applicable data protection regulations (GDPR, CCPA, PIPL).

Structured Douyin video comments: full author profile, region, like count, author-liked flags, nested replies. One row per comment, in clean JSON.