> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.beatapi.io/guides/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server. # Guides > Find a BeatAPI guide for monitoring social posts, reading articles, verifying sources or using model results in an application. BeatAPI is the unified capability layer for AI agents (AI models, Social Data, SEO Data, Web Search, and composed workflows through one API key). Find the outcome you need in the **Start with a task** table and open the BeatAPI guide in the same row. Each guide runs from the first input to a verifiable result you can hand off to an AI agent or application. For client setup, request fields or troubleshooting, use **Set up, call or troubleshoot**. ## Start with a task | What you want to do | Follow this guide | | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | Find Xiaohongshu notes with an AI agent | [Search one page and check the sources](/guides/search-xiaohongshu-notes) | | Turn video comments into product feedback | [Review questions in Douyin comments](/guides/douyin-video-comments) or [group product concerns on TikTok](/guides/tiktok-video-comments) | | Save a WeChat article | [Produce a text record in n8n](/guides/wechat-n8n-read) or [keep it in Obsidian with your notes](/guides/wechat-to-obsidian) | | Route brand feedback to your support team | [Send selected X posts to Slack](/guides/x-brand-alerts-slack) | | Verify a claim or pick an article topic | [Check a source on the web](/guides/web) or [compare keyword demand and ranking pages](/guides/seo) | | Put a model result into an application | [Return structured text or retrieve a finished image](/guides/models) | [Browse all guides](/guides/platforms) ## Set up, call or troubleshoot * To connect a tool you already use, start with [Integrations](/integrations) or [pick a workflow by tool](/integrations/social-data-workflows). * For request fields and response formats, open the [Capabilities API](/capabilities) or the [Social Data API](/social-data). * If a result is missing, incomplete or hard to interpret, [find the answer by platform](/faq/questions). See [Answers](/faq) for connection, account and billing questions. ## Docs - [How do I find X feedback after a product launch and build a follow-up list?](https://docs.beatapi.io/guides/x-search-posts.md): Start with a product or event question, screen relevant X posts, verify missing context, and hand over source-backed leads with a clear sample scope. - [How do I use X country trends to decide which topics are worth covering?](https://docs.beatapi.io/guides/x-country-trends.md): Start with a target market, investigate selected trends through actual posts, and hand over an editorial brief with sources, relevance and unresolved checks. - [How do I turn X product feedback into work that support and product teams can act on?](https://docs.beatapi.io/guides/x-brand-mentions.md): Verify relevance, exact statements and context before assigning support, feature and unresolved leads, retaining exclusions and explicit next actions. - [How do I find questions to answer or verify in replies to an X announcement?](https://docs.beatapi.io/guides/x-post-replies.md): Check exact reply statements against the announcement, distinguish answered and unresolved questions, and keep missing context visible within a bounded reading workflow. - [What changed on a peer's X account, and which newly observed posts deserve follow-up?](https://docs.beatapi.io/guides/x-account-updates.md): Monitor a public X account by saving page one of twitter.web.fetch_user_post_tweet as a baseline, diffing later pages with watch_account.py, and reporting newly observed posts with homepage-only coverage limits. - [Send X brand feedback worth following up to Slack](https://docs.beatapi.io/guides/x-brand-alerts-slack.md): Search X using n8n, Make or Zapier, triage relevant posts and notify a Slack channel. - [What are viewers asking or worrying about under a TikTok product video?](https://docs.beatapi.io/guides/tiktok-video-comments.md): Select relevant product videos, review exact comments and reply context, and build a human research checklist while preserving the unverified automatic-export boundary. - [What evidence should I give AI to review TikTok video performance?](https://docs.beatapi.io/guides/tiktok-share-metrics.md): Preserve selected videos' descriptions and metric snapshots with sources and missing states before AI-assisted comparison, without claiming the model watched videos or read comments. - [How do I turn TikTok Shop product searches and buyer reviews into useful product questions?](https://docs.beatapi.io/guides/tiktok-shop-review-research.md): Fix product and market, read selected reviews, separate variants, usage and delivery, then hand off sourced questions and positive experiences. - [Review TikTok speech from captions](https://docs.beatapi.io/guides/tiktok-review-spoken-content.md): Match a TikTok tutorial by video ID, then quote its speech from captions or a transcript with timestamps, translation and the video link. - [Find unanswered buyer questions in YouTube review comments](https://docs.beatapi.io/guides/youtube-review-questions.md): Read comments under a YouTube product review, separate recent questions from popular reactions, and produce a source-backed FAQ backlog without claiming a representative survey. - [Instagram guides](https://docs.beatapi.io/guides/instagram.md): Find event posts by hashtag, venue and date, then select comments and potential creators. - [How do I compare engagement changes between two observations of an Instagram campaign post?](https://docs.beatapi.io/guides/instagram-post-snapshot.md): Save two observations of the same post or Reel, compare net changes and retain actual observation times, missing values and sources. - [Which product-launch Reel questions have answers, and how do I check their replies?](https://docs.beatapi.io/guides/instagram-comment-export.md): Preserve product questions, read selected reply threads and deliver evidence-backed answered, context-needed and no-answer-observed review records. - [How do I build an Instagram creator shortlist with content evidence?](https://docs.beatapi.io/guides/instagram-creator-shortlist.md): Define the collaboration brief, discover candidates from a seed and review recent content, evidence and open questions before selecting a shortlist. - [Reddit guides](https://docs.beatapi.io/guides/reddit.md): Choose a Reddit task by the input you have, select discussions from community feeds, export a post's comments with reply context, or follow one problem in new posts each day. - [How do I turn a Reddit discussion into product questions backed by original comments?](https://docs.beatapi.io/guides/reddit-comment-export.md): Read selected threads, retain reply relationships and repeated observations, then review excerpts and deliver questions, conditions and next actions. - [How do I select useful Reddit product discussions before reading comments?](https://docs.beatapi.io/guides/reddit-community-shortlist.md): Choose communities for a product question, review new posts and record selection reasons before spending comment retrieval on relevant threads. - [LinkedIn guides](https://docs.beatapi.io/guides/linkedin.md): Read public company updates and job requirements to prepare source-linked interview questions. - [Search recent remote LinkedIn jobs and save traceable results](https://docs.beatapi.io/guides/linkedin-job-search.md): Search one page of recent remote LinkedIn jobs with linkedin.web_v2.search_jobs, archive the response with save_jobs.py and export a reviewed jobs.csv. - [Threads guides](https://docs.beatapi.io/guides/threads.md): Archive a Threads post and compare recent and top search results for launch feedback. - [Read a Threads post link and save a traceable original record](https://docs.beatapi.io/guides/threads-post-archive.md): Fetch a Threads post URL with threads.web.fetch_post_detail_v2, archive raw data and SHA-256 provenance with archive_post.py, and split role files and main-post-metrics.csv with split_thread.py. - [Telegram guides](https://docs.beatapi.io/guides/telegram.md): Find older channel notices and select traceable sources for a weekly brief. - [Archive a bounded batch of Telegram channel messages](https://docs.beatapi.io/guides/telegram-channel-archive.md): Re-check one Telegram announcement with telegram.web.fetch_post_detail, or archive a bounded batch of channel messages with telegram.web.fetch_channel_posts and a traceable evidence bundle. - [Lemon8 guides](https://docs.beatapi.io/guides/lemon8.md): Resolve the link from a share message, confirm comment identifiers and use audience questions in a filming brief. - [How do I search recent Lemon8 videos and archive one traceable result page?](https://docs.beatapi.io/guides/lemon8-search-archive.md): Query recent Lemon8 videos with lemon8.app.fetch_search (main, video, recent), validate and archive raw data with archive_search.py, and link each shortlisted row to its archive file and request ID. - [Search Xiaohongshu notes with your AI](https://docs.beatapi.io/guides/search-xiaohongshu-notes.md): Find a search capability, check its inputs and price, then retrieve one page of notes. This guide stops after one search; it does not collect comments or export every result. - [How do I find useful Xiaohongshu posts for my next content brief?](https://docs.beatapi.io/guides/xiaohongshu-notes-research.md): Start with a specific content question, screen one page of results, retrieve detail descriptions only for selected posts, and deliver a table with clear selection reasons. - [How do I turn a Xiaohongshu keyword into a content brief supported by real discussion?](https://docs.beatapi.io/guides/xiaohongshu-keyword-research.md): Turn a Xiaohongshu seed keyword into an auditable editorial brief using xiaohongshu.pgy.get_keyword_related, get_keyword_daily, xiaohongshu.app_v2.search_notes, reviewed comments, and build_briefs.py. - [Use Python to find Xiaohongshu notes, read selected comments and organize product questions](https://docs.beatapi.io/guides/xiaohongshu-python-research.md): Save a search and selected comment responses with the standard library, then use existing CSV and excerpt-review tools for product research. - [How do I use Xiaohongshu comments to study product difficulties and buying questions?](https://docs.beatapi.io/guides/xiaohongshu-note-comments.md): Collect Xiaohongshu top-level comments with xiaohongshu.app_v2.get_note_comments, expand chosen threads with get_note_sub_comments, deduplicate and verify quotes via comment_research.py, and bridge AI proposals safely with ai_review_bridge.py. - [How do I shortlist Xiaohongshu creators and review their audience and recent cooperation?](https://docs.beatapi.io/guides/xiaohongshu-creator-shortlist.md): Build a Xiaohongshu creator shortlist with xiaohongshu.pgy.get_blogger_list, export deduplicated userId rows via pgy_candidates.py, and attach profiles, audiences, cooperation cases, and performance metrics only to shortlisted creators. - [How do I collect Xiaohongshu campaign results and explain them to a client?](https://docs.beatapi.io/guides/xiaohongshu-note-metrics.md): Follow a fixed campaign roster across agreed observation windows, deliver public-engagement snapshots and changes, and explain missing coverage before performance. - [How can I build an Excel inventory of a Xiaohongshu creator’s notes?](https://docs.beatapi.io/guides/xiaohongshu-creator-note-inventory.md): Page through a Xiaohongshu creator's notes with xiaohongshu.app_v2.get_user_posted_notes, write one spreadsheet row per note, and report saved pages, coverage and the stop reason. - [How can Xiaohongshu product research surface improvements worth testing?](https://docs.beatapi.io/guides/xiaohongshu-product-review-research.md): Search Xiaohongshu products, read buyer reviews for comparable SKUs, then check note discussions to turn complaints into product questions worth testing. - [Where to get Xiaohongshu notes, comments and account data](https://docs.beatapi.io/guides/xiaohongshu-data-access.md): Choose an entry point for owned accounts, campaign results or public research, then verify a first batch. - [How can I find Xiaohongshu notes in n8n and hand selected records to Feishu?](https://docs.beatapi.io/guides/xiaohongshu-note-workflow-handoff.md): Search Xiaohongshu notes from an n8n HTTP Request step, keep a reviewed queue in a Data Table, and update approved notes in a Feishu table by note ID. - [Which Douyin product-video comments reveal questions, and which need verification?](https://docs.beatapi.io/guides/douyin-video-comments.md): Select relevant videos, separate questions and experiences from engagement and corrections, and preserve evidence and context within a bounded review. - [Save Douyin share-link details and engagement to CSV](https://docs.beatapi.io/guides/douyin-share-snapshot.md): Export real detail fields while preserving missing metrics. - [How do I organize a Douyin creator's posts and choose cases worth studying?](https://docs.beatapi.io/guides/douyin-creator-post-export.md): Fix the creator and research purpose, build a traceable post table, and review coverage and post age before selecting cases without claiming complete history. - [How do I select Douyin Xingtu creators before comparing collaboration quotations?](https://docs.beatapi.io/guides/douyin-creator-collaboration-review.md): Start with the collaboration brief, identify creators, retrieve business cards and organize quotation formats, units, timing and open items. - [How can Python turn Douyin storage research into a sourced question list?](https://docs.beatapi.io/guides/douyin-python-research.md): Save recent video-search material with the standard library, select relevant use cases and organize comments with context and practical next steps. - [Find topic leads and review their history](https://docs.beatapi.io/guides/douyin-topic-signal-review.md): Collect Douyin search and content recommendation words, compare saved daily index data and read the underlying videos before choosing a topic. - [Where to get Douyin videos, comments and account data](https://docs.beatapi.io/guides/douyin-data-access.md): Distinguish owned analytics, app authorization and public research, then verify a first lookup. - [How do I organize an account's WeChat article history before choosing what to read?](https://docs.beatapi.io/guides/wechat-account-articles.md): Export a WeChat Official Account's article history with wechat_mp.v2.fetch_account_articles (raw=false), chain opaque next_offset cursors via wechat_history.py, and hand off state.json to daily checks. - [How do I find worthwhile new articles when checking peer WeChat accounts each day?](https://docs.beatapi.io/guides/wechat-incremental-articles.md): Run bounded daily WeChat article scans from page one via wechat_mp.v2.fetch_account_articles (raw=false), deduplicate app_msg_id:idx keys with wechat_sync.py, and separate new discoveries from metadata edits. - [How do I get evidence-backed judgments when an AI reads a WeChat article?](https://docs.beatapi.io/guides/read-wechat-article.md): Retrieve a WeChat article's plain text and save a local source record without treating a summary as the full body or executing its HTML. - [How do I research reader questions in WeChat comments using article and reply context?](https://docs.beatapi.io/guides/wechat-article-comments.md): Fetch first-level WeChat comments with wechat_mp.v2.fetch_article_comments using buffer pagination, expand selected threads via wechat_mp.v2.fetch_comment_replies using content_id and integer offset, and preserve parent-child context. - [How do I save a WeChat article to Obsidian without overwriting my notes?](https://docs.beatapi.io/guides/wechat-to-obsidian.md): Convert a verified article source record into a new Markdown file with stable naming, preserving existing notes and source metadata. - [How do I turn saved WeChat articles into RSS without fetching every body again?](https://docs.beatapi.io/guides/wechat-to-rss.md): Build a local RSS 2.0 feed.xml from saved WeChat article records with generate_rss.py, deduplicate by exact article_url, host and verify updates in a reader, and migrate safely from wewe-rss. - [How do I write a WeChat article to Feishu Base without creating duplicate records?](https://docs.beatapi.io/guides/wechat-to-feishu.md): Build a four-field Feishu Base payload from saved WeChat article records with prepare_feishu_fields.py, preview writes via lark-cli base +record-upsert --dry-run, update by --record-id, and verify via +record-get. - [How do I turn a WeChat article into a reviewable text record in n8n?](https://docs.beatapi.io/guides/wechat-n8n-read.md): Configure one HTTP Request and a validating Code node, preserve item pairing and avoid silently substituting summaries or retrying paid queries. - [How do I review WeChat campaign articles with sourced reading and interaction comparisons?](https://docs.beatapi.io/guides/wechat-article-performance-review.md): Fix article selection and observation times, preserve counts and state, reuse the exporter, and separate comparisons from material gaps. - [How can Python connect WeChat article lists and statistics for content review?](https://docs.beatapi.io/guides/wechat-python-article-review.md): Confirm an account, select relevant articles from its directory and reuse existing metric exports for a sourced content review. - [Monitor WeChat official accounts in n8n and alert a Feishu group](https://docs.beatapi.io/guides/wechat-n8n-monitor.md): Check verified WeChat official accounts on a schedule and send new titles and links to a Feishu group. - [Enrich WeChat and Xiaohongshu links in Feishu Base automatically](https://docs.beatapi.io/guides/feishu-base-social-enrichment.md): Call BeatAPI from Feishu Base and update the record that triggered the automation. - [Find new WeChat articles and import selected links into ima](https://docs.beatapi.io/guides/wechat-to-ima.md): Discover new WeChat articles, import approved links into a chosen ima knowledge base and verify each item. - [Make a WeChat RSS feed from article listings and move an existing subscription](https://docs.beatapi.io/guides/wechat-list-to-rss.md): Publish saved titles, URLs and excerpts, then verify new entries before switching your reader. - [WeChat Channels guides](https://docs.beatapi.io/guides/wechat-channels.md): Find demonstrations in account collections and past livestreams, with sources and confirmed timestamps. - [How do I find a Channels account’s product-launch videos and select examples to study?](https://docs.beatapi.io/guides/wechat-channels-channel-search.md): Choose an account and topic, review a bounded search collection and investigate selected videos for messaging patterns and unanswered questions. - [Build a Channels video inventory](https://docs.beatapi.io/guides/wechat-channels-video-inventory.md): Export a public Channels account's videos page by page with wechat_channels.v2.fetch_user_videos, then select cases from the CSV inventory. - [Review Channels video comments](https://docs.beatapi.io/guides/wechat-channels-comment-review.md): Read a Channels video's top-level comments and reply threads with wechat_channels.v2.fetch_video_comments, then deliver a list of viewer questions the team can answer. - [Channels video and comment research](https://docs.beatapi.io/guides/wechat-channels-python-research.md): Save one Channels account page and one comment page per selected video with a Python script, then turn viewer comments into sourced updates for a video tour. - [Choose a data source for WeChat Channels](https://docs.beatapi.io/guides/wechat-channels-data-access.md): Choose between owned account reports, topic discovery and account inventories, then verify the scope. - [WeChat Search guides](https://docs.beatapi.io/guides/wechat-search.md): Find WeChat material by type and filter short video demonstrations from the past week. - [How can I turn WeChat search results into useful café-opening references?](https://docs.beatapi.io/guides/wechat-topic-search.md): Define the reference task, separate articles from videos, preserve search positions and turn relevant results into a sourced reading list. - [Bilibili guides](https://docs.beatapi.io/guides/bilibili.md): Find comparable Bilibili videos, read viewer comments and replies, and turn the saved material into sourced findings. - [Use Python to find Bilibili tutorials and turn comments into course improvements](https://docs.beatapi.io/guides/bilibili-python-research.md): Save keyword searches and selected comments, choose relevant tutorials, and build a sourced teaching-improvement list. - [Weibo guides](https://docs.beatapi.io/guides/weibo.md): Compare Weibo trending boards over time and research posts and comments with sources. - [Use Python to search Weibo and turn selected comments into product questions](https://docs.beatapi.io/guides/weibo-python-research.md): Save searches and comments with the standard library, verify actual objects and fields, and hand off sourced questions with usage conditions. - [Zhihu guides](https://docs.beatapi.io/guides/zhihu.md): Compare article and answer excerpts under matching conditions, using comments for clarification. - [How do I compare answers to a Zhihu question while preserving conditions and sources?](https://docs.beatapi.io/guides/zhihu-question-archive.md): Save an initial answer batch, read relevant viewpoints and compare their conditions with excerpts, sources and clear coverage. - [Kuaishou guides](https://docs.beatapi.io/guides/kuaishou.md): Choose a Kuaishou task by the input you have, filter posts and read viewer questions, save searches and comments with Python, check a creator from a share message, or compare two chart snapshots. - [How do I select Kuaishou short tutorials and discover viewer questions?](https://docs.beatapi.io/guides/kuaishou-filtered-search.md): Narrow cooking-tutorial candidates by period, duration and ordering, then read selected comments for conditions and editorial questions. - [Use Python to research camping-equipment questions in Kuaishou comments](https://docs.beatapi.io/guides/kuaishou-python-research.md): Save search originals, select real usage situations, read comments and hand off sourced questions with conditions. - [Toutiao guides](https://docs.beatapi.io/guides/toutiao.md): Read a Toutiao article and its comments to build a traceable documentation backlog. - [How do I turn recurring brand observations across three platforms into useful follow-up?](https://docs.beatapi.io/guides/cross-platform-brand-review.md): Fix observation scope, reuse originals, distinguish first discovery from updates, and track sourced questions with conditions and next steps. - [How can I build a source-backed ad creative reference sheet?](https://docs.beatapi.io/guides/ad-creative-reference-review.md): Search TikTok ad creatives with tiktok.ads.search_ads, fetch shortlisted details with tiktok.ads.get_ads_detail, and combine Meta, LinkedIn, or Google ad library records with explicit source scope. - [How should I choose a data workflow for WeChat, Channels, Douyin or Xiaohongshu?](https://docs.beatapi.io/guides/choose-social-data-workflow.md): Match WeChat, Channels, Douyin, and Xiaohongshu tasks to authorized reports or BeatAPI public actions, and compare workflows on one small sample before scaling. - [How can an assistant or workflow retrieve actual social data?](https://docs.beatapi.io/guides/social-research-client-setup.md): Connect AI clients to BeatAPI via remote MCP at https://beatapi.io/mcp or send fixed HTTP workflows to POST https://api.beatapi.io/v1/social-data/call for verifiable social data. - [Build a Dify workflow that cites Xiaohongshu and WeChat sources](https://docs.beatapi.io/guides/dify-social-research.md): Configure an HTTP or MCP lookup in Dify and pass the returned notes and articles downstream. - [Use the Coze HTTP node to find Xiaohongshu notes or read a WeChat article](https://docs.beatapi.io/guides/coze-social-research.md): Configure Coze authentication, pass a keyword or URL, and return evidence to the next node. - [Add WeChat and Xiaohongshu research feeds to TrendRadar](https://docs.beatapi.io/guides/trendradar-social-feeds.md): Configure two curated RSS feeds and verify retrieval, filtering and reporting in TrendRadar. - [Give BettaFish a first batch of Xiaohongshu and Douyin research samples](https://docs.beatapi.io/guides/bettafish-social-data.md): Check the BettaFish database connection, map sourced Xiaohongshu and Douyin sample records, and verify InsightEngine read-back. - [Connect Claude Code, Cursor or Codex to BeatAPI social data](https://docs.beatapi.io/guides/desktop-social-research-mcp.md): Configure the remote MCP in each client, then verify its tools and collect a traceable first batch. - [Look up social sources in WorkBuddy, Doubao Work or QwenWork](https://docs.beatapi.io/guides/office-clients-social-mcp.md): Configure WorkBuddy, Doubao Work or QwenWork and verify a first batch of traceable social sources. - [Use DeepSeek with BeatAPI to verify social media evidence](https://docs.beatapi.io/guides/deepseek-social-research.md): Connect BeatAPI MCP (https://beatapi.io/mcp) to DeepSeek via DeepSeek Harness (@deepseek-ai/dsh-mcp-client) or another remote HTTP MCP host, inspect social-data actions before querying, and trace every summary finding back to a request ID and source record. - [SEO guides](https://docs.beatapi.io/guides/seo.md): Compare keyword demand in one market, find the pages that rank for the topic and hand an editor a sourced decision sheet. - [Web Search guides](https://docs.beatapi.io/guides/web.md): Verify an official announcement with Search and Read, and inventory a help center with Map. - [AI Models guides](https://docs.beatapi.io/guides/models.md): Validate structured text output before passing it to your application, and track an image task until the image file is usable. - [Creator Discovery guides](https://docs.beatapi.io/guides/creator.md): Find Instagram creators similar to a seed account, review their work and look up public contact details for the shortlist. - [Video Link Parsing guides](https://docs.beatapi.io/guides/hybrid.md): Identify the video behind a share link with hybrid.video_data, verify the post, then add details, comments or captions.