# Douyin MCP Server

SocialToAI is a hosted MCP server that lets your AI read Douyin: search videos and read video details, comments, account profiles, an account's videos and the trending list. You add one address to Claude, ChatGPT or Cursor; there is no Douyin account, login or cookie to provide and nothing to install. Calls cost 2 to 12 credits each (from $0.004); failed calls are free. Last tested 2026-10-17.

- Page: https://socialtoai.com/mcp/douyin/
- Last updated: 2026-10-18
- Last tested: 2026-10-17

## Connect

- MCP (Streamable HTTP): `https://mcp.socialtoai.com/mcp`
- Header: `Authorization: Bearer <YOUR_API_KEY>`
- The full steps for each client: https://socialtoai.com/mcp.md

### Sign in and allow

- Claude app (#claude-app): A form in the app, Customize → Connectors → Add custom connector
- ChatGPT (#chatgpt): A form in the app, ChatGPT settings → Apps → Create

### Your key in a request header

- Claude Code (#claude-code): One command, Terminal
- Cursor (#cursor): A few lines of configuration, ~/.cursor/mcp.json
- Codex (#codex): A few lines of configuration, ~/.codex/config.toml
- Trae (#trae): A few lines of configuration, MCP → Add → Configure manually
- Cherry Studio (#cherry-studio): A form in the app, Settings → MCP Servers → Add
- Dify (#dify): A form in the app, Tools → MCP → Add MCP Server (HTTP)
- n8n (#n8n): A form in the app, MCP Client Tool node

## What your AI can call on Douyin

| Tool | What it returns | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- |
| `search` | Find videos by keyword: text, author, likes, comment count and publish time. | `douyin.search` | 12 | https://socialtoai.com/douyin-search-api.md |
| `trending` | What is trending now: title, rank and heat. | `douyin.trending` | 2 | https://socialtoai.com/douyin-trending-api.md |
| `detail` | One video by ID or link: text, author, likes, comment count and publish time. | `douyin.detail` | 2 | https://socialtoai.com/douyin-detail-api.md |
| `comments` | The comments under one video: text, likes, reply count and time. | `douyin.comments` | 2 | https://socialtoai.com/douyin-comments-api.md |
| `user_profile` | One account: name, bio, followers, following and post count. | `douyin.user_profile` | 2 | https://socialtoai.com/douyin-user-profile-api.md |
| `user_posts` | The recent videos of one account. | `douyin.user_posts` | 2 | https://socialtoai.com/douyin-user-posts-api.md |

### Only on Douyin (through the call tool)

| Interface | What it does | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- |
| `kol_search` | Search Douyin creators on Xingtu by words in their name. | `douyin.kol_search` | 3 | https://socialtoai.com/douyin-kol-search-api.md |
| `kol_profile` | Get a Douyin creator's profile on Xingtu by Xingtu creator ID. | `douyin.kol_profile` | 3 | https://socialtoai.com/douyin-kol-profile-api.md |
| `kol_audience` | Get who follows a Douyin creator, by Xingtu creator ID. | `douyin.kol_audience` | 3 | https://socialtoai.com/douyin-kol-audience-api.md |
| `kol_performance` | Get how a Douyin creator's videos did over the last 30 or 90 days, by Xingtu creator ID. | `douyin.kol_performance` | 3 | https://socialtoai.com/douyin-kol-performance-api.md |
| `brand_radar` | Get the daily averages of a brand's search, content and spread indexes on Douyin over a date range, from the platform's own index tool, with the averages of every brand in its industry and of the industry's top 3, 5, 10, 15 and 30 to hold them against. | `douyin.brand_radar` | 2 | https://socialtoai.com/douyin-brand-radar-api.md |
| `account_history` | Get how a Douyin account's numbers moved over the last 7 or 30 days, by its numeric ID, from the platform's own index tool. | `douyin.account_history` | 2 | https://socialtoai.com/douyin-account-history-api.md |
| `video_stats` | Get a Douyin video's counts as of now, by its ID. | `douyin.video_stats` | 2 | https://socialtoai.com/douyin-video-stats-api.md |
| `related_videos` | Get the batch of videos Douyin recommends beside a video, by its ID. | `douyin.related_videos` | 2 | https://socialtoai.com/douyin-related-videos-api.md |
| `hashtag_videos` | Get a page of Douyin videos under a hashtag, by the hashtag's ID. | `douyin.hashtag_videos` | 2 | https://socialtoai.com/douyin-hashtag-videos-api.md |
| `keyword_audience` | Get who is behind a keyword on Douyin over a date range, from the platform's own keyword tool. | `douyin.keyword_audience` | 2 | https://socialtoai.com/douyin-keyword-audience-api.md |
| `keyword_history` | Get the day-by-day search index and composite index of a keyword on Douyin over a date range, from 巨量算数 (the Douyin index), with the daily averages of the period, of the one before and of a year earlier. | `douyin.keyword_history` | 4 | https://socialtoai.com/douyin-keyword-history-api.md |
| `kol_rates` | Get what a Douyin creator charges on Xingtu for each kind of sponsored work, and how it is settled. | `douyin.kol_rates` | 24 | https://socialtoai.com/douyin-kol-rates-api.md |
| `kol_videos` | Get a page of a Douyin creator's videos by Xingtu creator ID, newest first, with the figures Xingtu gives for each. | `douyin.kol_videos` | 3 | https://socialtoai.com/douyin-kol-videos-api.md |
| `brand_history` | Get a brand's day-by-day search, content and spread indexes on Douyin over a date range, from the platform's own index tool. | `douyin.brand_history` | 2 | https://socialtoai.com/douyin-brand-history-api.md |
| `account_top_videos` | Get the videos the platform's own index tool lists as a Douyin account's top videos for a span of up to 30 days, by the account's numeric ID. | `douyin.account_top_videos` | 2 | https://socialtoai.com/douyin-account-top-videos-api.md |
| `account_audience` | Get who follows a Douyin account from the platform's own index tool, by the account's numeric ID. | `douyin.account_audience` | 2 | https://socialtoai.com/douyin-account-audience-api.md |
| `account_metrics` | Get a Douyin creator's core figures from the platform's own index tool, by the account's numeric ID. | `douyin.account_metrics` | 2 | https://socialtoai.com/douyin-account-metrics-api.md |
| `keyword_related` | Get the keywords related to a keyword on Douyin in one week, from the platform's own keyword tool. | `douyin.keyword_related` | 2 | https://socialtoai.com/douyin-keyword-related-api.md |
| `keyword_videos` | Get the roughly 20 high-index videos Douyin's index tool puts forward for a keyword. | `douyin.keyword_videos` | 2 | https://socialtoai.com/douyin-keyword-videos-api.md |
| `index_topics` | Get the live topic board or the fastest-rising topic board of Douyin's index tool, about 30 entries each. | `douyin.index_topics` | 2 | https://socialtoai.com/douyin-index-topics-api.md |
| `kol_keywords` | Get the words a Douyin creator's recent videos keep coming back to, by Xingtu creator ID. | `douyin.kol_keywords` | 2 | https://socialtoai.com/douyin-kol-keywords-api.md |
| `kol_scores` | Get the six scores Xingtu gives a Douyin creator, by Xingtu creator ID. | `douyin.kol_scores` | 5 | https://socialtoai.com/douyin-kol-scores-api.md |
| `kol_content_mix` | Get what a Douyin creator's recent videos are about, by Xingtu creator ID. | `douyin.kol_content_mix` | 3 | https://socialtoai.com/douyin-kol-content-mix-api.md |
| `marketing_calendar` | Get the campaigns on Xingtu's marketing calendar over a span of time. | `douyin.marketing_calendar` | 3 | https://socialtoai.com/douyin-marketing-calendar-api.md |

## A recorded conversation

### Brand buzz

> What are people on Douyin saying about Luckin Coffee?

| Platform | Tool | Sent | Requests | Returned | Credits |
| --- | --- | --- | --- | --- | --- |
| Douyin | [`brand_buzz`](https://socialtoai.com/tools/brand-buzz.md) | `brand: "瑞幸咖啡" · about: "连锁咖啡品牌" · platforms: ["douyin"] · window: "30d" · scale: "small"` | 1 | 7 videos | 60 |
| **Total** |  |  | 1 | 7 items | **60** |

Recorded 2026-10-18

7 of the 7 posts found are about it: 86% positive, 14% neutral, 0% negative. What they mention most:

1. **Price** (43%, 3 videos): [“0.01喝瑞幸教程”](https://www.douyin.com/video/7692360995854888356)
2. **Design** (29%, 2 videos): [“高蛋白莓果酸奶饮，一杯约含20g蛋白质，可以满足每日约1/3蛋白需求，代餐抗饿。”](https://www.douyin.com/video/7690305595958227443)
3. **Where to get it** (29%, 2 videos): [“也是在镇上喝上细糠了”](https://www.douyin.com/video/7696830697339897573)

Used 60 credits · $0.2. Every claim links to its source.

### Comment analysis

> What are people asking in the comments under trending coffee videos on Douyin?

| Platform | Tool | Sent | Requests | Returned | Credits |
| --- | --- | --- | --- | --- | --- |
| Douyin | [`comment_insights`](https://socialtoai.com/tools/comment-insights.md) | `targets: ["https://www.douyin.com/video/7696845789318456571","https://www.douyin.com/video/7697458024826604785"] · scale: "small"` | 1 | 36 comments | 50 |
| **Total** |  |  | 1 | 36 items | **50** |

Recorded 2026-10-18

I read 36 comments under 2 videos; of the 28 that could be judged, 11 ask a question and 7 want to buy. The topics:

1. **How to buy it** (25%, 7 comments): [“小程序怎么买啊”](https://www.douyin.com/video/7696845789318456571)
2. **Mistaking it for rice** (21%, 6 comments): [“我开始以为白花花的是大米呢”](https://www.douyin.com/video/7696845789318456571)
3. **Favourite coffee drinks** (18%, 5 comments): [“我最喜欢摩卡”](https://www.douyin.com/video/7697458024826604785)

Used 50 credits · $0.17. Every claim links to its source.

### Viral posts

> Which coffee videos on Douyin did far better than usual this week?

| Platform | Tool | Sent | Requests | Returned | Credits |
| --- | --- | --- | --- | --- | --- |
| Douyin | [`research viral_finder`](https://socialtoai.com/tools/viral-finder.md) | `query: "咖啡" · window: "7d" · scale: "small"` | 1 | 14 videos | 48 |
| **Total** |  |  | 1 | 14 items | **48** |

Recorded 2026-10-18

14 posts found; 4 did at least 3 times the usual. The formats that took off most, each with its share of the 13 posts the analysis could name:

1. **How-to** (23%, 3 videos): [“咖啡行业专业词 大白话翻译”](https://www.douyin.com/video/7697458024826604785)
2. **Showcase** (15%, 2 videos): [“用话梅酱来惊艳你们”](https://www.douyin.com/video/7696845789318456571)
3. **Review** (15%, 2 videos): 0 of them did at least 3 times the usual

Used 48 credits · $0.16. Every claim links to its source.

## Questions to ask

- Which is bigger on Douyin this week: home coffee or matcha? → search, search: 24 credits ($0.08)
- Read the comments on this Douyin video and tell me what people complain about. → detail, comments × 3: 8 credits ($0.027)
- Find five Douyin accounts that post about camping coffee and show me what they posted lately. → search, user_posts × 5: 12 credits ($0.04)

## What it cannot do

- **Fields Douyin does not give**: They come back as null and are listed in the answer's unavailable, so your AI reads them as “not given”, not as zero. `author.verified`, `metrics.views`, `metrics.reposts`, `is_pinned`, `url`, `author.followers`
- **It reads. It does not post.**: Your AI cannot post, comment, like, follow or send messages on Douyin through SocialToAI.
- **Only what is publicly visible**: Content and account information anyone can see on Douyin. Nothing behind a login: no private accounts, no direct messages, no feed of your own.

## Related pages

- [Douyin API](https://socialtoai.com/platforms/douyin.md)
- [How do I see what Douyin says about a brand with AI?](https://socialtoai.com/docs/guides/track-brand-mentions-on-douyin.md)
- [How do I see what people ask in the comments under Douyin videos with AI?](https://socialtoai.com/docs/guides/analyse-douyin-comments.md)
- [How do I find Douyin videos that did far better than usual with AI?](https://socialtoai.com/docs/guides/find-viral-videos-on-douyin.md)
- [TikTok MCP Server](https://socialtoai.com/mcp/tiktok.md)
- [Instagram MCP Server](https://socialtoai.com/mcp/instagram.md)
- [X (Twitter) MCP Server](https://socialtoai.com/mcp/x.md)
- [Reddit MCP Server](https://socialtoai.com/mcp/reddit.md)
- [YouTube MCP Server](https://socialtoai.com/mcp/youtube.md)
- [Xiaohongshu (RedNote) MCP Server](https://socialtoai.com/mcp/xiaohongshu.md)
- [Weibo MCP Server](https://socialtoai.com/mcp/weibo.md)