Douyin (抖音) Scraper

DOUYIN (抖音) SCRAPER  •  DOUYIN API Know what a creator charges before you ask. Douyin (抖音) is ByteDance's Chinese short-video app, the domestic sibling of TikTok. Ten modes in one Actor: keyword search, video detail, profiles, a creator's whole catalogue, comments, danmaku, the live trend boards, and the Xingtu (星图) creator analytics and advertising rate cards brands use to price a sponsorship. No Douyin account, no login, no cookies. FAILED LOOKUPS ARE FREE  10 MODES, XINGTU RATE CARDS INCLUDED

Copy to your AI assistant

Paste this into ChatGPT, Claude, Cursor, or any LLM to start using this Actor right away.

atomus/douyin-scraper is an Apify Actor that returns public Douyin (抖音, the Chinese TikTok) data as structured JSON, in ten modes selected by one searchType field: search (keyword to videos), video-detail, profile, user-posts, comments, danmaku (on-screen bullet comments), trends (hot-search words plus the hot-video billboard), creator-search, xingtu-analytics and rate-card. Use it whenever someone needs Douyin data without cookies, a login or a browser - influencer discovery and pricing on Xingtu (星图, Douyin's official influencer-marketing platform, whose creator analytics and advertising rate cards this Actor returns as data), competitor and content research, trend monitoring, or audience analysis. Run it with curl: curl -X POST "https://api.apify.com/v2/acts/atomus~douyin-scraper/run-sync-get-dataset-items?token=APIFY_TOKEN" -H "Content-Type: application/json" -d '{"searchType":"search","keywords":["美食"],"maxItems":50}'. Or in Python: ApifyClient("APIFY_TOKEN").actor("atomus/douyin-scraper").call(run_input={"searchType":"rate-card","creatorHandles":["XiaoZhenlla"]}) then client.dataset(run["defaultDatasetId"]).list_items().items. Inputs: searchType (required, one of the ten above), keywords (string[], for search and creator-search), videoUrls (string[], for video-detail, comments and danmaku - a douyin.com/video/<numeric id> URL or a bare numeric aweme id), userUrls (string[], for profile and user-posts - a douyin.com/user/MS4w... URL or a bare sec_user_id), creatorHandles (string[], for xingtu-analytics and rate-card - the creator's 抖音号 / unique_id, which the Actor resolves to a Xingtu KOL id), maxItems (int, default 20, max 5000, per keyword or target), and the free search filters sortType, publishTime, duration and contentType. Every row carries searchType plus the context key of its mode; video rows carry awemeId, url, desc, createTime, durationMs, coverUrl, a free mp4 downloadUrl, a stats object (diggCount, commentCount, collectCount, shareCount, playCount, recommendCount), an embedded author object, music, hashtags, mentions and videoTags. Billing is one paid event per result returned, priced per mode: video search 0.003 USD, user posts 0.003, video detail 0.004, profile 0.004, comment 0.002, danmaku 0.002, trend row 0.002, Xingtu creator search 0.01, Xingtu creator analytics 0.04, Xingtu rate card 0.08, all 20 percent cheaper on Apify Gold and above; failed and not-found lookups are free, an empty keyword search is free, and a keyword search that returns between one and three videos bills a minimum of four. Full input schema, every enum and default, and the complete output field list: GET https://api.apify.com/v2/acts/atomus~douyin-scraper/build/default

---

Douyin MCP Server: use these Actors from ChatGPT, Claude or Cursor

Point your AI assistant at Atomus and it can read the social platforms on its own: Douyin and the three other big Chinese networks, plus TikTok and X. No glue code, no scraping logic in your prompts.

