Douyin Video Scraper: Stats, Top Comments, Related Videos

From The Mine Works, makers of Threads Scraper and B2B Leads Finder, with nearly 139,000 runs across our actors.

Why choose this actor?

• One link gives you up to 11 videos. Each Douyin video page you list returns that video's full stats plus up to 10 related videos, each as its own row. In our proof run 3 links gave 25 rows. A related video delivered twice in one run is never charged twice.
• No login, no cookies, no account. The actor opens public Douyin pages in a real browser the way a logged out visitor does and reads what the page itself loads. You never paste a cookie or scan a QR code.
• Pay only for new videos on repeat runs. Monitor mode skips related videos you already received in an earlier run, while your own videos always come back with fresh likes, shares and saves.

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

{
  "videoUrls": ["https://www.douyin.com/video/7686070171895029839"],
  "maxResults": 11
}

This returns the video with its first 5 comments and its 10 related videos, 11 rows in total. You can give a video as a douyin.com/video link, a douyin.com/note link, any douyin.com link with ?modal_id=, an iesdouyin.com share link, a v.douyin.com short link, the share text you copy from the Douyin app (the link inside is found for you), or a bare 19 digit video id.

Apify's free plan includes $5 of credit every month, which covers about 820 videos at this actor's Free tier price in runs of 100.

Copy to your AI assistant

themineworks/douyin-video-stats-scraper on Apify. Scrapes Douyin (抖音) video stats from video links: likes, comments, shares, saves, caption, hashtags, author, music, the first 5 comments, and up to 10 related videos per page as extra rows. Call ApifyClient("TOKEN").actor("themineworks/douyin-video-stats-scraper").call(run_input={"videoUrls": ["https://www.douyin.com/video/7686070171895029839"], "maxResults": 50}), then client.dataset(run["defaultDatasetId"]).list_items().items. Required: videoUrls (list of Douyin video links or ids). Optional: includeTopComments (true), maxRelatedPerVideo (10, minimum 5), relatedDepth (0, up to 2), maxResults (100), monitorMode (false). Full spec: GET https://api.apify.com/v2/acts/themineworks~douyin-video-stats-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

• 41 fields per video row: likes, comments, shares, saves and recommends, caption, hashtags, Douyin's own content categories, post date, duration, author name, Douyin id and profile link, music title and author, cover image, size, ad and pinned flags.
• The first 5 comments Douyin shows on each of your videos, with text, likes, reply count, date and the commenter's province (IP属地). Douyin shows more comments only to logged in users.
• Up to 10 related videos per page, each a full row with relatedToVideoId and relatedRank, so you can see what Douyin pairs with a video.
• Topic discovery from seed videos: relatedDepth 1 or 2 opens the related videos' own pages too and keeps collecting, up to 10,000 rows.
• Every link format people paste: video, note, modal_id, share and short links, app share text, bare ids. Duplicates are opened once.
• A run summary in the OUTPUT record: status per link, seconds to answer, comments loaded or not, proxy sessions, robots.txt state and charges.

How to use it

Basic: stats for a few videos

{
  "videoUrls": [
    "https://www.douyin.com/video/7686070171895029839",
    "https://www.douyin.com/video/7674167249423691249"
  ],
  "maxRelatedPerVideo": 5,
  "maxResults": 50
}

Each video comes back with its first comments, followed by 5 related videos.

Several links at once, in any format

{
  "videoUrls": [
    "7610711200906065509",
    "https://www.douyin.com/?modal_id=7663066902813564850",
    "https://www.iesdouyin.com/share/video/7661470940387552640/",
    "https://www.douyin.com/note/7686070171895029839"
  ],
  "maxResults": 200
}

Pages open three at a time. A link that repeats a video already in the list is skipped. Short links (v.douyin.com) and the share text copied from the app work the same way: the actor reads where the link points and opens that video.

Track campaign videos every day

