Social Media API
Douyin API
Read 抖音 videos, profiles, comments, search, hot-content billboards, the Xingtu creator marketplace, and e-commerce data — the deepest Douyin coverage available in English.
- Six API series including Douyin-only billboards and the Xingtu creator marketplace
- Track Chinese consumer trends weeks before they surface on Western platforms
- One key, structured JSON — no Chinese developer registration or 抖音 open-platform approval
$0.05 free credit on sign-up · no credit card · from $0.001/request
One request, structured JSON
1curl -X GET "https://api.tikhub.io/api/v1/douyin/app/v3/fetch_one_video?aweme_id=7350810998023949599" \2 -H "Authorization: Bearer YOUR_API_KEY"1{2 "code": 200,3 "data": {4 "aweme_id": "7350810998023949599",5 "desc": "示例视频文案 #热门",6 "create_time": 1711305600,7 "statistics": {8 "play_count": 3120000,9 "digg_count": 214000,10 "comment_count": 5230,11 "share_count": 1840,12 "collect_count": 2210013 },14 "author": {15 "uid": "98765432101234",16 "nickname": "用户昵称",17 "follower_count": 880000,18 "unique_id": "douyin_id"19 },20 "video": { "duration": 21000, "play_addr": { "url_list": ["https://..."] } }21 }22}Get your API key at user.tikhub.io/dashboard/api — or follow the getting-started guide.
What's in the Douyin API
TikHub's Douyin API covers China's biggest short-video platform across multiple series: the recommended App V3 endpoints, a dedicated search series, web endpoints, the Xingtu (星图) creator-marketing platform, hot-content billboards (榜单), the public Creator Service Center, and the 抖音指数 trend-analytics index. If your research, trading, or marketing intelligence touches the Chinese internet, this is the data layer.
Douyin App V3 API (recommended)
Douyin Search API ($0.01)
Douyin Web API
Douyin Xingtu (星图) API
Douyin Billboard (榜单) API
Creator & Index (指数) API
Billboards and Xingtu — the China-only surfaces
Douyin (抖音) is ByteDance's separate Chinese app, and most providers either don't cover it or stop at basic video data. TikHub ships Douyin-only surfaces no TikTok API has: hot-content billboards and category charts, the Xingtu creator-marketplace data brands use to vet KOLs, and full e-commerce listings. It's the difference between watching China and actually reading it.
Douyin API endpoints
A reference of the most-used Douyin endpoints. Browse the full set in the API reference or the documentation.
Douyin App V3 API (recommended)
The most stable series — prioritize it and fall back to Web only when App V3 errors. Play count is not in the standard video endpoints; use fetch_video_statistics.
Douyin Search API (dedicated — $0.01/request)
Douyin search has its own series — do NOT use search from the Web or App V3 series, they are not functional. Billed at $0.01/request (no volume discount), paginated, and returns roughly 6–10 results per call, varying each time.
Douyin Web API
Fallback for App V3, plus the URL → ID resolvers (sec_user_id / aweme_id) and live-room data.
Douyin Xingtu (星图) API
Douyin's official KOL marketing platform. Resolve a creator's Xingtu kolid (by uid / sec_user_id / unique_id), then pull KOL analytics. A newer Xingtu V2 series (/api/v1/douyin/xingtu_v2/…, ~20 endpoints) adds ranking lists and the creator marketplace.
Douyin Billboard (榜单) API
Hot-content rankings with no TikTok equivalent — hot/rising video, topic, search, and account lists, plus audience portraits and fan-data trends.
Douyin Creator & Index (抖音指数) API
Two more Douyin-only families. Creator V1 (/api/v1/douyin/creator/…) is public Creator Service Center data — no login. Creator V2 (/api/v1/douyin/creator_v2/…) is account analytics for your own account and needs your Douyin Creator-Platform cookie. The 抖音指数 series (/api/v1/douyin/index/…, ~44 endpoints) covers keyword, creator, video, and brand trend analytics. Browse the full list in the Swagger UI.
Tips & troubleshooting
Hard-won operational notes for working with Douyin data in production.
Recommended API version
Prioritize the Douyin App V3 endpoints for stability, and use the Douyin Web endpoints only as a fallback when App V3 returns errors.
Search is a dedicated series — and costs more
Do not call search from the Web or App V3 series; those search endpoints are not functional. Use the dedicated /api/v1/douyin/search/* series instead. It's priced at $0.01 per request with no volume discount (high maintenance cost), is paginated, and returns roughly 6–10 results per call — the exact count varies each time, so getting fewer than expected is normal.
Play count needs its own endpoint
Douyin video play count is NOT included in the standard fetch-video endpoints. Use the dedicated fetch_video_statistics endpoint (/api/v1/douyin/app/v3/fetch_video_statistics) to get it. Note the returned view count excludes views from Dou+ paid-promotion traffic.
Empty results with a 200 status — read the reason code
If App V3 fetch-video returns empty results but status 200, the video is filtered, not missing — retry with the Web version, and check $.data.filter_list[0].reason for why. For any other code, contact customer support.
| filter_list[0].reason | Meaning |
|---|---|
| 8 | Unavailable due to overseas copyright restriction (short dramas, movie clips), or deleted |
| 5 | Private account / private video |
| 10 | Partially visible — author restricted it to selected viewers |
Resolve sec_user_id & aweme_id from URLs
Most endpoints key off a sec_user_id (user) or aweme_id (video). Extract them from any Douyin URL with the dedicated Web resolvers before calling the analytics or video endpoints.
1GET /api/v1/douyin/web/get_sec_user_id?url=<douyin_user_url> // docs: 186826167e02GET /api/v1/douyin/web/get_aweme_id?url=<douyin_video_url> // docs: 186826169e0Creator V2 needs your own account cookie
Any endpoint under /api/v1/douyin/creator_v2/* returns account-level analytics for a creator's OWN account and requires that user's valid Douyin Creator-Platform cookie (passed in the POST body). Without access to the account, this data can't be retrieved. The public Creator V1 series (/api/v1/douyin/creator/*) needs no login.
Douyin has no Shop API — use TikTok Shop
Douyin does not offer shop or product endpoints. If you need e-commerce / product data, use the TikTok Shop API instead (TikTok only).
Downloads & 400 errors
For downloads, prefer the App V3 series; download links are time-limited, so re-fetch when one expires. A 400 usually means the target is gone — verify the Douyin video or user is still available and public in the app before treating it as an API fault.
Live streaming
For all Douyin livestream inquiries, use the Live Room API. Note that anonymous viewers, and users with invisible mode enabled in live rooms, cannot be fetched via the API.
Comments & pagination
For comment endpoints, keep the requested count at 30 or fewer — a larger count can cause errors or missing items. Paginated endpoints (comments, search, etc.) often return fewer items than the requested count; that's normal pagination, not a bug — keep paginating with the returned cursor to get more results.
What's the difference between the Douyin API and the TikTok API?
Douyin (抖音) is ByteDance's separate Chinese app with its own content, accounts, and infrastructure. TikHub provides dedicated API series for each — including Douyin-only surfaces like billboards and the Xingtu creator marketplace that have no TikTok equivalent.
Do I need a Chinese developer account or 抖音 open-platform approval?
No. Create a TikHub account, generate an API key, and call REST endpoints. There's no Chinese developer registration, no open-platform application, and no OAuth.
Is using a Douyin API like this legal?
TikHub only returns publicly available Douyin data — content any visitor can see without an account. It does not bypass authentication or access private information. Douyin is a Chinese platform, so the relevant constraints are its own Terms of Service and China's data and cross-border rules rather than US case law; automated access can lead to account or IP blocks, which TikHub's infrastructure absorbs for you. You remain responsible for how you store, process, and use the data — especially any personal data and any onward transfer across borders.
What are the rate limits?
The default rate limit is 10 requests per second. RPS plans scale it up — 20 RPS at $5/month through 100 RPS at $55/month — and enterprise accounts get custom limits above 100 RPS.
How much does the Douyin API cost?
Most Douyin endpoints are pay-as-you-go from $0.001 per request, with automatic daily volume discounts down to $0.0005 at 30,000+ requests/day. The one exception is the dedicated Douyin Search series, billed separately at $0.01 per request with no volume discount, reflecting its higher maintenance cost. New accounts get $0.05 free credit — no credit card required.
Douyin API: the deepest 抖音 data access in English in 2026
TikHub's Douyin API reads public 抖音 data — videos, profiles, comments, search, hot-content billboards, the Xingtu creator marketplace, and e-commerce — through plain REST calls, with no Chinese developer registration. Here's how it works, what makes it deeper than a generic scrape, where its limits are, and which option fits which job.
How does the Douyin API work?
What is the Douyin API?
The TikHub Douyin API is a RESTful interface that returns structured JSON for public content on 抖音 — ByteDance's Chinese short-video app, which is a separate platform from TikTok with its own content, accounts, and infrastructure. You request a video, profile, comment thread, search, billboard, or Xingtu record and get clean, typed data back.
It spans six series, including Douyin-only surfaces — hot-content billboards and the Xingtu creator marketplace — that have no TikTok equivalent. For anyone whose research, trading, or marketing intelligence touches the Chinese internet, it's the data layer for the largest platform there.
How do you access and use it?
Create a TikHub account, generate an API key, and make an HTTP GET request with the key in the Authorization header. Identify content by aweme_id (Douyin's video ID), a user's sec_uid, a share URL, or a search term, and you get JSON back. There's no Chinese developer registration, no 抖音 open-platform application, and no OAuth.
What programming languages are supported?
Any HTTP-capable language — Python, JavaScript/TypeScript, Go, Java, PHP, and more — plus no-code tools. Python is common for China-market data pipelines, with an official SDK available, but the API is language-agnostic; the request shape is identical across stacks.
What are the benefits of using the Douyin API?
Why is it deeper than a generic short-video scrape?
Most providers either don't cover Douyin or stop at basic video and profile data. TikHub adds the surfaces that actually matter for China intelligence: the Billboard series with hot-content and category rankings, the Xingtu series with official creator-marketplace data for KOL vetting, full e-commerce listings, danmaku bullet comments, and dedicated search across videos, users, music, and live.
That breadth is the difference between watching Douyin and reading it — between knowing a video went viral and understanding which billboard it climbed, which creator tier produced it, and how the audience reacted moment to moment.
What are the time-saving advantages?
Douyin is harder to scrape than most Western platforms — Chinese-language responses, aggressive anti-bot measures, and signing schemes that change. Building and maintaining that yourself is a significant, ongoing effort. TikHub absorbs it and exposes a stable contract, so a team can read Chinese social data in an afternoon instead of a quarter, and keep reading it without a dedicated maintenance burden.
Who benefits — analysts, brands, or AI teams?
China-market analysts track consumer trends weeks before they surface in the West. Brands vet and book creators via Xingtu data and monitor Douyin e-commerce competitors. AI teams build Chinese-language corpora and trend-prediction models from a structured source. For all three, the Douyin-only billboards and marketplace data are signals a generic scrape can't provide.
What are the limitations of the Douyin API?
What data is and isn't available?
The API returns publicly available 抖音 data — videos, profiles, comments, search, billboards, Xingtu marketplace records, live rooms, and e-commerce listings. Private accounts, direct messages, and non-public analytics are not accessible, and the API is read-only: no posting, commenting, or following. Live-room endpoints return data only while a room is broadcasting.
Are there copyright or download considerations?
Some Douyin play URLs carry copyright restrictions. Use the App V3 V3 single-video endpoint, which returns content without those restrictions, and the dedicated high-quality-play-URL endpoints for the best stream. Download links are time-limited — re-fetch if one stops working — and regional restrictions may require a proxy, as on TikTok.
Are there rate limits?
The default is 10 requests per second, upgradeable with RPS plans. Comment, search, and list endpoints are cursor-paginated and return bounded pages; keep following the cursor for more. Prefer App V3 endpoints for stability and fall back to the Web series only when needed.
What are common use cases for the Douyin API?
How is it used for China market research?
Analysts use search, billboards, and trending data to read Chinese consumer behavior at its source — what's rising, which creators drive it, and how it differs by category. Because Douyin trends often precede Western ones, this is an early-warning system for brands and investors watching ByteDance's home market.
How is it used for influencer and e-commerce intelligence?
The Xingtu marketplace data lets brands vet creators with real performance and pricing signals before booking campaigns, while the e-commerce and Shop-style listings support competitive monitoring of products and sellers. Together they make Douyin a full-funnel intelligence source, from creator discovery to commerce tracking.
How does it power AI and trend models?
Structured Chinese-language video, caption, comment, and danmaku data feeds training corpora, sentiment pipelines, and trend-prediction models. Real-time billboards and search give agents a live read on the Chinese internet. The danmaku stream in particular supports moment-level engagement modeling that aggregate metrics can't capture.
Are there alternatives to the Douyin API?
What other Douyin data tools exist?
Douyin's official open platform exists but requires Chinese business registration and approval, and exposes a narrow, sanctioned slice. A handful of open-source Douyin scrapers exist (often Chinese-language projects) but carry the usual reliability and maintenance burden against a platform that's hard to scrape. Few Western data providers cover Douyin in depth at all.
Which option is best for different needs?
If you have a Chinese business entity and need only the sanctioned open-platform slice, that route exists. For everyone else — especially non-Chinese teams that need real depth, including billboards and Xingtu — a managed API like TikHub is the practical choice: the deepest English-accessible Douyin coverage, one key, no Chinese registration, and the same key works across TikTok and 14 other platforms.
One key, every platform
The Douyin API shares its key and JSON format with 15 other platforms — adding Instagram or Douyin is a one-line change.