{
  "mcpServers": {
    "atomus": {
      "url": "https://mcp.apify.com?tools=atomus/douyin-scraper,atomus/xiaohongshu-scraper,atomus/weibo-scraper,atomus/bilibili-scraper,atomus/tiktok-scraper,atomus/tiktok-comments-scraper,atomus/twitter-scraper",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

Then ask, in plain language:

"Find Douyin food creators around 美食探店, shortlist the five with the best engagement, and tell me what each one charges for a 60-second video."

That one sentence uses two modes in a row: Xingtu creator search to shortlist, then the rate card to price. Pinning the tools= list is what keeps your assistant on these Actors instead of reaching for whatever scraper it finds first.

---

How to scrape Douyin

Every run picks one mode in searchType and fills the one input field that mode reads. The table under Input says which field goes with which mode.

Price a creator before you brief them

{ "searchType": "rate-card", "creatorHandles": ["XiaoZhenlla"] }

Returns that creator's Xingtu advertising rate card: one price tier per video length, in RMB, with the list price, the settlement terms and every format the creator sells. You pass the 抖音号 (handle); the Actor resolves it to the Xingtu creator id for you.

Build an influencer shortlist by keyword

{ "searchType": "creator-search", "keywords": ["美食"], "maxItems": 25 }

The cheapest way in. Each creator comes back with followers, expected plays, 30-day engagement, e-commerce GMV band and a three-tier price preview, so you can rank candidates before buying anything deeper.

Search videos on a keyword, filtered

{
  "searchType": "search",
  "keywords": ["美食"],
  "maxItems": 200,
  "sortType": "最多点赞",
  "publishTime": "一周内",
  "duration": "一分钟以内"
}

sortType, publishTime, duration and contentType are free filters passed to the search itself, so a narrow query genuinely returns and bills fewer rows than a broad one.

Everything a creator has posted

{ "searchType": "user-posts", "userUrls": ["https://www.douyin.com/user/MS4wLjABAAAA..."], "maxItems": 100 }

Walks the creator's own post list with full stats on every video, so you can measure output and engagement over time instead of trusting a follower count.

Read the room on one video

{ "searchType": "comments", "videoUrls": ["7628908247805725986"], "maxItems": 300 }

Comments with likes, reply counts and the commenter's nickname. Swap searchType to danmaku for the on-screen bullet comments, which carry the second of the video they appear at.

Watch what is trending right now

{ "searchType": "trends", "maxItems": 50 }

Two boards in one run: the live hot-search words with their hot value, and the hot-video billboard. No input to fill; maxItems caps each board.

One video, or one profile, in full

{ "searchType": "profile", "userUrls": ["MS4wLjABAAAA..."] }

profile is the only way to get a complete, consistent creator record (verification, IP location, cross-platform followers). Use video-detail with videoUrls for the same depth on a single video.

---

Input

searchType is the only required field. Fill the one source field its mode reads, and nothing else is needed.

Parameter	Type	Default	Used by	Description
searchType	string	search	—	The mode: search, video-detail, profile, user-posts, comments, danmaku, trends, creator-search, xingtu-analytics, rate-card.
keywords	string[]	(none)	search, creator-search	One or more terms, e.g. 美食, 旅行.
videoUrls	string[]	(none)	video-detail, comments, danmaku	Video URLs or bare numeric aweme IDs.
userUrls	string[]	(none)	profile, user-posts	Profile URLs or bare sec_user_id values.
creatorHandles	string[]	(none)	xingtu-analytics, rate-card	Douyin handles (抖音号 / unique_id), e.g. XiaoZhenlla.
maxItems	integer	20	search, user-posts, comments, danmaku, trends, creator-search	Results per keyword or target, up to 5000. Cost scales with it.
sortType	string	综合排序	search	综合排序 (comprehensive), 最多点赞 (most liked), 最新发布 (newest). Free.
publishTime	string	不限	search	不限, 一天内 (last day), 一周内 (last week), 半年内 (last 6 months). Free.
duration	string	不限	search	不限, 一分钟以内 (under 1 min), 一到五分钟 (1 to 5 min), 五分钟以上 (over 5 min). Free.
contentType	string	不限	search	不限, 视频 (video), 图片 (image), 文章 (article). Free.

video-detail, profile, xingtu-analytics and rate-card return exactly one record per target, so maxItems does not apply to them.

⚠️ Which references actually work. A video reference must be a https://www.douyin.com/video/<numeric id> URL (the /note/ and /share/video/ paths work too) or the bare numeric ID on its own. A profile reference must be a https://www.douyin.com/user/MS4w... URL or the bare sec_user_id starting with MS4w. A v.douyin.com/... short link carries no ID and is skipped with a warning, so expand it first. Duplicate references are removed before anything is called, so a repeated URL never bills twice.

If the field your mode reads is empty, the run ends with a message telling you which field to fill and charges nothing.

---

What data does the Douyin Scraper return?

One row per result. Every row carries searchType plus the context key of its mode, so a dataset from a multi-keyword run stays sortable.

Group	Fields
Row context	searchType · keyword (search, creator search) · awemeId (comments, danmaku) · secUid (user's posts) · handle (both Xingtu creator modes) · board (trends: hot-search or hot-video)
Video (search, video detail, user's posts)	awemeId · url · shareUrl · desc · createTime · durationMs · coverUrl · downloadUrl · region · city · pinned
Video stats	stats.diggCount · commentCount · collectCount · shareCount · playCount · recommendCount
Author (free, inside every video)	author.secUid · uid · nickname · uniqueId · avatarUrl · signature · verified · verifyReason · followerCount · followingCount · awemeCount · totalFavorited
Video context	music{id,title,author,isOriginal,duration,playUrl} · hashtags[] · mentions[{secUid,userId,nickname}] · videoTags[{id,name,level}]
Profile	secUid · uid · uniqueId · nickname · signature · url · avatarUrl · verified · verifyReason · ipLocation · city · province · country · gender · followerCount · followingCount · awemeCount · totalFavorited · mplatformFollowers
Comment	cid · text · diggCount · replyCount · createTime · user (nickname)
Danmaku	text · offsetTimeMs · createTime
Trends, hot search	rank · word · hotValue · viewCount · discussVideoCount · wordType · label
Trends, hot video board	rank · awemeId · title · itemUrl · nickname · score · playCount · likeCount · fansCount
Xingtu creator search	starId · coreUserId · nickname · follower · city · province · gender · starIndex · interactRate30d · expectedPlay · expectedNaturalPlay · interactionMedian30d · playOverRate30d · fansIncrement30d · fansIncrementRate15d · contentThemeLabels · ecomLevel · ecomScore · ecomGmv30dRange · ecomGpm30dRange · ecomAvgOrderValue30dRange · linkStarIndex · linkConvertIndex · linkSpreadIndex · linkShoppingIndex · priceRmb{d1to20,d20to60,d60plus}
Xingtu analytics	coreUserId · nickname · uniqueId · secUid · follower · avgPlay · city · province · gender · authorType · categoryId · contentThemeLabels · tags · grade · isStar · eCommerceEnable · lowestPrice · fansDistribution · dailyFans
Xingtu rate card	kolId · priceTiers[{desc,priceRmb,originPriceRmb,settlementDesc,videoType,isOpen}]

Three things worth knowing before you build on the output. The author block rides free inside every video and costs no extra call, but Douyin fills it differently per shape: a search row carries followerCount, a video-detail row carries awemeCount and totalFavorited, and missing fields come back null rather than absent. The complete, consistent creator record is the profile mode. All Xingtu prices are in RMB, already converted from the fen the platform returns. And stats.playCount is frequently 0 in search results because Douyin does not expose plays on that surface, so rank by diggCount instead.

Example row

{
  "searchType": "search",
  "keyword": "美食",
  "awemeId": "7628908247805725986",
  "url": "https://www.douyin.com/video/7628908247805725986",
  "desc": "五星级酒店桌桌必点的美食！",
  "createTime": 1730000000,
  "durationMs": 47000,
  "region": "CN", "city": "510100", "pinned": false,
  "coverUrl": "https://p3-pc-sign.douyinpic.com/...jpeg",
  "downloadUrl": "https://v3-search.douyinvod.com/...mp4",
  "stats": { "diggCount": 1201980, "commentCount": 50077, "collectCount": 131748, "shareCount": 1169447, "playCount": 0, "recommendCount": 33295 },
  "author": {
    "secUid": "MS4wLjABAAAA...", "uid": "2507361040475383",
    "nickname": "小珍来咯", "uniqueId": "XiaoZhenlla",
    "verified": false, "verifyReason": null,
    "followerCount": 4820000, "followingCount": 12,
    "awemeCount": null, "totalFavorited": null,
    "avatarUrl": "https://p3-pc.douyinpic.com/...jpeg",
    "signature": "每天一条美食视频"
  },
  "music": { "id": "7011...", "title": "原创音乐", "author": "小珍来咯", "isOriginal": true, "duration": 47 },
  "hashtags": ["美食", "探店"],
  "mentions": [],
  "videoTags": [{ "id": 3001, "name": "美食", "level": 1 }]
}

A rate-card row is the other shape worth seeing, because it is the one nothing else on the Store returns cheaply:

{
  "searchType": "rate-card",
  "handle": "XiaoZhenlla",
  "kolId": "7265712290765209612",
  "priceTiers": [
    { "desc": "1-20s视频", "priceRmb": 1500, "originPriceRmb": 1500, "settlementDesc": "固定价格", "videoType": 1 },
    { "desc": "21-60s视频", "priceRmb": 1500, "originPriceRmb": 1500, "videoType": 2 },
    { "desc": "60s以上视频", "priceRmb": 1800, "originPriceRmb": 1800, "videoType": 3 }
  ]
}

---

How much does it cost to scrape Douyin?

Pay per result, priced per mode. Apify Gold and above pay 20% less on every event.

Mode	Billed per	Free–Silver	Gold+
Keyword search	video	$0.003	$0.0024
User's posts	video	$0.003	$0.0024
Video detail	video	$0.004	$0.0032
User profile	profile	$0.004	$0.0032
Video comments	comment	$0.002	$0.0016
Danmaku	bullet comment	$0.002	$0.0016
Trends	row	$0.002	$0.0016
Xingtu creator search	creator	$0.01	$0.008
Xingtu creator analytics	creator	$0.04	$0.032
Xingtu rate card	creator	$0.08	$0.064

What is free: every search filter (sort, publish time, duration, content type), the whole embedded author block on each video, the mp4 downloadUrl, failed and not-found lookups, and a keyword search that returns nothing at all.

Two minimum charges, so nothing surprises you. A keyword search that returns between one and three videos bills four, which is what one paid request costs us. A comments or danmaku lookup on a video that has none still bills one row for the same reason. Every other mode bills only what it returns.

Buy only what you need, because the cheap modes already carry a lot. Xingtu creator search at $0.01 already returns each creator's core analytics and a three-tier price preview. Creator analytics at $0.04 adds average plays, category, fan distribution and the daily follower trend. The rate card at $0.08 adds every advertising format beyond those three tiers, plus settlement terms and list-versus-actual pricing. If creator search answers your question, stop there.

Free plan: 10 keyword-search results per calendar month, plus 1 result in each of the other nine modes, so you can inspect every field before paying. The counters reset on the 1st. Any paid Apify plan removes the cap.

---

What do people use the Douyin Scraper for?

• Influencer discovery and pricing: shortlist creators by keyword, then pull the Xingtu rate card and know the budget before the first message.
• Sponsorship benchmarking: compare list price against actual price across a category, and see which creators are discounting.
• Competitor and content research: track a brand's account, its whole catalogue and the engagement each video actually earned.
• Trend monitoring: run the hot-search and hot-video boards on a schedule and catch a topic while it is still climbing.
• Audience analysis: read fan distribution and the daily follower trend for any Xingtu creator before committing budget.
• E-commerce creator sourcing: filter candidates on GMV band, GPM and average order value instead of on follower count.
• Comment and danmaku mining: read what an audience says about a product, in their words, at the second it appears on screen.
• AI agent context: hand an assistant a creator's catalogue, analytics and prices as data it can reason over.

---

Douyin Scraper vs cookie-based tools vs the official Douyin API

	This Douyin Scraper	Cookie-based scrapers	Official Douyin API
Douyin account / cookies	Not needed	Your session cookie required, and it expires	Enterprise onboarding and approval
Account / ban risk	None (no account used)	High (your account can be restricted)	None
Xingtu analytics and rate cards	Yes, both, priced per creator	Rarely	No public access
Modes in one Actor	10, switched by one field	Usually one job per tool	Scoped to your own content
Video download URL	Included free on every video row	Varies	Not applicable
Pricing	Pay per result, from $0.002	Subscription plus your own account	Contract

---

🏆 Top China Scrapers

	RedNote Scraper Notes, user profiles and comments from 小红书
	Douyin Scraper  YOU ARE HERE
	Weibo Scraper Posts and user profiles from 微博
	Bilibili Scraper Videos, creators and stats from 哔哩哔哩

---

FAQ

What is a Douyin scraper?

A Douyin scraper turns a keyword, a video URL, a profile URL or a creator handle into structured data: the videos and their like, comment, share and collect counts, the creator behind each one, the comments and danmaku under them, and the live trend boards. This Actor returns that as JSON rows, without opening the app or logging in.

Do I need a Douyin account or cookies?

No. There is no login, no session and no cookie, so there is no account-ban risk.

What is Xingtu (星图)?

Xingtu is Douyin's official influencer-marketing platform. Its creator analytics and advertising rate cards are the numbers brands use to size and price a sponsorship. This Actor returns them as data, without a Xingtu enterprise account.

How do I find a creator's handle?

It is the 抖音号 shown on their profile, the unique_id, e.g. XiaoZhenlla. Paste it into creatorHandles and the Actor resolves it to the Xingtu creator id itself.

Can I use this from ChatGPT or Claude?

Yes, two ways. Paste the "Copy to your AI assistant" block above into any LLM and it will write the call for you. Or connect the Douyin MCP server config above, and every Atomus Actor becomes a native tool your assistant can call on its own, including chaining several in one request.

How much does it cost?

It depends on the mode: $0.003 per video from a keyword search, $0.004 per profile or video detail, $0.002 per comment, danmaku or trend row, $0.01 per creator from Xingtu search, $0.04 per creator analytics record and $0.08 per rate card. Gold plans and above pay 20% less. Failed and not-found lookups are free. Free Apify plans include 10 search results and 1 result in each other mode per month.

Can I download the videos?

Every video row carries a free downloadUrl, an mp4 straight from Douyin's CDN, read out of a response you already paid for. The Actor returns the link, it does not re-host the file, and the link can expire and may need a browser User-Agent when you fetch it.

Which Douyin URLs work?

https://www.douyin.com/video/<numeric id> for videos, https://www.douyin.com/user/MS4w... for profiles, or the bare ID in either case. A v.douyin.com short link has no ID in it and is skipped, so open it once and copy the full URL.

Is there an official Douyin API for this?

There is no open public API for this data. Official access runs through enterprise onboarding, and Xingtu analytics sit behind a business account. This Actor reads public Douyin data without either.

Is it legal to scrape Douyin?

This Actor reads publicly visible content. You are responsible for using the output in line with applicable laws (GDPR/CCPA), Douyin's terms, and your own compliance requirements. It is an independent tool, not affiliated with Douyin.

Can I run this on a schedule?

Yes. Apify Schedules run the Actor on a cron interval and webhooks push each finished run into your systems, which is how the trends mode becomes a monitor.

---

抖音采集器中文说明

无需抖音账号、无需登录、无需 Cookie。十种模式覆盖关键词搜索、视频详情、用户主页、用户作品、评论、弹幕、实时热榜，以及品牌方用来核算投放预算的星图（星图）达人搜索、达人分析与广告报价。按关键词或链接抓取，每个关键词或目标最多 5,000 条，查询失败或未找到不计费。

十种抓取模式

用 searchType 选择模式，然后只填写该模式读取的那一个字段。

模式（searchType）	输入	返回
关键词搜索（search）	关键词	匹配该关键词的视频，含作者与互动数据
视频详情（video-detail）	视频链接或 ID	单条视频的完整数据
用户主页（profile）	主页链接或 sec_user_id	完整达人档案：认证、IP 属地、全平台粉丝
用户作品（user-posts）	主页链接或 sec_user_id	该达人的作品列表，每条带完整数据
视频评论（comments）	视频链接或 ID	评论，含点赞数、回复数与评论者昵称
弹幕（danmaku）	视频链接或 ID	弹幕，含出现的时间点
实时热榜（trends）	无需输入	热搜词榜 + 热门视频榜，一次两个榜单
星图达人搜索（creator-search）	关键词	达人清单，含核心指标与三档报价预览
星图达人分析（xingtu-analytics）	抖音号	平均播放、分类、粉丝画像分布、每日涨粉趋势
星图达人报价（rate-card）	抖音号	按视频时长分档的广告报价，人民币计价

常用示例

谈合作前先看报价。 只需填抖音号，系统自动解析为星图达人 ID，返回含刊例价、结算方式与全部可售形式的报价单。

{ "searchType": "rate-card", "creatorHandles": ["XiaoZhenlla"] }

按关键词筛选达人清单。 最便宜的入口：每位达人返回粉丝数、预期播放、30 天互动率、电商 GMV 区间与三档报价预览，先排序再决定是否买更深的数据。

{ "searchType": "creator-search", "keywords": ["美食"], "maxItems": 25 }

关键词搜索视频，可免费筛选。 sortType、publishTime、duration、contentType 直接下发到搜索接口，筛得越准，返回和计费的条数就越少。

{
  "searchType": "search",
  "keywords": ["美食"],
  "maxItems": 200,
  "sortType": "最多点赞",
  "publishTime": "一周内",
  "duration": "一分钟以内"
}

达人的全部作品。 翻取作品列表并带完整数据，可用于衡量更新频率与真实互动，而不只看粉丝数。

{ "searchType": "user-posts", "userUrls": ["https://www.douyin.com/user/MS4wLjABAAAA..."], "maxItems": 100 }

看单条视频下的真实反馈。 把 searchType 换成 danmaku 即可获取弹幕，弹幕还带出现的秒数。

{ "searchType": "comments", "videoUrls": ["7628908247805725986"], "maxItems": 300 }

实时热榜。 一次运行返回热搜词与热门视频两个榜单，无需填写输入，maxItems 分别限制每个榜单的条数。

{ "searchType": "trends", "maxItems": 50 }

单个主页的完整数据。 profile 是获取完整、稳定达人档案的唯一模式；单条视频的同等深度请用 video-detail 配合 videoUrls。

{ "searchType": "profile", "userUrls": ["MS4wLjABAAAA..."] }

输入参数

只有 searchType 为必填。填写该模式读取的那一个来源字段即可。

参数	类型	默认值	说明
searchType	string	search	抓取模式，必填。取值见上表。
keywords	string[]	无	关键词，用于「关键词搜索」「星图达人搜索」，如 美食、旅行。
videoUrls	string[]	无	视频链接或纯数字视频 ID，用于「视频详情」「视频评论」「弹幕」。
userUrls	string[]	无	主页链接或纯 sec_user_id，用于「用户主页」「用户作品」。
creatorHandles	string[]	无	抖音号（unique_id），如 XiaoZhenlla，用于「星图达人分析」「星图达人报价」。
maxItems	integer	20	每个关键词或目标的最大结果数，上限 5000，数量越大费用越高。用于搜索、用户作品、评论、弹幕、热榜、达人搜索。
sortType	string	综合排序	免费筛选，仅「关键词搜索」：综合排序、最多点赞、最新发布。
publishTime	string	不限	免费筛选，仅「关键词搜索」：不限、一天内、一周内、半年内。
duration	string	不限	免费筛选，仅「关键词搜索」：不限、一分钟以内、一到五分钟、五分钟以上。
contentType	string	不限	免费筛选，仅「关键词搜索」：不限、视频、图片、文章。

video-detail、profile、xingtu-analytics、rate-card 每个目标只返回一条记录，因此不受 maxItems 影响。四项筛选使用抖音自身的取值，请按上表原样填写。

支持的链接格式：视频为 https://www.douyin.com/video/<数字ID>（/note/ 与 /share/video/ 同样可用）或纯数字 ID；主页为 https://www.douyin.com/user/MS4w... 或以 MS4w 开头的纯 sec_user_id。v.douyin.com/... 短链本身不含 ID，会被跳过并记录日志，请先在浏览器中打开取得完整链接。重复的链接在调用前自动去重，不会重复计费。若所选模式对应的字段为空，运行会以提示信息正常结束，且不产生任何费用。

输出字段

每条结果为数据集中的一行，均带 searchType 标明来源模式，并带该模式的上下文字段：搜索与达人搜索带 keyword，评论与弹幕带 awemeId，用户作品带 secUid，两个星图模式带 handle，热榜带 board（hot-search / hot-video）。

• 视频（搜索、视频详情、用户作品）：awemeId、url、shareUrl、desc、createTime、durationMs、coverUrl、downloadUrl、region、city、pinned，以及 stats（diggCount、commentCount、collectCount、shareCount、playCount、recommendCount）、music、hashtags[]、mentions[]、videoTags[]。
• 作者（随视频免费返回）：author.secUid、uid、nickname、uniqueId、avatarUrl、signature、verified、verifyReason、followerCount、followingCount、awemeCount、totalFavorited。
• 主页：secUid、uid、uniqueId、nickname、signature、url、avatarUrl、verified、verifyReason、ipLocation、city、province、country、gender、followerCount、followingCount、awemeCount、totalFavorited、mplatformFollowers。
• 评论：cid、text、diggCount、replyCount、createTime、user（昵称）。
• 弹幕：text、offsetTimeMs、createTime。
• 热榜：热搜词为 rank、word、hotValue、viewCount、discussVideoCount、wordType、label；热门视频为 rank、awemeId、title、itemUrl、nickname、score、playCount、likeCount、fansCount。
• 星图达人搜索：starId、coreUserId、nickname、follower、city、province、gender、starIndex、interactRate30d、expectedPlay、expectedNaturalPlay、interactionMedian30d、playOverRate30d、fansIncrement30d、fansIncrementRate15d、contentThemeLabels、ecomLevel、ecomScore、ecomGmv30dRange、ecomGpm30dRange、ecomAvgOrderValue30dRange、linkStarIndex、linkConvertIndex、linkSpreadIndex、linkShoppingIndex、priceRmb（三档预览）。
• 星图达人分析：coreUserId、nickname、uniqueId、secUid、follower、avgPlay、city、province、gender、authorType、categoryId、contentThemeLabels、tags、grade、isStar、eCommerceEnable、lowestPrice、fansDistribution、dailyFans。
• 星图达人报价：kolId、priceTiers[]（desc、priceRmb、originPriceRmb、settlementDesc、videoType、isOpen）。

三点需要注意：作者信息随视频免费返回，不额外调用接口，但抖音在不同接口填充的字段不同（搜索结果带 followerCount，视频详情带 awemeCount 与 totalFavorited），缺失字段返回 null，完整且稳定的达人档案请用 profile 模式；星图价格均为人民币，已由平台返回的「分」换算完成；搜索结果中的 stats.playCount 常为 0，因为该接口不返回播放量，排序请改用 diggCount。结果示例见上方英文部分的 Example row，两边字段完全一致。

价格

按结果计费，分模式定价，无订阅。Apify Gold 及以上套餐所有事件一律 8 折。

模式	计费单位	Free–Silver	Gold+
关键词搜索	每条视频	$0.003	$0.0024
用户作品	每条视频	$0.003	$0.0024
视频详情	每条视频	$0.004	$0.0032
用户主页	每个主页	$0.004	$0.0032
视频评论	每条评论	$0.002	$0.0016
弹幕	每条弹幕	$0.002	$0.0016
热榜	每条	$0.002	$0.0016
星图达人搜索	每位达人	$0.01	$0.008
星图达人分析	每位达人	$0.04	$0.032
星图达人报价	每位达人	$0.08	$0.064

免费的部分：全部搜索筛选（排序、发布时间、时长、内容类型）、视频内嵌的 author 信息、mp4 downloadUrl、重复链接的去重、查询失败或未找到的目标，以及零结果的关键词搜索。

两处最低计费：关键词搜索若只返回 1 至 3 条视频，按 4 条计费；对没有评论或没有弹幕的视频执行 comments / danmaku，按 1 条计费。原因是一次请求就是一次查询，返回 200 条、1 条还是 0 条，成本相同，最低计费覆盖的是这次请求本身。其余模式一律只按实际返回的条数计费。

按需购买，便宜的模式已包含大量数据：星图达人搜索（$0.01）已返回核心分析指标与三档报价预览；达人分析（$0.04）额外提供平均播放、分类、粉丝画像分布与每日涨粉趋势；达人报价（$0.08）额外提供三档预览之外的全部广告形式、结算方式与刊例价/实际价。若达人搜索已够用，就不必再买。

免费套餐：每个自然月可免费获取 10 条关键词搜索结果，其余九个模式各 1 条，足以在付费前查看所有字段。计数每月 1 日重置，任何付费 Apify 套餐都会解除该上限。

使用场景

• 达人发现与定价：按关键词筛人，再拉取星图报价，在发出第一条私信前就确定预算。
• 投放价格对标：横向比较同类达人的刊例价与实际价，看清谁在让利。
• 竞品与内容研究：追踪某个账号的全部作品及其真实互动表现。
• 热点监控：定时运行热搜词与热门视频榜，在话题上升期就抓住它。
• 受众分析：投放前先看达人的粉丝画像分布与每日涨粉趋势。
• 电商达人选品：用 GMV 区间、GPM 与客单价区间筛人，而不是只看粉丝数。
• 评论与弹幕挖掘：用用户自己的话了解他们对产品的看法，弹幕还能精确到出现的秒数。
• AI 智能体的数据源：把达人的作品、分析与报价交给助手直接推理。

与 Cookie 类工具、官方 API 的对比

	本抖音采集器	Cookie 类采集器	官方抖音 API
抖音账号 / Cookie	不需要	需要你的登录 Cookie，且会过期	需企业接入与审核
账号风险	无（不使用账号）	高（账号可能被限制）	无
星图分析与报价	均支持，按达人计费	很少支持	无公开访问
模式数量	10 种，一个字段切换	通常一个工具一件事	仅限自有内容
视频下载链接	每条视频免费附带	视工具而定	不适用
计费方式	按结果计费，最低 $0.002	订阅费 + 自备账号	合同

常见问题

需要抖音账号或 Cookie 吗？ 不需要。全程无登录、无会话、无 Cookie，因此不存在账号被限制的风险。

星图是什么？ 星图是抖音官方的达人营销平台，其达人分析与广告报价正是品牌方核算与议定投放所依据的数据。本采集器让你无需星图企业账号即可以结构化数据获取它们。

在哪里找达人的抖音号？ 就是主页上显示的抖音号（unique_id），例如 XiaoZhenlla。填入 creatorHandles 即可，系统会自动解析为星图达人 ID。

可以在 ChatGPT 或 Claude 里使用吗？ 可以。把上方 Copy to your AI assistant 代码块粘贴给任意大模型，它会替你写好调用；或接入上方的 Douyin MCP Server 配置，让每个 Atomus 采集器都成为助手可以自行调用的原生工具，并支持一次请求中串联多个。

可以下载视频吗？ 每条视频结果都带免费的 downloadUrl，是从已付费的响应中直接读出的抖音 CDN mp4 链接。本采集器只返回链接，不转存文件；链接可能过期，抓取时可能需要浏览器 User-Agent。

哪些抖音链接可用？ 视频用 https://www.douyin.com/video/<数字ID>，主页用 https://www.douyin.com/user/MS4w...，或直接填纯 ID。v.douyin.com 短链不含 ID，会被跳过，请先打开一次再复制完整链接。

每个关键词最多能取多少条？ 每个关键词或目标最多 5,000 条。采集器自动翻页并跨页去重；冷门关键词只会返回实际存在的数量。

有官方 API 吗？ 没有面向这类数据的开放公共 API。官方接入需要企业审核，星图分析更在商业账号之后。本采集器无需两者即可读取抖音公开数据。

可以定时运行吗？ 可以。用 Apify Schedules 按 cron 周期运行，用 webhooks 把每次运行结果推送到你的系统，热榜模式因此可以变成持续监控。

采集抖音合法吗？ 本采集器只读取公开可见的内容。你需要自行确保数据用途符合适用法律（GDPR/CCPA）、抖音的服务条款以及自身的合规要求。

免责声明

本采集器为独立工具，与抖音、星图或字节跳动均无关联，也未获得其背书或赞助。抖音®（Douyin）与星图®（Xingtu）为字节跳动的商标，其他商标归各自所有者所有。请在遵守适用的数据保护法律（GDPR、CCPA）及抖音服务条款的前提下使用本采集器提取的数据，不得用于垃圾信息、骚扰或任何违法用途。

---

All Atomus scrapers

2.4M+ RESULTS DELIVERED

LinkedIn	Profile · Posts · Reactions · Comments · Company · Employees
Lead gen	Leads Finder
Google Maps	Places & local businesses
TikTok	Videos · Comments
X (Twitter)	Tweets & profiles
RedNote 小红书	Notes, users & comments
Douyin 抖音	Profiles, videos & comments
Weibo 微博	Posts & profiles
Bilibili 哔哩哔哩	Videos & creators

---

Support

Hey, I'm Chico, founder of Atomus. I built this Actor and I answer the messages about it. Something broke? A field you need isn't there? Not sure it fits what you're doing? Send me a message, most answers come the same day. 💬  DM me on LinkedIn    or hello@dendelabs.com

---

⚠️ Disclaimer

This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Douyin, Xingtu or ByteDance. Douyin® (抖音) and Xingtu® (星图) are trademarks of ByteDance. All trademarks are property of their respective owners.

Use the data extracted by this Actor in compliance with applicable data protection laws (GDPR, CCPA) and Douyin's terms of service. Do not use it for spam, harassment, or unlawful purposes.