ToolSocket / Guides / Guide

How to get Douyin (Chinese TikTok) data into Claude, ChatGPT or Cursor

Guide · · 3 min read · ToolSocket team · 中文版

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.

Ask your agentWhat's on the Douyin trending list right now? Give me the top 20 with a one-line English explanation of each.

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):

Ask your agentHow is this Douyin video performing? Then pull the first 100 comments and summarize what people are saying, with a few positive and negative examples translated to English. https://v.douyin.com/xxxxxx/

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

Ask your agentOf this Douyin account's last 30 videos, which 5 got the most likes, and what do they have in common?

About 2 calls of the user-videos tool.

Search by keyword

Ask your agentSearch Douyin for 露营装备 (camping gear) and list the 10 most-liked videos from the past month with title, creator and likes.

The general search tool supports filters for publish time, duration and sort order, at $0.015 / call per call.

What it costs

TaskCallsApprox. cost
Trending list1$0.0015 / call
One video + 100 comments6~$0.01
An account's last 30 videos2~$0.003
Keyword search, 3 pages3~$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