Douyin API
Scrape Douyin (抖音, the Chinese TikTok): video search, creator (博主) videos and profiles, comments, followers, hashtag and sound feeds, and the hot search board (热榜). Video authors and commenters come with user ID, sec_uid and IP location. No login or cookies needed. Export to JSON, CSV or Excel.
Douyin API in one table
| Official public API for people outside China | No. This tool collects the publicly visible data instead. |
|---|---|
| What you send | A keyword, a link or an ID, depending on the request type |
| What you get back | JSON rows with English field names; 21 request types |
| Login, cookies, Chinese phone number | None needed |
| Output formats | JSON, CSV, Excel, or the Apify API |
| Price | $0.005 per result on the Bronze tier, no subscription |
| Last verified with a real run | 2026-11-09 |
21 kinds of Douyin request
Douyin (抖音) is the Chinese short-video app and the Chinese counterpart of TikTok. It runs separately from TikTok, with its own accounts, videos and trends. Creators post short videos with hashtags and sounds, viewers comment and like, and the app shows a hot search board of trending topics.
- Hot search board
- Search videos by keyword
- Creator's videos
- Video details
- Creator profiles
- Hashtag videos
- Video comments
- Creator's followers
- Creator's following list
- Search creators by keyword
- Videos using a sound
- Extended boards
- Video danmaku
- Recommendation feed
- Search hashtags by keyword
- Search sounds by keyword
- Video collection (mix)
- Short-drama series
- Videos related to a video
- Home recommendation feed
- Experience search by keyword
A real run, 4 fields per record
Run on 2026-11-10 with input {"mode": "hot", "maxResults": 50}. Personal fields of ordinary users are masked here.
| word | hotValue | rank |
|---|---|---|
| 纳指大涨近3% 英伟达跌超4% | 12102191 | 2 |
| 全网老吃家带着绝活开锅了 | 11733464 | 5 |
| 爱旅游的人已拿到双11大结果 | 10543690 | 6 |
| 我的家乡申请出战 | 10525516 | 7 |
| 原来是冬天来了 | 9131167 | 11 |
| Knight:战胜T1的心情是爽 | 9095471 | 13 |
All 4 fields in one record
typehotTopicrank2word纳指大涨近3% 英伟达跌超4%hotValue12102191
Need only one kind of Douyin data?
These smaller tools do one job each, with fewer settings.
Douyin 抖音 Search Scraper
Search Douyin (抖音, the Chinese TikTok) videos or image posts by keyword: caption, hashtags, like, comment, share and favorite counts, author
Douyin 抖音 Video Scraper
Get full details of Douyin (抖音) videos from URLs, v.douyin.com share links or video IDs: caption, hashtags, like, comment, share and favorit
Douyin 抖音 Comments Scraper
Scrape comments of Douyin (抖音) videos with replies: text, likes, reply count, time, commenter nickname, uid and IP location. Paste video URL
Douyin 抖音 Profile Scraper
Get Douyin (抖音) creator profiles from profile links, share links, sec_uid, uid or Douyin ID: nickname, bio, followers, following, likes, vid
Douyin 抖音 Hot Search Scraper
Read the Douyin (抖音) hot search board (热榜) in real time: rank, keyword and heat value. Schedule it to track what China is watching. No login
Call the Douyin API
Every run is one HTTP call: send the input as JSON, get the rows back. The same works from Make, Zapier or n8n.
Pay per result
Bronze tier prices from the tool's listing; higher Apify tiers pay less. Free Apify users get two trial runs with their own input.
Full price table and worked examples
The Actor uses pay-per-event pricing: a small start fee per run plus a fee per item returned. Prices in USD:
| Event | When it is charged | Bronze | Silver | Gold, Platinum, Diamond |
|---|---|---|---|---|
run-start |
Once per run. A keyword search for videos, hashtags or sounds (modes search, hashtagSearch, musicSearch) is charged the start fee twice; all other modes, including creator search, once |
$0.00005 | $0.00005 | $0.00005 |
result |
Each video, comment (and reply), hot topic, follower or following entry, creator, hashtag, sound, series or board entry returned (the detail boards eventDetail and hotWordDetail: each record or row, and each ID after the first also pays one run-start fee) |
$0.005 | $0.004511 | $0.004076 |
row |
Each danmaku returned (mode danmaku). Every video in danmaku mode also pays the run-start fee: the first one with the run, each further video when its lookup starts |
$0.002 | $0.001804 | $0.00163 |
detail |
Each full video detail (mode video, one lookup per video; with withPlayCount on, a video whose real play count was found is charged one further run-start fee), each hashtag, sound, collection or series detail record |
$0.005 | $0.004511 | $0.004076 |
profile |
Each creator profile (mode profile). A numeric uid or Douyin ID is looked up with one request when the answer already holds the profile, otherwise with a second one; the price is the same |
$0.00552 | $0.00498 | $0.0045 |
The run-start fee is charged when the first request succeeds, even if that request returns nothing. It is not charged when the run fails from the start or rejects the IDs, or when the spending limit cannot cover it.
You never pay for more than maxResults items.
Worked examples:
- 100 comments on a Bronze plan: $0.00005 + 100 × $0.005 = $0.50005, so 100 results cost about $0.50.
- 100 video details on a Gold plan: $0.00005 + 100 × $0.004076 = $0.40765.
- 100 creator profiles on a Silver plan: $0.00005 + 100 × $0.00498 = $0.49805.
- 500 danmaku of one video on a Bronze plan: $0.00005 + 500 × $0.002 = $1.00005. Three videos with 500 each: 3 × $0.00005 + 1,500 × $0.002 = $3.00015.
- 100 video details with real play counts on a Gold plan: $0.00005 + 100 × ($0.004076 + $0.00005) = $0.41265 (without
withPlayCount: $0.40765).
On the free Apify plan you get 2 free trial runs of this Actor with your own input, up to 10 results each, and nothing is charged; after that, runs return a stored sample dataset (a real result of the prefilled input). Use any paid Apify plan for full runs.
Douyin API questions
Do I need a Douyin account, cookies or proxies?
No. You don't need a login, cookies, proxies or a Chinese phone number. You only need an Apify account.
Is it legal to scrape Douyin?
The Actor returns only public data that Douyin shows to any visitor. It does not return private data such as private messages, birthdays, ages or schools. You are responsible for how you use the data, including compliance with privacy laws such as GDPR and with Douyin's terms.
How fresh is the data?
Each run reads Douyin live. Numbers such as likes and followers are what Douyin shows at the time of the run.
Why are some fields empty?
Douyin does not return every field for every account or video. For example, follower entries usually have no gender or IP location, creator videos have no `authorGender`, and `userVerified` is filled only for verified commenters. See "Fields that are often empty" above.
How many results can I get?
Up to 5000 items per run with `maxResults`. Some sources are smaller: a hidden follower list returns nothing, and a sound with few videos returns only those videos.
Can I get play counts?
Yes, in mode `video` with `withPlayCount` turned on: the video detail then carries the real `playCount`. Each video whose count was found costs one extra run-start fee ($0.00005); when the count cannot be read, `playCount` is null and nothing extra is charged. The hot video boards (`boardVideo`) carry plays too. Search, creator and hashtag results have likes, comments, shares and saves but no `playCount`.