For AI

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.views null, and meta.unavailable says 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_at says 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

Connect once, then just ask.

Every new key comes with $0.10 to try it. One sentence connects your agent.

Start free
Connect your AI

Paste this into your agent

Read https://okdata.online/agents.md and set up okdata for me; my key is in the OKDATA_API_KEY environment variable.

Claude Code, Cursor, Codex and other agents that can open a link set themselves up from it.

MCP serverhttps://api.okdata.online/mcp