# How can a company outside China get Douyin data in English?

> Search Douyin videos, read comments, follow the hot search board and vet Xingtu creators from any country, with no Douyin account. English JSON keys; the model translates.

Canonical page: https://okdata.online/answers/douyin-data-outside-china-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](/answers/douyin-open-platform-api/).

## What you can pull

| Need | Endpoint | Price |
|---|---|---|
| Videos for a keyword | [video search](/apis/douyin/videos/search/) | $0.02 per page of about 20 |
| One video from a share link | [video detail](/apis/douyin/videos/get/) | $0.002 |
| What viewers say | [video comments](/apis/douyin/videos/comments/list/) | $0.002 per page of about 20 |
| What China is searching for now | [hot search board](/apis/douyin/trends/list/) | $0.002 for about 50 entries |
| A brand's or creator's account | [account profile](/apis/douyin/users/get/) | $0.002 |
| Creators for a brief | [Xingtu creator search](/apis/douyin/xingtu/creators/search/) | $0.004 per page of about 20 |
| Who follows a creator | [Xingtu creator audience](/apis/douyin/xingtu/creators/audience/get/) | $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](/tools/hot-search/douyin/) 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

```python
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](/mcp/).

## 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](/apis/douyin/videos/metrics/) 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](/apis/douyin/users/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](/answers/xiaohongshu-data-for-agents-outside-china/), and creator vetting in more depth is on the [creator discovery page](/solutions/creator-discovery/).

## Endpoints used

- [Douyin video search](https://okdata.online/apis/douyin/videos/search/) `douyin.videos.search`: $0.02 per call · about 20 videos per page
- [Douyin video detail](https://okdata.online/apis/douyin/videos/get/) `douyin.videos.get`: $0.002 per call
- [Douyin video comments](https://okdata.online/apis/douyin/videos/comments/list/) `douyin.videos.comments.list`: $0.002 per call · about 20 comments per page
- [Douyin hot search board](https://okdata.online/apis/douyin/trends/list/) `douyin.trends.list`: $0.002 per call · about 50 board entries per page
- [Douyin account profile](https://okdata.online/apis/douyin/users/get/) `douyin.users.get`: $0.002 per call
- [Douyin Xingtu creator search](https://okdata.online/apis/douyin/xingtu/creators/search/) `douyin.xingtu.creators.search`: $0.004 per call · about 20 creators per page
- [Douyin Xingtu creator audience](https://okdata.online/apis/douyin/xingtu/creators/audience/get/) `douyin.xingtu.creators.audience.get`: $0.004 per call

## More about Douyin

- [Douyin API](https://okdata.online/apis/douyin/)
- [Douyin API in Python: videos, profiles and comments (2026)](https://okdata.online/guides/douyin-api-python/)
- [How to export Douyin video comments in bulk](https://okdata.online/guides/douyin-video-comments/)
- [How to find Douyin Xingtu creators and get their rate cards](https://okdata.online/guides/douyin-xingtu-creator-rates/)
- [How do I give Claude access to Douyin data through MCP?](https://okdata.online/answers/claude-douyin-data-mcp/)
- [How can Doubao read Douyin and Xiaohongshu data?](https://okdata.online/answers/doubao-douyin-xiaohongshu-data/)
- [Can Tencent Yuanbao read Douyin and Xiaohongshu data?](https://okdata.online/answers/yuanbao-douyin-xiaohongshu-data/)
- [What is Douyin's a_bogus parameter, and do I need to generate it to get Douyin data?](https://okdata.online/answers/douyin-a-bogus-signature/)
- [How do I export Douyin video comments for sentiment analysis?](https://okdata.online/answers/douyin-export-comments-sentiment/)
- [How to collect Douyin comments: API, crawler or no-code (2026)](https://okdata.online/compare/douyin-comment-scraping/)
- [Douyin data APIs: official vs third-party vs open-source (2026)](https://okdata.online/compare/douyin-data-apis/)
- [Official platform APIs vs third-party data APIs (2026)](https://okdata.online/compare/official-apis-vs-data-apis/)
- [Scraping it yourself vs a per-call data API: cost, upkeep and risk](https://okdata.online/compare/scraping-vs-data-api/)
- [How to choose a social media data API (2026)](https://okdata.online/compare/social-media-data-apis/)

## Sources

Where people asked this (read 2026-11-16): 

- https://github.com/yt-dlp/yt-dlp/issues/11825
- https://github.com/yt-dlp/yt-dlp/issues/16867
- https://github.com/yt-dlp/yt-dlp/issues/17981
- https://citizenlab.ca/2021/03/tiktok-and-douyin-explained/

Updated 2026-11-16
