# Douyin MCP server for AI agents

> Give Claude, Cursor or any MCP client Douyin data: 38 endpoints from $0.002 a call, no Douyin login. Your AI finds the endpoint, says the price and fetches.

Canonical page: https://okdata.online/mcp/douyin/

## Connect your AI in one sentence

```text
Set up okdata for me by following https://okdata.online/agents.md. Here is my okdata API key: okd_…. Keep it safe and use it for all okdata calls.
```

## What it answers

| Question | Endpoint | Price |
|---|---|---|
| Douyin video search: Videos matching keywords, with likes, comments, shares and the author. | [douyin.videos.search](https://okdata.online/apis/douyin/videos/search/) | $0.02 per call · about 20 videos per page |
| Douyin video detail: One video by ID or share link: text, metrics, author, music and hashtags. | [douyin.videos.get](https://okdata.online/apis/douyin/videos/get/) | $0.002 per call |
| Douyin video comments: Top-level comments on a video, hottest first (the platform's own order). | [douyin.videos.comments.list](https://okdata.online/apis/douyin/videos/comments/list/) | $0.002 per call · about 20 comments per page |
| Douyin account profile: Followers, total likes, video count, bio and verification of an account. | [douyin.users.get](https://okdata.online/apis/douyin/users/get/) | $0.002 per call |
| Douyin account videos: An account's videos, newest first, with metrics. | [douyin.users.videos.list](https://okdata.online/apis/douyin/users/videos/list/) | $0.002 per call · about 20 videos per page |
| Douyin hot search board: The current hot search list with rank and heat. | [douyin.trends.list](https://okdata.online/apis/douyin/trends/list/) | $0.002 per call · about 50 board entries per page |
| Douyin Xingtu creator search: Find Douyin creators on Xingtu, the official creator marketplace, by what they post or by name, filtered by followers, recent engagement rate and gender. Each with followers, 30-day engagement rate and median views, content categories and what an integrated and a custom video cost (in yuan). | [douyin.xingtu.creators.search](https://okdata.online/apis/douyin/xingtu/creators/search/) | $0.004 per call · about 20 creators per page |
| Douyin Xingtu creator rate card: What a Douyin creator charges on Xingtu for each kind of sponsored work (integrated video, custom video and more), in yuan, whether each is open and how it is settled. | [douyin.xingtu.creators.rates.get](https://okdata.online/apis/douyin/xingtu/creators/rates/get/) | $0.04 per call |
| Douyin comment replies: The replies under a top-level comment, by the comment's ID and its video's ID, a page at a time: text, replier, likes, time posted and IP location. A comment that does not exist reads like one without replies: an empty page, not a 404. | [douyin.comments.replies.list](https://okdata.online/apis/douyin/comments/replies/list/) | $0.002 per call · about 20 comments per page |
| Douyin hashtag videos: Videos under a hashtag, by the hashtag's ID, in Douyin's own order, most liked first or newest first: caption, author, likes, comments, shares, saves and time posted. | [douyin.hashtags.videos.list](https://okdata.online/apis/douyin/hashtags/videos/list/) | $0.002 per call · about 10 videos per page |
| Douyin account search: Find Douyin accounts by keyword, about 30 a page: account ID (the sec_uid douyin.users.get takes), name, avatar, followers, video count and total likes. No bio or verification here; the profile has them. | [douyin.users.search](https://okdata.online/apis/douyin/users/search/) | $0.002 per call · about 30 accounts per page |
| Douyin video play count: A video's counts right now, by ID or link: plays, likes and shares. Plays are what most Douyin answers leave out. Nothing else about the video comes back; published_at is read from the video ID (to within a minute). | [douyin.videos.metrics](https://okdata.online/apis/douyin/videos/metrics/) | $0.002 per call |
| Douyin related videos: The videos Douyin recommends next to a video, by its ID, about 10 in one answer: caption, author, likes, comments, shares and saves. Recommendations change from call to call, and an ID of no video still gets a batch of unrelated ones. | [douyin.videos.related](https://okdata.online/apis/douyin/videos/related/) | $0.002 per call · about 10 videos per page |
| Douyin video boards: One of Douyin's video boards for the last 24 hours: breakouts from small accounts, highest like rate, highest completion rate or most followers won. Each with caption, plays, likes, the author's name and followers, and the followers it brought. | [douyin.videos.trending](https://okdata.online/apis/douyin/videos/trending/) | $0.002 per call · about 9 videos per page |
| Douyin search suggestions: What Douyin's search box suggests as a keyword is typed (autocomplete), in the order it lists them, about 10 at a time. Words and places only, no index. A keyword with no suggestions gives an empty list. | [douyin.keywords.related](https://okdata.online/apis/douyin/keywords/related/) | $0.02 per call · about 10 results per page |
| Douyin index: brand trends: A brand's search, content and spread indexes on Douyin day by day over a date range, from 巨量算数 (the Douyin index), with the brand's industry. An index is the platform’s score, not a count. Days are China-time calendar days. | [douyin.index.brands.history](https://okdata.online/apis/douyin/index/brands/history/) | $0.002 per call |
| Douyin index: brand vs industry: A brand's daily average search, content and spread indexes on Douyin over a date range (巨量算数), next to the averages of its whole industry and of the industry's top 3, 5, 10, 15 and 30 brands. An index is the platform’s score, not a count. | [douyin.index.brands.metrics](https://okdata.online/apis/douyin/index/brands/metrics/) | $0.002 per call |
| Douyin index: account top videos: The top videos 巨量算数 lists for a Douyin account over up to 30 days, by its numeric ID: up to 20, most liked first, with caption, link, day published, likes, comments, shares and the followers each brought. The tool mostly picks from the last day or two of the span, so end it on the day you want. One page; no plays. | [douyin.index.creators.videos.list](https://okdata.online/apis/douyin/index/creators/videos/list/) | $0.002 per call · about 20 videos per page |
| Douyin index: account followers: Who follows a Douyin account, from 巨量算数, by its numeric ID: the share of followers by gender, age, province, city (all of them), city tier, phone brand and interest. Any account with enough followers, not only marketplace creators; shares only, no head counts. | [douyin.index.creators.audience.get](https://okdata.online/apis/douyin/index/creators/audience/get/) | $0.002 per call |
| Douyin index: account daily averages: A Douyin account's daily averages from 巨量算数 over the last week and the last month, by its numeric ID: new likes, shares, comments and follows a day, each with its change against the period before. Follows are the tool's own count, larger than the net follower gain. An account the tool has nothing on is not found. | [douyin.index.creators.metrics](https://okdata.online/apis/douyin/index/creators/metrics/) | $0.002 per call |
| Douyin index: keyword audience: Who is behind a keyword on Douyin over a date range, from 巨量算数: the share and TGI of each age group, gender, province, city, city tier and interest. | [douyin.index.keywords.audience.get](https://okdata.online/apis/douyin/index/keywords/audience/get/) | $0.002 per call |
| Douyin index: keyword trends: The search index and composite index of one keyword, or of up to five at once, day by day on Douyin over a date range, from 巨量算数 (the Douyin index), with the daily averages of the period, the one before and a year earlier. An index is the platform’s score, not a count. One item per keyword the index covers; others are left out. | [douyin.index.keywords.history](https://okdata.online/apis/douyin/index/keywords/history/) | $0.006 per call · about 1 results per page |
| Douyin index: related keywords: Keywords related to one keyword on Douyin in one week, from 巨量算数: those searched together with it and those that appear with it in videos, each with relevance, its place by relevance, search index and composite index. An index is the platform’s score, not a count. | [douyin.index.keywords.related](https://okdata.online/apis/douyin/index/keywords/related/) | $0.002 per call · about 170 results per page |
| Douyin index: live hot topics: 巨量算数's live hot-topic board or its fastest-rising board, about 30 each: place, topic and topic index (the heat). The topic index is the platform's score, not a count. | [douyin.index.trends.list](https://okdata.online/apis/douyin/index/trends/list/) | $0.002 per call · about 30 board entries per page |
| Douyin index: top videos for a keyword: The 20 videos with the highest video index that 巨量算数 puts forward for a keyword: caption, link, the author's name, avatar and followers, likes, video index and time posted. One page; the author's ID is not given (douyin.videos.get has it). | [douyin.index.videos.search](https://okdata.online/apis/douyin/index/videos/search/) | $0.002 per call · about 20 videos per page |
| Douyin account growth: How a Douyin account moved over the last 7 or 30 days, by its numeric ID, from 巨量算数: net new followers, new likes, comments, shares and videos, each with its change against the period before, and the totals now. Up to five accounts in one call (one unknown ID fails the whole batch). One period's sum, not a daily series. | [douyin.users.history](https://okdata.online/apis/douyin/users/history/) | $0.002 per call |
| Douyin Xingtu creator profile: A Douyin creator's profile on Xingtu by Xingtu creator ID: name, avatar, location, gender, followers and content categories. One ID also gives the Douyin account ID (sec_uid), handle, agency and content labels; several IDs (up to 50 in one call) give the integrated and custom video rates, their expected CPMs (in yuan) and the views a video is expected to get instead. | [douyin.xingtu.creators.get](https://okdata.online/apis/douyin/xingtu/creators/get/) | $0.004 per call |
| Douyin Xingtu creator audience: Who follows a Douyin creator, by Xingtu creator ID: followers and share in each segment of gender, age, province, city (top ten), city tier, interest, phone brand, consumer group, shopping category and order size, with when Xingtu last measured it. A share is the segment's count over the total of the segments listed. | [douyin.xingtu.creators.audience.get](https://okdata.online/apis/douyin/xingtu/creators/audience/get/) | $0.004 per call |
| Douyin Xingtu creator reach: How a Douyin creator's videos did over the last 30 or 90 days, by Xingtu creator ID: videos, median views, average likes, comments and shares, engagement and completion rates with where they rank, and the expected cost per thousand views and per interaction (in yuan). The figures cover all videos; Xingtu gives none for sponsored ones alone. | [douyin.xingtu.creators.metrics](https://okdata.online/apis/douyin/xingtu/creators/metrics/) | $0.004 per call |
| Douyin Xingtu creator videos: A Douyin creator's videos by Xingtu creator ID, newest first, 20 a page, with the figures Xingtu shows for each: views, likes, comments, completion and engagement rates, length. Sponsored and everyday videos come together, unmarked. A creator that does not exist reads like one without videos. | [douyin.xingtu.creators.videos.list](https://okdata.online/apis/douyin/xingtu/creators/videos/list/) | $0.004 per call · about 20 videos per page |
| Douyin Xingtu creator keywords: The words Xingtu draws from a few of a Douyin creator's recent videos, by Xingtu creator ID: up to about 20, each with how often it came up (usually single digits). They often come from one or two videos, possibly a sponsored one, so they do not describe the creator's content as a whole; the content mix does. | [douyin.xingtu.creators.keywords.get](https://okdata.online/apis/douyin/xingtu/creators/keywords/get/) | $0.002 per call |
| Douyin Xingtu creator scores: The six scores Xingtu gives a Douyin creator, by Xingtu creator ID: the overall Xingtu index and the reach, seeding, conversion, cooperation and value-for-money indexes, each with the score, the average of comparable creators, the rank and the share of creators ranked above. | [douyin.xingtu.creators.scores.get](https://okdata.online/apis/douyin/xingtu/creators/scores/get/) | $0.008 per call |
| Douyin Xingtu creator content mix: What a Douyin creator's recent videos are about, by Xingtu creator ID: the number of videos in each of Xingtu's content categories and their share, to see whether the creator keeps to one subject. | [douyin.xingtu.creators.content_mix.get](https://okdata.online/apis/douyin/xingtu/creators/content_mix/get/) | $0.004 per call |
| Douyin Xingtu creator conversion: How a Douyin creator's product videos sell, by Xingtu creator ID: videos counted and their median views, products recommended, and the bands Xingtu puts sales, sales per thousand views, product price, cost per click, link clicks and click rate in. A band is Xingtu's text, not an exact figure; many creators, big sellers too, have no bands, and a creator with no selling figures at all is not found. | [douyin.xingtu.creators.conversion.get](https://okdata.online/apis/douyin/xingtu/creators/conversion/get/) | $0.004 per call |
| Douyin Xingtu marketing calendar: The campaigns on Xingtu's marketing calendar that overlap a span of time: platform events, e-commerce and seasonal moments, creative and industry campaigns, each with name, description, kind, stage, sign-up period and running period. All in one answer. | [douyin.xingtu.campaigns.list](https://okdata.online/apis/douyin/xingtu/campaigns/list/) | $0.004 per call · about 40 results per page |
| Douyin Xingtu video report: Xingtu's report on one Douyin video, by ID or link: plays, likes, comments, shares and saves, plus completion rate, engagement rate, length, the author's followers and the author's Xingtu creator ID (for the creator endpoints next). Only videos Xingtu covers, mostly its creators'. | [douyin.xingtu.videos.get](https://okdata.online/apis/douyin/xingtu/videos/get/) | $0.004 per call |
| Douyin account videos (backup): The backup of douyin.users.videos.list, for when it cannot serve: an account's videos, newest first, 20 a page, from a separate data path, at a little more. Caption, author, likes, comments, shares, saves and time posted. An account that does not exist reads like one without videos: an empty page, not a 404. | [douyin.backup.users.videos.list](https://okdata.online/apis/douyin/backup/users/videos/list/) | $0.0025 per call · about 20 videos per page |
| Douyin video search (backup): The backup of douyin.videos.search, for when it cannot serve: videos matching keywords from a separate data path, in Douyin's own order, newest or most liked first, optionally only from the last day, week or half year. Caption, author, likes, comments, shares, saves and time posted. | [douyin.backup.videos.search](https://okdata.online/apis/douyin/backup/videos/search/) | $0.03 per call · about 8 videos per page |

## Two calls

1. `find {"query":"douyin videos"}`: free
2. `call {"capability":"douyin.videos.search","query":"露营装备"}`: $0.02 per call · about 20 videos per page

## Skill package

- `okdata-douyin`: https://okdata.online/.well-known/agent-skills/okdata-douyin/SKILL.md · https://okdata.online/skills/okdata-douyin.zip

[Every Douyin endpoint](https://okdata.online/apis/douyin/) · [MCP server](https://okdata.online/mcp/) · [Integrations](https://okdata.online/integrations/)
