# 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.

Published 2026-11-15 · https://toolsocket.top/blog/douyin-data-for-ai-agents

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

```bash
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](https://toolsocket.top/docs).

Add credit in the [console](https://toolsocket.top/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

> Ask your agent: "What'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#web/fetch_hot_search_result` — Douyin · Get Douyin hot search results (web) ($0.0015 / call)

### Analyze one video and its comments

Paste a share link from the Douyin app (Share → Copy link):

> Ask your agent: "How 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#web/fetch_one_video_by_share_url` — Douyin · Get single video data by sharing link (web) ($0.0015 / call)
- `douyin#web/fetch_video_comments` — Douyin · Get single video comments data (web) ($0.0015 / call)

### Watch a competitor's account

> Ask your agent: "Of 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 agent: "Search 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

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

```bash
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](https://toolsocket.top/tools/tiktok).

### 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](https://toolsocket.top/blog/chinese-social-media-data-api).
