Answers
How can a company outside China get Douyin data in English?
Short answer
Call Douyin through an API instead of the app: okdata returns public Douyin videos, comments, the hot search board and Xingtu creator data to callers in any country, with no Douyin account. Field names are in English; captions and comments stay in Chinese, so let your model translate. A keyword search costs $0.02 for about 20 videos, and a 78-call weekly scan costs $0.474.
A skincare brand in London wants a weekly read on what Chinese consumers say about sunscreen on Douyin. Its agency also wants to know which Douyin creators are worth pitching before the brief goes to a partner in Shanghai. Nobody on the team reads Chinese, and the research runs on a cloud server in Europe. okdata does the part in between: it reads public Douyin data when you call it and returns JSON to a caller in any country, with no Douyin account. The keys are in English. Captions, comments and creator names stay in Chinese, and a model turns them into an English report.
Why the usual routes stall
- TikTok is not Douyin. The two apps are entirely separate, and Douyin targets only the China market. When Citizen Lab tested it from a Canadian network address in 2021, it still showed content local to China. A TikTok tool or API will not return Douyin videos.
- Open-source scrapers trip on Douyin's request checks. In the tracker of a widely used open-source video downloader, Douyin downloads have failed with "Fresh cookies (not necessarily logged in) are needed" since April 2024. The reports come from the United States, Vietnam and China, often with valid cookies, and by November 2026 the same request was getting a 403 before any cookie check. A mainland proxy alone does not fix that: users inside China see the same error.
- The official open platform answers a different question. It is built for apps acting for Douyin accounts that log in and authorize them, not for reading other people's videos. See what the Douyin Open Platform covers.
What you can pull
| Need | Endpoint | Price |
|---|---|---|
| Videos for a keyword | video search | $0.02 per page of about 20 |
| One video from a share link | video detail | $0.002 |
| What viewers say | video comments | $0.002 per page of about 20 |
| What China is searching for now | hot search board | $0.002 for about 50 entries |
| A brand's or creator's account | account profile | $0.002 |
| Creators for a brief | Xingtu creator search | $0.004 per page of about 20 |
| Who follows a creator | Xingtu creator audience | $0.004 |
Xingtu (巨量星图) is Douyin's official creator marketplace. Each creator in a Xingtu search comes with followers, 30-day engagement rate, median views, content categories and the listed price of an integrated and a custom video, in yuan. The audience endpoint splits a creator's followers by gender, age, province, city tier, interest, phone brand and spending, with the date Xingtu last measured it. For a quick look without code, the free Douyin hot search page shows the same board in a browser.
Getting to English
Every endpoint answers in the same JSON shape, with keys such as text, author.name, metrics.likes, metrics.comments, published_at, followers and engagement_rate. Keys and units are fixed and in English, so an engineer who reads no Chinese can write the parser. The values are what Douyin shows: captions, comments, hashtags, creator names and content categories arrive in Chinese, and Xingtu prices in yuan with currency set to CNY.
Hand the items to your model with an instruction like "translate into English, keep the Chinese original beside each quote, leave brand and product names as they are". Filter first and translate second, and ask only for the fields you need with fields; both save tokens.
Search in Chinese as well. Douyin is written for Chinese users, so search 防晒霜 rather than sunscreen, and let the model turn the English brief into Chinese keywords before the first call.
A weekly scan, priced
| Task | Calls | Cost |
|---|---|---|
| 8 Chinese keywords, 2 pages each, most liked first | 16 | $0.32 |
| Comments on the top 20 videos, 2 pages each | 40 | $0.08 |
| Hot search board, once a day | 7 | $0.014 |
| Xingtu creator search, 5 niches | 5 | $0.02 |
| Follower profiles of 10 shortlisted creators | 10 | $0.04 |
| The whole weekly scan | 78 | $0.474 |
Prices are in US dollars. The balance is prepaid by card, Alipay or WeChat Pay, and a new key comes with $0.10 to try it. A call that reaches Douyin is charged even when it comes back empty or fails; a call stopped before that, for bad parameters or an empty balance, is free.
Code
import os, requests
API = "https://api.okdata.online"
H = {"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"}
def get(path, **params):
body = requests.get(API + path, headers=H, params=params, timeout=60).json()
if body["code"] != "ok":
raise RuntimeError(f"{body['code']}: {body['message']}")
return body
videos, cursor = [], None
for _ in range(2): # two pages for one keyword
params = {"query": "防晒霜 测评", "sort": "most_liked",
"fields": "id,url,text,author.name,metrics.likes,metrics.comments,published_at"}
if cursor:
params["cursor"] = cursor
body = get("/v1/douyin/videos/search", **params)
videos += body["data"]["items"]
if not body["page"]["has_more"]:
break
cursor = body["page"]["next_cursor"]
board = get("/v1/douyin/trends/list", fields="rank,name,heat")["data"]["items"]
print(len(videos), "videos and", len(board), "hot searches; ask the model for an English summary with the Chinese quoted")
Or through MCP
If the research happens in Claude, Cursor or another MCP client, add one server, https://api.okdata.online/mcp, with your key as a Bearer token, and ask in plain English: "Find this week's most-liked Douyin videos about sunscreen, read the comments on the top five and summarize them in English, quoting the Chinese." Looking up endpoints and prices is free; each call is billed like the HTTP API. Setup for each client is on the MCP page.
Things that trip people up
- Search, detail and account video lists come back with
metrics.viewsnull, andmeta.unavailablesays why. Read plays per video with Douyin video play count for $0.002 each. - The Xingtu creator ID is not the Douyin account ID. Take it from the Xingtu search.
- Creators who never joined Xingtu will not turn up there; find them with account search instead.
- Only public data comes back: nothing behind a login, no private messages.
- Data is read live when you call;
meta.fetched_atsays when.
Other routes
A Chinese-speaking colleague or a partner agency in China can browse Douyin by hand, which is often enough for a one-off question. Chinese subscription dashboards suit teams that want charts and creator rankings, though they are built for Chinese speakers and priced by the month. The same approach for Xiaohongshu is in Xiaohongshu data for agents outside China, and creator vetting in more depth is on the creator discovery page.
Sources
Where people asked this (read 2026-11-16)
Updated