ToolSocket / Guides / Guide
How to get Douyin (Chinese TikTok) data into Claude, ChatGPT or Cursor
Douyin has no public API for other people's videos, comments or trending lists, and scraping it means fighting request signing and risk controls. This guide connects Claude, ChatGPT or Cursor to live Douyin data over MCP in five minutes, with prompts to copy, the tools involved and what each step costs.
Douyin (抖音) is the Chinese version of TikTok, with a separate app, separate content and a separate audience. If you track Chinese consumer trends, brands or creators, it's where things happen first. It's also hard to reach from outside China:
- The Douyin Open Platform is built for apps acting on behalf of users who authorize their own accounts. It generally doesn't give you other accounts' videos, comment threads, site-wide search or the trending list, and it needs a registered developer entity.
- Scraping means reverse-engineering request signatures such as
a_bogus, managing logged-in sessions and proxies, and fixing everything whenever the app changes. - Asking an AI directly gets you "I can't access Douyin."
This guide takes a shorter path: connect your AI agent to an MCP server that already has Douyin tools, then ask in plain English (or Chinese).
Step 1: Connect ToolSocket
ToolSocket is a remote MCP server at https://toolsocket.top/mcp with 240 Douyin tools, plus Xiaohongshu, WeChat, Weibo, Bilibili, TikTok, YouTube and more.
Claude.ai or Claude Desktop: Settings → Connectors → Add custom connector → URL https://toolsocket.top/mcp → sign in → Allow.
Claude Code:
claude mcp add --transport http toolsocket https://toolsocket.top/mcp
Then run /mcp inside Claude Code and choose Authenticate.
ChatGPT, Cursor, VS Code, Windsurf, Codex: copy-paste configs are in the docs.
Add credit in the console (from $5). Most Douyin calls cost $0.0015 / call, and failed calls are refunded.
Step 2: Ask
You don't need to know any tool names. The agent searches the catalog (discover_tools), reads the input schema (inspect_tool) and runs the tool (run_tool). Answers come back in whatever language you ask in; the underlying data is Chinese, and models translate it well.
What's trending on Douyin right now
One call, $0.0015 / call. It returned in about a second in our health checks.
Douyin · Get Douyin hot search results (web)douyin#web/fetch_hot_search_resultGet Douyin hot search results$0.0015 / call
Analyze one video and its comments
Paste a share link from the Douyin app (Share → Copy link):
The agent fetches the video (likes, comments, saves, shares, author, publish time), then pages through comments about 20 at a time. That's roughly 6 calls, about $0.01.
Douyin · Get single video data by sharing link (web)douyin#web/fetch_one_video_by_share_urlGet single video data by sharing link (Essentially implemented based on the /fetch_one_video interface, it is recommended to obtain the vid…$0.0015 / call
Douyin · Get single video comments data (web)douyin#web/fetch_video_commentsGet single video comments data$0.0015 / call
Watch a competitor's account
About 2 calls of the user-videos tool.
Search by keyword
The general search tool supports filters for publish time, duration and sort order, at $0.015 / call per call.
What it costs
| Task | Calls | Approx. cost |
|---|---|---|
| Trending list | 1 | $0.0015 / call |
| One video + 100 comments | 6 | ~$0.01 |
| An account's last 30 videos | 2 | ~$0.003 |
| Keyword search, 3 pages | 3 | ~$0.05 |
The agent decides how many calls to make. You can set daily and per-key spend limits in the console.
Calling it from code
Agents that run shell commands (Claude Code, Codex) can script this with the REST API:
curl -s -X POST https://toolsocket.top/v1/run \
-H "Authorization: Bearer $TOOLSOCKET_API_KEY" \
-H "content-type: application/json" \
-d '{"tool":"douyin#web/fetch_hot_search_result","input":{},"wait":30}'Add "tag": "douyin-monitor" to label runs, then filter your run history by that tag.
Good to know
- Public data only. Respect Douyin's terms and China's Personal Information Protection Law (PIPL). Analyze in aggregate; don't bulk-collect personal data about ordinary users.
- Use complete links or IDs. Some endpoints return a normal "not found" result for a bad ID and still bill the call. Test one link first.
- Numbers move. Like and comment counts are fetched live and change over the day.
FAQ
Do I need a Douyin account or a Chinese phone number?
No. ToolSocket handles upstream access. You need a ToolSocket account and a prepaid balance, payable by card through Stripe.
Is Douyin data the same as TikTok data?
No. They are separate apps with separate content and users. ToolSocket has separate tool sets for both; see the TikTok tools.
Can the agent translate the results?
Yes. The data comes back in Chinese and the agent answers in the language you asked in.
What other Chinese platforms are covered?
Xiaohongshu (RED), WeChat Channels and Official Accounts, Weibo, Bilibili, Zhihu, Kuaishou, Toutiao and more. See Chinese social media data for AI agents.
Tools used in this guide
Douyin · Get Douyin hot search results (web)douyin#web/fetch_hot_search_resultGet Douyin hot search results$0.0015 / call
Douyin · Get single video data by sharing link (web)douyin#web/fetch_one_video_by_share_urlGet single video data by sharing link (Essentially implemented based on the /fetch_one_video interface, it is recommended to obtain the vid…$0.0015 / call
Douyin · Get single video comments data (web)douyin#web/fetch_video_commentsGet single video comments data$0.0015 / call
Douyin · Get user homepage video data (app v3)douyin#app/v3/fetch_user_post_videosGet user homepage video data$0.0015 / call
Douyin · Fetch general search V1 (search)douyin#search/fetch_general_search_v1Fetch search results from Douyin App's general search tab (not standalone video search).$0.015 / call
Start with ToolSocket
One MCP URL for 881 data tools: Douyin, Xiaohongshu, WeChat, Weibo, Bilibili, TikTok, YouTube, DeFi… Pay per call; failed calls are refunded.
Claude Code, one line: claude mcp add --transport http toolsocket https://toolsocket.top/mcp
Related
- Guide · ENChinese social media data for AI agents: Douyin, Xiaohongshu, WeChat, Weibo, Bilibili, ZhihuWhat data you can get from each major Chinese platform, why official APIs rarely cover research and monitoring use cases, and how to give Claude, ChatGPT or Cu…
- 对比 · 中文抖音数据接口怎么选:开放平台、自己写爬虫、第三方数据 API 对比想拿抖音的热榜、视频、评论、博主数据,有三条路:抖音开放平台、自己写爬虫、用第三方数据 API。本文从能拿到什么数据、门槛、成本、稳定性和合规五个方面对比,帮你按场景选。
- 实操教程 · 中文用 3 个免费工具让 AI 写技术周报:GitHub + Hacker News + arXiv(附真实调用)让 Claude 或 ChatGPT 自动收集本周 GitHub 热门项目、Hacker News 首页和 arXiv 最新论文,整理成一份技术周报。本文每一步都是真实调用记录,附提问模板、返回结果和一个常见误区:按相关度搜索拿到的不是「最新」。全程免费。