# Douyin Open Platform MCP > Douyin Open Platform connects your AI agent directly to China’s short-video ecosystem. Use this MCP to automate everything from posting analysis to community management. You can list uploaded content, search trending videos, track user demographics, and even reply to comments—all without leaving your chat interface. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** douyin-api, tiktok-china, video-management, social-engagement, audience-analytics, content-creation ## Description This connector lets you manage Douyin (TikTok China) content flow using natural conversation. Instead of logging into multiple developer dashboards, your AI agent handles the heavy lifting. You can list all your uploaded videos and instantly pull performance data like view counts or engagement rates. Need to keep up with your audience? Your agent monitors comments for a specific video so you don't miss fan questions and lets you reply right away. Want to understand who follows you? It pulls detailed demographic breakdowns of your user base, giving you insights beyond just follower count. The whole system is hosted by Vinkius, making it accessible from any compatible AI client. You can even track deep historical live streaming stats or search the platform for trending content using keywords. ## Tools ### get_audience_analytics Pulls detailed demographic statistics for the followers connected to your account. ### get_live_analytics Retrieves historical data points about live streams you've conducted on Douyin. ### get_user_info Grabs the basic, authorized profile details for a specific user. ### get_video_analytics Generates performance reports and metrics for a single video you've uploaded. ### list_comments Fetches all comments left on a specific Douyin video, helping you see what people are saying. ### list_fans Lists every single user who follows your account or profile. ### list_following Shows a list of accounts that you, the authorized user, are currently following. ### list_videos Lists all videos that you have personally uploaded to your Douyin profile. ### reply_comment Sends a direct reply to any comment left on one of your videos. ### search_videos Searches the public Douyin feed for content matching specific keywords or topics. ## Prompt Examples **Prompt:** ``` List the last 5 videos uploaded to my Douyin account and show their play counts. ``` **Response:** ``` I've retrieved your recent videos. 1. 'Spring Collection' (15.4K views), 2. 'Behind the Scenes' (8.2K views), 3. 'Q&A Session' (12.1K views)... Would you like to see the demographic breakdown for any of these? ``` **Prompt:** ``` Show me the comments for video ID 'item_abc123'. ``` **Response:** ``` Fetching comments for video 'Tech Review'... I found several top comments: 1. 'Great video!' (120 likes), 2. 'Where can I buy this?' (85 likes), 3. 'Love the editing' (42 likes). Would you like to reply to any of these? ``` **Prompt:** ``` Search for videos matching 'robotics' on Douyin. ``` **Response:** ``` Searching the Douyin public feed... I've found 3 trending videos about robotics: 1. 'Humanoid Robot Demo', 2. 'DIY Robot Arm', 3. 'Boston Dynamics Update'. Which one would you like to explore? ``` ## Capabilities ### Analyze Audience Demographics Retrieves detailed demographic information about your account's followers. ### Track Video Performance Gathers performance metrics, such as play counts and engagement rates, for specific video content. ### Manage Community Interaction Lists comments on a video or replies directly to followers' comments. ### Monitor User Networks Gets lists of your own uploaded videos, the users you follow, and all your current fans/followers. ### Research Trending Content Searches for public videos across Douyin using specific keywords. ## Use Cases ### Needing to understand viewer age groups A marketing lead needs to know if their video resonates better with 18-24 year olds or 35-45s. They ask their agent, 'What's the demographic breakdown of my followers?' The agent uses `get_audience_analytics` and returns a clear age/gender distribution chart. ### Responding to viral comments A creator posts a video that gets lots of questions. Instead of manually finding the comment, they ask their agent to 'Check all comments on this new video.' The agent uses `list_comments` and then drafts a reply using `reply_comment`, keeping engagement high. ### Checking old content performance A manager needs to justify ad spending by showing which videos are most successful. They ask the agent to 'Give me the stats for my top 5 videos.' The agent calls `list_videos` and then runs `get_video_analytics` on each one. ### Finding new content ideas A team is stuck on a topic. They ask their agent to 'Search Douyin for videos about electric cars.' The agent uses `search_videos`, giving them immediate, trending concepts they can build their next reel around. ## Benefits - Stop manually checking view counts. Use `get_video_analytics` to instantly pull performance metrics for any video. - Never miss a fan question again. Your agent monitors comments using `list_comments` and lets you respond immediately with `reply_comment`. - Get beyond simple follower counts. The `get_audience_analytics` tool provides demographic breakdowns, telling you exactly who your viewers are. - Keep track of everything. You can use `list_videos` to get a full inventory of your uploaded content at a glance. - Research the competition or new topics using `search_videos` to find trending public content on Douyin. ## How It Works The bottom line is your AI client talks to Douyin directly for you, making content analytics feel like a simple chat conversation. 1. Start by giving your AI agent a command, like 'Show me the performance data for my last video.' 2. The MCP translates that request into API calls, pulling metrics on views and engagement from Douyin's platform. 3. Your agent formats the raw data into plain English and gives you an answer—no spreadsheets or JSON required. ## Frequently Asked Questions **How do I use `list_videos` to see my uploaded content?** `list_videos` shows all the videos you personally posted. Just ask your agent to list them, and it'll give you a complete inventory of what’s on your account. **Can I reply to comments using `reply_comment`?** Yes, `reply_comment` lets your agent send replies to specific video comments. You just need to identify the comment and tell the agent what you want to say. **What is the difference between `list_fans` and `get_audience_analytics`?** `list_fans` just gives a roster of who follows you. `get_audience_analytics` does more; it takes that list and analyzes it to give you demographic details, like age ranges. **How do I search for videos using `search_videos`?** `search_videos` lets your agent look across the public Douyin feed. Just provide a keyword or topic, and it returns trending content examples you can use as inspiration. **If I want to use `get_video_analytics`, what scope do my credentials need?** You must apply for the required data scopes, such as `video.data`. These permissions authorize your agent to pull detailed viewing and engagement metrics for specific video IDs. **How should I handle rate limits when running `list_comments`?** The platform enforces standard API rate limits. If you receive a 429 status code, your client needs to implement exponential backoff logic and pause between requests. **What specific details does the `list_following` tool return?** It returns a list of user IDs and their associated usernames. This tool tracks who you follow but doesn't provide detailed profile information or follower counts for those accounts. **How do I filter data when using `get_live_analytics`?** You must provide a specific start and end timestamp in the request. This allows your agent to narrow down historical streaming metrics to precise date ranges or time periods. **Can my AI automatically reply to comments on specific videos?** Yes! Use the `reply_comment` tool with the video's `item_id` and the specific `comment_id`. Your agent will send the text reply directly to the Douyin platform. **How do I obtain the 'open_id' for a user?** The `open_id` is a unique identifier for a user within your application. It is typically returned along with the `access_token` during the standard Douyin OAuth 2.0 authorization process. **Can I search for trending videos using this MCP?** Yes! Use the `search_videos` tool with specific keywords. Your agent will return a list of public videos matching your query, along with their metadata and statistics.