Brands and agencies list the videos of a campaign (their own and their creators') and schedule the run daily. Every run returns the current likes, comments, shares and saves for each video, so a spreadsheet of runs shows how each video grew.

{
  "videoUrls": ["https://www.douyin.com/video/7686070171895029839", "https://www.douyin.com/video/7670846749279809777"],
  "maxRelatedPerVideo": 5,
  "maxResults": 20
}

Scheduling tip: Apify Console, this actor, Schedules, add a daily schedule with this input. Send the dataset to Google Sheets with the Apify integration.

Find more videos around a topic from a few seed videos

Douyin keyword search asks a visitor to pass a verification page, which this actor never does. Related videos are the way in: start from a few videos you already know are on topic and follow their related lists.

{
  "videoUrls": ["https://www.douyin.com/video/7686070171895029839"],
  "relatedDepth": 1,
  "maxResults": 300
}

Depth 1 opens the 10 related videos' own pages and collects their related videos too.

Watch a topic for new videos

Run the topic discovery input above on a weekly schedule with "monitorMode": true. Related videos you already received are skipped and not charged, so each run brings only videos new to you.

Input parameters

Parameter	Type	Default	What it does
videoUrls	array of strings	(required)	Douyin video links or ids, one per line. Video, note, ?modal_id=, iesdouyin share and v.douyin.com short links, app share text, or bare ids. Creator profile links are skipped. Up to 1,000.
includeTopComments	boolean	true	Adds the first 5 comments Douyin shows on each of your videos.
maxRelatedPerVideo	integer	10	Related videos delivered per page opened, 5 to 10.
relatedDepth	integer	0	0 opens only your videos; 1 also opens the related videos' pages; 2 goes one step further.
maxResults	integer	100	Stops after this many rows (your videos plus related). 0 means up to 10,000.
monitorMode	boolean	false	Skips related videos delivered to you in an earlier run. Your own videos are always delivered.

What data do you get?

One row per video. Rows for your own videos come first for each page, followed by that page's related videos.

• The video: videoId, url, postType (video or image post), description, hashtags, categories, createdAt, createTime, durationSec, width, height, imageCount, coverUrl, isAd, isPinned, region.
• Engagement: likes, comments, shares, saves, recommends. Douyin does not show play counts on the web, so there is no views field.
• The creator: authorNickname, authorUniqueId (the 抖音号), authorSecUid, authorUrl, authorVerified, and on your own videos authorFollowers and authorTotalLikes.
• The sound: musicTitle, musicAuthor, musicId, musicIsOriginal.
• First comments (your videos only): topComments (each with commentId, text, likes, replies, createdAt, ipLabel, authorNickname, isHot, likedByCreator), topCommentsCount, commentsLoaded.
• Where the row came from: source (input or related), relatedToVideoId, relatedRank, inputUrl, scrapedAt.

Stable fields for automations

These fields were present in every one of the 25 rows of our proof run, for both input and related videos.

Field	What it is
videoId	Douyin item id, the key to join runs on
url	Link to the video on douyin.com
source	input or related
description	Caption with hashtags
hashtags	Hashtags as a list
createdAt	Post time, ISO 8601 UTC
durationSec	Length in seconds
likes	Likes
comments	Total comments
shares	Shares
saves	Saves
authorNickname	Creator display name
authorSecUid	Creator id used in profile links
musicTitle	Sound title
scrapedAt	When the row was read

These names will not change. New fields may be added.

Output examples

Your video, with its first comments (2 of 5 shown, commenter names masked here):

{
  "type": "video",
  "source": "input",
  "videoId": "7686070171895029839",
  "url": "https://www.douyin.com/video/7686070171895029839",
  "postType": "video",
  "description": "青椒酿肉绝对是下饭菜的天花板，香辣多汁，一口一个好吃到停不下来#下饭菜 #青椒酿肉 #家常菜 #普通食材的神仙做法 #晚餐吃什么",
  "hashtags": ["下饭菜", "青椒酿肉", "家常菜", "普通食材的神仙做法", "晚餐吃什么"],
  "categories": ["美食", "美食展示", "普通美食展示"],
  "createdAt": "2026-09-16T09:57:46.000Z",
  "durationSec": 20.3,
  "likes": 22906,
  "comments": 254,
  "shares": 7543,
  "saves": 11352,
  "recommends": 490,
  "authorNickname": "柚子爱美食",
  "authorUniqueId": "87893423309",
  "authorFollowers": 9314,
  "authorTotalLikes": 169987,
  "musicTitle": "@哆啦.创作的原声",
  "width": 1080,
  "height": 1920,
  "isAd": false,
  "region": "CN",
  "topComments": [
    { "commentId": "7688735322109428530", "text": "我吃过广西灌阳当地的美食，里面加了炒米，那叫一个绝，我吃了十几个", "likes": 0, "replies": 0, "createdAt": "2026-09-23T14:19:55.000Z", "ipLabel": "广东", "authorNickname": "用户A", "isHot": true, "likedByCreator": false },
    { "commentId": "7687574051846619954", "text": "走，我孩子把肉掏出来吃怎么办？", "likes": 0, "replies": 0, "createdAt": "2026-09-20T11:13:36.000Z", "ipLabel": "福建", "authorNickname": "用户B", "isHot": true, "likedByCreator": false }
  ],
  "topCommentsCount": 5,
  "commentsLoaded": true,
  "inputUrl": "https://www.douyin.com/note/7686070171895029839",
  "scrapedAt": "2026-10-01T08:58:45.611Z"
}

A related video:

{
  "type": "video",
  "source": "related",
  "videoId": "7659725710961751978",
  "url": "https://www.douyin.com/video/7659725710961751978",
  "description": "百吃不厌的香菜炒牛肉，嫩滑不柴，锅气十足，妥妥的下饭菜#家常小炒牛肉 #香菜炒牛肉 #牛肉小炒做法 #美食 #美食教程",
  "hashtags": ["家常小炒牛肉", "香菜炒牛肉", "牛肉小炒做法", "美食", "美食教程"],
  "createdAt": "2026-07-07T10:07:48.000Z",
  "durationSec": 56.6,
  "likes": 16729,
  "comments": 519,
  "shares": 14039,
  "saves": 29134,
  "authorNickname": "灶前小食记",
  "authorUniqueId": "lingyigeziji90",
  "musicTitle": "@灶前小食记创作的原声",
  "relatedToVideoId": "7674167249423691249",
  "relatedRank": 1,
  "inputUrl": "https://www.douyin.com/video/7674167249423691249",
  "scrapedAt": "2026-10-01T08:58:12.081Z"
}

A video whose comments Douyin did not load for a visitor that time comes back with "commentsLoaded": false and an empty topComments; its stats are complete.

Pricing

Pay per event: you pay for video rows delivered, plus a flat $0.005 per run whatever memory you choose.

Event	When it is charged	Free	Bronze (Starter)	Silver (Scale)	Gold (Business) and above
video-scraped	Each video row delivered, your videos and related videos alike	$0.00599	$0.00529	$0.00469	$0.00399
run-start	Once per run	$0.005	$0.005	$0.005	$0.005

Never charged: a video already delivered earlier in the same run, a page that Douyin did not answer, a link that is not a video, a related video skipped by monitor mode, and the info and summary rows. Platform usage (compute and proxy) is included in the price.

Each video you list returns up to 11 rows (the video and up to 10 related videos). To pay for fewer rows, set maxRelatedPerVideo to 5 or cap the run with maxResults.

FAQ

What is Douyin? Douyin (抖音) is ByteDance's short video app for mainland China, the Chinese counterpart of TikTok with a separate app, creators and audience.

How many results can I get? Up to 11 rows per video link (the video plus up to 10 related videos), up to 10,000 rows per run. With relatedDepth 1 or 2, a handful of seed videos can grow into hundreds of on-topic videos.

How fast is it? A Douyin video page takes 25 to 60 seconds to answer from outside China. Three pages open at once, so a run of 100 links takes roughly half an hour. Our proof run returned 25 rows from 3 links in 171 seconds.

How fresh is the data? Live. Likes, comments, shares and saves are read from Douyin at the moment the page opens.

Can it search Douyin by keyword, list a creator's videos or a hashtag's videos? No. We tested each one as a logged out visitor on 1 Oct 2026: keyword search shows a verification page, and a creator's video list and a hashtag's video list come back empty unless you log in. This actor never logs in and never solves a verification page. To grow a list around a topic, start from a few videos and use relatedDepth. For trending topics and hashtag videos, see our Douyin Trending Scraper.

Why only 5 comments? That is what Douyin shows a visitor who is not logged in. The rest sits behind a login prompt. Sometimes Douyin does not load even those for a visitor; the row then has "commentsLoaded": false and complete stats.

Do I need a Douyin account or cookies? No. There is nothing to log in to, no cookie to paste and no QR code to scan.

Which proxy does it use? Apify's datacenter proxy, included in the price. You do not need to set anything.

What happens with deleted, private or region locked videos? They are not delivered and not charged. The run summary (OUTPUT record) lists each link with its status and the reason Douyin gave.

Can I run it on a schedule and get only new videos? Yes. Add a schedule in Apify Console. With monitorMode on, related videos you received in an earlier run are skipped and not charged; your own videos always come back with fresh numbers.

Which formats can I export? JSON, CSV, Excel, XML, HTML table or RSS from the run's Storage tab or the Apify API.

Can I use it from Claude, ChatGPT or another AI assistant?

• Connector URL: https://mcp.apify.com/?tools=themineworks/douyin-video-stats-scraper.
• Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
• ChatGPT: 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-video-stats-scraper "https://mcp.apify.com/?tools=themineworks/douyin-video-stats-scraper".

Is it legal to scrape Douyin? The actor reads only public video pages that anyone can open without an account, and it checks Douyin's robots.txt before each page. You are responsible for how you use the data, including Douyin's terms and data protection law such as China's PIPL, the GDPR and the CCPA. Commenter names in the comments are personal data; use them only for a lawful purpose.

Integrations

• Google Sheets: send each run's dataset to a sheet with the Apify Google Sheets integration.
• Make, Zapier, n8n: start runs and read results with their Apify modules.
• Webhooks: get a call when a run finishes and fetch the dataset.
• API: run it from Python or JavaScript with the Apify client, as in the block above.
• MCP clients: Claude Desktop, Cursor and other MCP clients can call it through the Apify MCP server.

More from The Mine Works

Social media and video

• Threads Scraper
• Reddit Scraper
• Threads Search Scraper
• Instagram Profile Scraper
• Instagram Followers & Following
• Reddit Search Scraper
• Twitter / X Scraper
• Xiaohongshu (RED) Scraper
• YouTube Transcript
• Telegram Channel Scraper
• Telegram Channel Finder
• Pinterest Profile Scraper

Leads and business directories

• B2B Leads Finder
• Skip Trace Lookup
• Google Maps Email Scraper
• JustDial Scraper

Marketing, SEO and reviews

• Facebook Ad Library Scraper
• Similarweb Scraper
• Google Ads Transparency Scraper
• Google News Scraper

LinkedIn

• LinkedIn Company Scraper
• LinkedIn Post Scraper
• LinkedIn Employees Scraper
• LinkedIn Profile Scraper

Real estate

• Zillow Rentals Scraper
• Zillow Sold Comps Scraper
• Housing.com Scraper
• India Real Estate MCP

Science, health and government data

• CourtListener Scraper
• data.gov.in Scraper
• Socrata Open Data Scraper
• Academic Research MCP

Jobs and hiring

• Foundit Monster India Jobs
• Hirist Jobs Scraper
• India Jobs MCP
• Naukri Jobs Scraper

E-commerce and marketplaces

• Ozon.ru Scraper
• ⭐ Amazon Reviews Scraper
• Amazon Product Scraper
• Carsales.com.au Scraper

Company and business data

• Company Domain Finder
• GST Taxpayer Lookup
• World Bank Trade Scraper
• Company KYB Resolver

Food and local services

• NoBroker Scraper
• Swiggy Restaurant Scraper
• Zomato Scraper

Developer and AI tools

• Website to Markdown Crawler
• GitHub Skill Finder
• GitHub Repo Scraper
• GitHub Trending Scraper

More tools

• Tennis Match & Player Data Scraper
• Google Hotels Prices Scraper
• LandWatch Scraper

Support

Open an issue on the Issues tab for anything that does not work as described. For a new source you would like us to build, email dmineworks@gmail.com.

Douyin video stats, first comments and related videos from any video link, read as a logged out visitor, billed per video delivered.