Skip to main content

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

terminal
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"
response.json
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": 22100
13 },
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.

FastPay-as-you-goScales to millions99.9% uptimeWell-documentedNo app review

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)

Single & batch videoVideo statistics / play countUser profilesUser posts & likedComments & repliesFans listMusic detailsHashtag detailsHot search listHighest-quality play URL

Douyin Search API ($0.01)

General & multi-typeVideo searchUser searchLive searchMusic searchHashtag searchImage & image-textVision (image-based)

Douyin Web API

Video detailsUser profilesComments & repliessec_user_id / aweme_id resolversLive room dataFollowing listHighest-quality play URL

Douyin Xingtu (星图) API

KOL search & discoveryKOL base infoAudience & fans portraitsService priceData overviewVideo performanceConversion analysisXingtu index

Douyin Billboard (榜单) API

Hot video & topic listsRising hot listsSearch hot listsAccount rankingsAudience portraitsFan-data trendsContent word clouds

Creator & Index (指数) API

Creator-center rankings (V1)Cookie-authed account analytics (V2)抖音指数 keyword trendsCreator & brand analyticsDemographic portraits

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.

TikHubWestern scraper APIs
Hot-content billboards & charts
Xingtu creator marketplace
Douyin e-commerce listings
Live rooms & danmaku

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.

Use caseEndpointDocs
Get video data/api/v1/douyin/app/v3/fetch_one_video
Get highest-quality video/api/v1/douyin/app/v3/fetch_multi_video_high_quality_play_url
Get video by share URL/api/v1/douyin/app/v3/fetch_one_video_by_share_url
Batch get videos/api/v1/douyin/app/v3/fetch_multi_video

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.

Use caseEndpointDocs
General search/api/v1/douyin/search/fetch_general_search_v2
Multi-type search/api/v1/douyin/search/fetch_multi_search
Video search/api/v1/douyin/search/fetch_video_search_v2
Image search/api/v1/douyin/search/fetch_image_search

Douyin Web API

Fallback for App V3, plus the URL → ID resolvers (sec_user_id / aweme_id) and live-room data.

Use caseEndpointDocs
Get video data/api/v1/douyin/web/fetch_one_video
Get user profile/api/v1/douyin/web/handler_user_profile
Get highest-quality video/api/v1/douyin/web/fetch_multi_video_high_quality_play_url
Get video by share URL/api/v1/douyin/web/fetch_one_video_by_share_url

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.

Use caseEndpointDocs
Get sign image (encrypted image parse)/api/v1/douyin/xingtu/get_sign_image
Resolve kolid by Douyin user ID/api/v1/douyin/xingtu/get_xingtu_kolid_by_uid
Resolve kolid by sec_user_id/api/v1/douyin/xingtu/get_xingtu_kolid_by_sec_user_id
Resolve kolid by unique_id/api/v1/douyin/xingtu/get_xingtu_kolid_by_unique_id

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.

Use caseEndpointDocs
Fetch Chinese city list/api/v1/douyin/billboard/fetch_city_list
Fetch vertical content tags/api/v1/douyin/billboard/fetch_content_tag
Fetch hot-list category/api/v1/douyin/billboard/fetch_hot_category_list
Fetch rising hot list/api/v1/douyin/billboard/fetch_hot_rise_list

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.

Use caseEndpointDocs
Creator Service Center data (V1, no login)/api/v1/douyin/creator/*
Own-account analytics (V2, cookie required)/api/v1/douyin/creator_v2/*
抖音指数 keyword / creator / brand trends/api/v1/douyin/index/*

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].reasonMeaning
8Unavailable due to overseas copyright restriction (short dramas, movie clips), or deleted
5Private account / private video
10Partially 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.

snippet
1GET /api/v1/douyin/web/get_sec_user_id?url=<douyin_user_url> // docs: 186826167e0
2GET /api/v1/douyin/web/get_aweme_id?url=<douyin_video_url> // docs: 186826169e0

Creator 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.

Read the full download guide

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.

Live Room API & per-message pricing

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.

Start free