# PostToData

> PostToData is a read-only social media data API and MCP server. It returns public posts, comment threads, profiles, public ad creatives, and available YouTube and TikTok captions with source links where available.

## Facts
- REST base URL: https://posttodata.com/v1
- MCP server (Streamable HTTP): https://posttodata.com/mcp
- Live platforms: Facebook (facebook), Pinterest (pinterest), Meta Ad Library (meta_ads), Google Ads Transparency (google_ads), Bluesky (bluesky), Hacker News (hackernews), YouTube (youtube), Reddit (reddit), X (Twitter) (x), TikTok (tiktok), Instagram (instagram), Threads (threads), Xiaohongshu (RedNote) (xiaohongshu), Douyin (douyin), Bilibili (bilibili), Weibo (weibo), Zhihu (zhihu), Kuaishou (kuaishou), LinkedIn (linkedin), Telegram (telegram), WeChat Official Accounts (wechat_mp), WeChat Channels (wechat_channels), WeChat Search (wechat_search)
- Actions (vary by platform): answers, search, trending, post, comments, user, user_posts, transcript
- Authentication: REST uses a Bearer API key. MCP accepts a Bearer API key or OAuth in compatible clients such as Claude and ChatGPT.
- Trial: one verified website trial per network and device. Eligible new accounts receive $0.05 of trial credit once per network.
- Price on a paid key: Facebook from $0.006 per call; Pinterest from $0.006 per call; Meta Ad Library from $0.006 per call; Google Ads Transparency from $0.006 per call; Bluesky from $0.001 per call; Hacker News from $0.001 per call; YouTube from $0.003 per call; Reddit from $0.003 per call; X (Twitter) from $0.003 per call; TikTok from $0.003 per call; Instagram from $0.006 per call; Threads from $0.006 per call; Xiaohongshu (RedNote) from $0.03 per call; Douyin from $0.003 per call; Bilibili from $0.003 per call; Weibo from $0.003 per call; Zhihu from $0.003 per call; Kuaishou from $0.003 per call; LinkedIn from $0.024 per call; Telegram from $0.003 per call; WeChat Official Accounts from $0.03 per call; WeChat Channels from $0.03 per call; WeChat Search from $0.03 per call (a few actions cost more; see prices.json). Create keys and add prepaid credit in /dashboard.
- Billing: charged only when a call returns HTTP 200. Errors and timeouts are free. Add dry_run=1 to get the price without running the call.
- Formats: compact, standard, full, markdown (text/markdown, smallest for model context).
- Updated: 2026-11-13

## Endpoints
URL pattern: GET https://posttodata.com/v1/{platform}/{action}

- answers: Read a bounded page of public answers to one question, with source links. Parameters: id (required), limit.
- search: Find public posts that match a query. Parameters: query (required), sort, limit, cursor.
- trending: What is popular on the platform right now. Parameters: limit, cursor.
- post: One post by ID or URL, with full text and metrics. Parameters: id (required).
- comments: The replies under one post, flattened with depth. Parameters: id (required), limit.
- user: A public account: name, bio and counts. Parameters: username (required).
- user_posts: Recent public posts from one account. Parameters: username (required), limit, cursor.
- transcript: The full spoken text of one video, with a timestamp for every line. Parameters: id (required), lang.

Every call also accepts format, dry_run and max_price_usd. Set max_price_usd (REST or MCP) or X-Max-Price (REST header) to a non-negative USD decimal. A price above either limit returns HTTP 412 price_limit_exceeded before any upstream request or charge. Limits apply to each call; callers must also bound the number of calls.

## Platform-specific inputs and limits
- facebook: Search returns public videos/Reels only, not text/photo-post search. Profiles use a page handle or full Facebook URL. Post/comments require a full public URL. User posts return at most 3 items; comments use the source’s relevant view. One page per call; no transcription.
- pinterest: Search pins by keywords; details require a numeric pin ID or pinterest.com/pin/ URL. Image-only pins can have no text. One page per call; profiles and comments are not enabled.
- meta_ads: Search takes a company name and returns a bounded page of active ads across countries. Detail takes an ad archive ID or Meta Ad Library URL. No automatic pagination or transcription; public creatives do not establish spend, conversions or ROI.
- google_ads: Search requires a company domain such as nike.com, not keywords. Detail requires a full adstransparency.google.com advertiser/creative URL. Lists never auto-expand details. Dates may be null; detail OCR is best-effort. No campaign performance or login-only ads.
- bilibili: Profiles require a numeric UID. Videos accept BV IDs. One page per call.
- weibo: Profiles require a numeric UID. Search returns realtime results; top ordering is unavailable.
- zhihu: Search and question answers are enabled. Answers require a question ID or /question/ URL, default source order, up to 20 items on the first page. Details, comments and profiles remain unavailable.
- kuaishou: Use a public account ID, not a display name. Search uses relevance order. One page per call.
- linkedin: Post detail requires a complete LinkedIn /posts/ or /pulse/ URL. Comments accept an activity ID. Profile posts and comments cost $0.15 per call. No pagination.
- telegram: Public channels only. Use a channel handle for profiles, and channel/message_id for posts. Maximum 20 messages per call.
- wechat_mp: Profiles require the account username. Article detail requires a complete mp.weixin.qq.com URL. One page per call.
- wechat_channels: Search first and pass its export/ ID to post detail. Profiles require a v2_…@finder username. Video source URLs and reliable view/follower counts are unavailable. Comments are not enabled.
- wechat_search: Search public articles and videos in relevance order. Video results may have no public HTTP source URL. One page per call.

## Examples
Live data calls use the key as a header. dry_run=1 is a free price preview.
- curl -H "Authorization: Bearer $POSTTODATA_API_KEY" "https://posttodata.com/v1/reddit/search?query=standing+desk&format=markdown"
- curl -H "Authorization: Bearer $POSTTODATA_API_KEY" "https://posttodata.com/v1/tiktok/search?query=pour+over+coffee&limit=10&format=compact"
- curl -H "Authorization: Bearer $POSTTODATA_API_KEY" "https://posttodata.com/v1/hackernews/comments?id=44404905&limit=20&format=compact"
- curl "https://posttodata.com/v1/youtube/search?query=pour+over+coffee&dry_run=1"

## Response shape
{ "data": { "items": [ { "id", "type", "url", "title", "text", "author", "metrics", "published_at", "lang", "media" } ] }, "page": { "next_cursor", "has_more" }, "meta": { "platform", "action", "source_url", "approx_tokens", "unavailable", "billing" } }

A field a platform cannot provide is null and is named in meta.unavailable.

## Connect an AI client
- Claude Code: claude mcp add --transport http posttodata https://posttodata.com/mcp --header "Authorization: Bearer $POSTTODATA_API_KEY"
- Cursor (.cursor/mcp.json): {"mcpServers":{"posttodata":{"url":"https://posttodata.com/mcp","headers":{"Authorization":"Bearer YOUR_API_KEY"}}}}
- Claude (web or desktop) and ChatGPT: add https://posttodata.com/mcp as a custom connector and sign in with OAuth (Google). No key to paste.
- Codex, Google Antigravity IDE and Gemini API: see the [client-specific configuration guide](https://posttodata.com/en/integrations).
- Any other client: add https://posttodata.com/mcp as a remote Streamable HTTP server with the same Authorization header, or let it sign in with OAuth (metadata at https://posttodata.com/.well-known/oauth-protected-resource/mcp).
- MCP tools: get_answers, search_posts, get_trending, get_post, get_comments, get_user, get_user_posts, get_transcript, get_account, list_platforms

## Workflows and skills

- [Ad creative research](https://posttodata.com/en/workflows/ad-library-search): one bounded Meta company-name or Google company-domain lookup; preserve creative dates and sources, never invent spend or ROI.
- [Runnable workflows and downloadable AI skills](https://posttodata.com/en/workflows)
- [中文工作流与 Skills](https://posttodata.com/zh-CN/workflows)
- [Brand mentions](https://posttodata.com/en/workflows/brand-mentions)
- [Comment research](https://posttodata.com/en/workflows/comment-research)
- [Creator review](https://posttodata.com/en/workflows/creator-review)
- [Competitor posts](https://posttodata.com/en/workflows/competitor-posts)
- [Trend snapshot](https://posttodata.com/en/workflows/trend-snapshot)
- [Batch post lookup](https://posttodata.com/en/workflows/batch-posts)
- [Video transcripts](https://posttodata.com/en/workflows/video-transcripts)
Each workflow has a free downloadable Markdown skill at /api/skills/{workflow-id}. Workbench previews are free; running requires a signed-in account and credit. Maximum five calls per run, no automatic retries or pagination.

## Task-based selection guides

- [Xiaohongshu & Douyin API: pay as you go, no cookies](https://posttodata.com/en/guides/xiaohongshu-douyin-api-no-cookies) · [中文](https://posttodata.com/zh-CN/guides/xiaohongshu-douyin-api-no-cookies): Search RedNote and Douyin without supplying social-account cookies. Compare per-call prices, keyword inputs, returned fields and a two-call budget.
- [YouTube transcript & comments API: captions and cost](https://posttodata.com/en/guides/youtube-transcript-comments-api) · [中文](https://posttodata.com/zh-CN/guides/youtube-transcript-comments-api): Retrieve available YouTube captions and a bounded comment sample with REST or MCP. Check transcript languages, timestamps, failures and exact call prices.
- [Meta Ad Library & Google Ads Transparency API](https://posttodata.com/en/guides/meta-google-ad-library-api) · [中文](https://posttodata.com/zh-CN/guides/meta-google-ad-library-api): Research public Meta and Google ad creatives through REST and MCP. Compare brand-name vs company-domain search, per-call pricing and missing performance metrics.
- [Zhihu API coverage: search vs question answers](https://posttodata.com/en/guides/zhihu-api-coverage) · [中文](https://posttodata.com/zh-CN/guides/zhihu-api-coverage): Check which Zhihu operations are enabled: keyword search and question answers, with per-call pricing. Details, comments and profiles are not advertised as live.

## Operation reference

[API reference](https://posttodata.com/en/reference): one page per implemented operation, including exact inputs, price, cURL, Python, JavaScript, MCP and limitations. [中文接口参考](https://posttodata.com/zh-CN/reference).

- [Facebook Search videos](https://posttodata.com/en/reference/facebook/search): parameters, code and $0.006 per successful call.
- [Facebook Post detail](https://posttodata.com/en/reference/facebook/post): parameters, code and $0.006 per successful call.
- [Facebook Comments](https://posttodata.com/en/reference/facebook/comments): parameters, code and $0.006 per successful call.
- [Facebook User profile](https://posttodata.com/en/reference/facebook/user): parameters, code and $0.006 per successful call.
- [Facebook User posts](https://posttodata.com/en/reference/facebook/user_posts): parameters, code and $0.006 per successful call.
- [Pinterest Search posts](https://posttodata.com/en/reference/pinterest/search): parameters, code and $0.006 per successful call.
- [Pinterest Post detail](https://posttodata.com/en/reference/pinterest/post): parameters, code and $0.006 per successful call.
- [Meta Ad Library Search ads](https://posttodata.com/en/reference/meta_ads/search): parameters, code and $0.006 per successful call.
- [Meta Ad Library Ad details](https://posttodata.com/en/reference/meta_ads/post): parameters, code and $0.006 per successful call.
- [Google Ads Transparency Search ads](https://posttodata.com/en/reference/google_ads/search): parameters, code and $0.006 per successful call.
- [Google Ads Transparency Ad details](https://posttodata.com/en/reference/google_ads/post): parameters, code and $0.006 per successful call.
- [Bluesky Search posts](https://posttodata.com/en/reference/bluesky/search): parameters, code and $0.001 per successful call.
- [Bluesky Trending](https://posttodata.com/en/reference/bluesky/trending): parameters, code and $0.001 per successful call.
- [Bluesky Post detail](https://posttodata.com/en/reference/bluesky/post): parameters, code and $0.001 per successful call.
- [Bluesky Comments](https://posttodata.com/en/reference/bluesky/comments): parameters, code and $0.001 per successful call.
- [Bluesky User profile](https://posttodata.com/en/reference/bluesky/user): parameters, code and $0.001 per successful call.
- [Bluesky User posts](https://posttodata.com/en/reference/bluesky/user_posts): parameters, code and $0.001 per successful call.
- [Hacker News Search posts](https://posttodata.com/en/reference/hackernews/search): parameters, code and $0.001 per successful call.
- [Hacker News Trending](https://posttodata.com/en/reference/hackernews/trending): parameters, code and $0.001 per successful call.
- [Hacker News Post detail](https://posttodata.com/en/reference/hackernews/post): parameters, code and $0.001 per successful call.
- [Hacker News Comments](https://posttodata.com/en/reference/hackernews/comments): parameters, code and $0.001 per successful call.
- [Hacker News User profile](https://posttodata.com/en/reference/hackernews/user): parameters, code and $0.001 per successful call.
- [Hacker News User posts](https://posttodata.com/en/reference/hackernews/user_posts): parameters, code and $0.001 per successful call.
- [YouTube Search posts](https://posttodata.com/en/reference/youtube/search): parameters, code and $0.006 per successful call.
- [YouTube Post detail](https://posttodata.com/en/reference/youtube/post): parameters, code and $0.003 per successful call.
- [YouTube Comments](https://posttodata.com/en/reference/youtube/comments): parameters, code and $0.003 per successful call.
- [YouTube User profile](https://posttodata.com/en/reference/youtube/user): parameters, code and $0.006 per successful call.
- [YouTube User posts](https://posttodata.com/en/reference/youtube/user_posts): parameters, code and $0.006 per successful call.
- [YouTube Transcript](https://posttodata.com/en/reference/youtube/transcript): parameters, code and $0.003 per successful call.
- [Reddit Search posts](https://posttodata.com/en/reference/reddit/search): parameters, code and $0.003 per successful call.
- [Reddit Trending](https://posttodata.com/en/reference/reddit/trending): parameters, code and $0.003 per successful call.
- [Reddit Post detail](https://posttodata.com/en/reference/reddit/post): parameters, code and $0.003 per successful call.
- [Reddit Comments](https://posttodata.com/en/reference/reddit/comments): parameters, code and $0.003 per successful call.
- [Reddit User profile](https://posttodata.com/en/reference/reddit/user): parameters, code and $0.003 per successful call.
- [Reddit User posts](https://posttodata.com/en/reference/reddit/user_posts): parameters, code and $0.003 per successful call.
- [X (Twitter) Search posts](https://posttodata.com/en/reference/x/search): parameters, code and $0.003 per successful call.
- [X (Twitter) Post detail](https://posttodata.com/en/reference/x/post): parameters, code and $0.003 per successful call.
- [X (Twitter) Comments](https://posttodata.com/en/reference/x/comments): parameters, code and $0.003 per successful call.
- [X (Twitter) User profile](https://posttodata.com/en/reference/x/user): parameters, code and $0.003 per successful call.
- [X (Twitter) User posts](https://posttodata.com/en/reference/x/user_posts): parameters, code and $0.003 per successful call.
- [TikTok Search posts](https://posttodata.com/en/reference/tiktok/search): parameters, code and $0.003 per successful call.
- [TikTok Post detail](https://posttodata.com/en/reference/tiktok/post): parameters, code and $0.003 per successful call.
- [TikTok Comments](https://posttodata.com/en/reference/tiktok/comments): parameters, code and $0.003 per successful call.
- [TikTok User profile](https://posttodata.com/en/reference/tiktok/user): parameters, code and $0.003 per successful call.
- [TikTok User posts](https://posttodata.com/en/reference/tiktok/user_posts): parameters, code and $0.003 per successful call.
- [TikTok Transcript](https://posttodata.com/en/reference/tiktok/transcript): parameters, code and $0.003 per successful call.
- [Instagram Search posts](https://posttodata.com/en/reference/instagram/search): parameters, code and $0.006 per successful call.
- [Instagram Post detail](https://posttodata.com/en/reference/instagram/post): parameters, code and $0.006 per successful call.
- [Instagram Comments](https://posttodata.com/en/reference/instagram/comments): parameters, code and $0.006 per successful call.
- [Instagram User profile](https://posttodata.com/en/reference/instagram/user): parameters, code and $0.006 per successful call.
- [Instagram User posts](https://posttodata.com/en/reference/instagram/user_posts): parameters, code and $0.006 per successful call.
- [Threads Search posts](https://posttodata.com/en/reference/threads/search): parameters, code and $0.006 per successful call.
- [Threads Post detail](https://posttodata.com/en/reference/threads/post): parameters, code and $0.006 per successful call.
- [Threads Comments](https://posttodata.com/en/reference/threads/comments): parameters, code and $0.006 per successful call.
- [Threads User profile](https://posttodata.com/en/reference/threads/user): parameters, code and $0.006 per successful call.
- [Threads User posts](https://posttodata.com/en/reference/threads/user_posts): parameters, code and $0.012 per successful call.
- [Xiaohongshu (RedNote) Search posts](https://posttodata.com/en/reference/xiaohongshu/search): parameters, code and $0.03 per successful call.
- [Xiaohongshu (RedNote) Post detail](https://posttodata.com/en/reference/xiaohongshu/post): parameters, code and $0.06 per successful call.
- [Xiaohongshu (RedNote) Comments](https://posttodata.com/en/reference/xiaohongshu/comments): parameters, code and $0.03 per successful call.
- [Xiaohongshu (RedNote) User profile](https://posttodata.com/en/reference/xiaohongshu/user): parameters, code and $0.03 per successful call.
- [Xiaohongshu (RedNote) User posts](https://posttodata.com/en/reference/xiaohongshu/user_posts): parameters, code and $0.03 per successful call.
- [Douyin Search posts](https://posttodata.com/en/reference/douyin/search): parameters, code and $0.03 per successful call.
- [Douyin Trending](https://posttodata.com/en/reference/douyin/trending): parameters, code and $0.003 per successful call.
- [Douyin Post detail](https://posttodata.com/en/reference/douyin/post): parameters, code and $0.003 per successful call.
- [Douyin Comments](https://posttodata.com/en/reference/douyin/comments): parameters, code and $0.003 per successful call.
- [Douyin User profile](https://posttodata.com/en/reference/douyin/user): parameters, code and $0.003 per successful call.
- [Douyin User posts](https://posttodata.com/en/reference/douyin/user_posts): parameters, code and $0.006 per successful call.
- [Bilibili Search posts](https://posttodata.com/en/reference/bilibili/search): parameters, code and $0.003 per successful call.
- [Bilibili Trending](https://posttodata.com/en/reference/bilibili/trending): parameters, code and $0.003 per successful call.
- [Bilibili Post detail](https://posttodata.com/en/reference/bilibili/post): parameters, code and $0.003 per successful call.
- [Bilibili Comments](https://posttodata.com/en/reference/bilibili/comments): parameters, code and $0.003 per successful call.
- [Bilibili User profile](https://posttodata.com/en/reference/bilibili/user): parameters, code and $0.003 per successful call.
- [Bilibili User posts](https://posttodata.com/en/reference/bilibili/user_posts): parameters, code and $0.003 per successful call.
- [Weibo Search posts](https://posttodata.com/en/reference/weibo/search): parameters, code and $0.003 per successful call.
- [Weibo Trending](https://posttodata.com/en/reference/weibo/trending): parameters, code and $0.003 per successful call.
- [Weibo Post detail](https://posttodata.com/en/reference/weibo/post): parameters, code and $0.003 per successful call.
- [Weibo Comments](https://posttodata.com/en/reference/weibo/comments): parameters, code and $0.003 per successful call.
- [Weibo User profile](https://posttodata.com/en/reference/weibo/user): parameters, code and $0.003 per successful call.
- [Weibo User posts](https://posttodata.com/en/reference/weibo/user_posts): parameters, code and $0.003 per successful call.
- [Zhihu Search posts](https://posttodata.com/en/reference/zhihu/search): parameters, code and $0.003 per successful call.
- [Zhihu Question answers](https://posttodata.com/en/reference/zhihu/answers): parameters, code and $0.003 per successful call.
- [Kuaishou Search posts](https://posttodata.com/en/reference/kuaishou/search): parameters, code and $0.03 per successful call.
- [Kuaishou Post detail](https://posttodata.com/en/reference/kuaishou/post): parameters, code and $0.003 per successful call.
- [Kuaishou Comments](https://posttodata.com/en/reference/kuaishou/comments): parameters, code and $0.003 per successful call.
- [Kuaishou User profile](https://posttodata.com/en/reference/kuaishou/user): parameters, code and $0.03 per successful call.
- [Kuaishou User posts](https://posttodata.com/en/reference/kuaishou/user_posts): parameters, code and $0.03 per successful call.
- [LinkedIn Post detail](https://posttodata.com/en/reference/linkedin/post): parameters, code and $0.024 per successful call.
- [LinkedIn Comments](https://posttodata.com/en/reference/linkedin/comments): parameters, code and $0.15 per successful call.
- [LinkedIn User profile](https://posttodata.com/en/reference/linkedin/user): parameters, code and $0.024 per successful call.
- [LinkedIn User posts](https://posttodata.com/en/reference/linkedin/user_posts): parameters, code and $0.15 per successful call.
- [Telegram Post detail](https://posttodata.com/en/reference/telegram/post): parameters, code and $0.003 per successful call.
- [Telegram User profile](https://posttodata.com/en/reference/telegram/user): parameters, code and $0.003 per successful call.
- [Telegram User posts](https://posttodata.com/en/reference/telegram/user_posts): parameters, code and $0.003 per successful call.
- [WeChat Official Accounts Search posts](https://posttodata.com/en/reference/wechat_mp/search): parameters, code and $0.03 per successful call.
- [WeChat Official Accounts Post detail](https://posttodata.com/en/reference/wechat_mp/post): parameters, code and $0.03 per successful call.
- [WeChat Official Accounts User profile](https://posttodata.com/en/reference/wechat_mp/user): parameters, code and $0.03 per successful call.
- [WeChat Official Accounts User posts](https://posttodata.com/en/reference/wechat_mp/user_posts): parameters, code and $0.03 per successful call.
- [WeChat Channels Search posts](https://posttodata.com/en/reference/wechat_channels/search): parameters, code and $0.03 per successful call.
- [WeChat Channels Post detail](https://posttodata.com/en/reference/wechat_channels/post): parameters, code and $0.03 per successful call.
- [WeChat Channels User profile](https://posttodata.com/en/reference/wechat_channels/user): parameters, code and $0.03 per successful call.
- [WeChat Channels User posts](https://posttodata.com/en/reference/wechat_channels/user_posts): parameters, code and $0.03 per successful call.
- [WeChat Search Search posts](https://posttodata.com/en/reference/wechat_search/search): parameters, code and $0.03 per successful call.

## Links
- [ChatGPT: Reddit and X with OAuth](https://posttodata.com/en/connect/chatgpt)
- [Claude: social media connector](https://posttodata.com/en/connect/claude)
- [Gemini CLI: Streamable HTTP setup](https://posttodata.com/en/connect/gemini)
- [Grok API: remote MCP integration](https://posttodata.com/en/connect/grok)
- [AI integration guide](https://posttodata.com/en/integrations)
- [AI 接入指南](https://posttodata.com/zh-CN/integrations)
- [Questions and runnable examples](https://posttodata.com/en/answers)
- [Claude + Reddit + TikTok workflow](https://posttodata.com/en/answers/claude-reddit-tiktok)
- [Xiaohongshu + Douyin workflow](https://posttodata.com/en/answers/xiaohongshu-douyin-mcp)
- [Provider comparisons](https://posttodata.com/en/compare)
- [Pricing](https://posttodata.com/en/pricing)
- [Docs](https://posttodata.com/en/docs)
- [Set up in an AI agent](https://posttodata.com/agents.md)
- [OpenAPI](https://posttodata.com/openapi.json)
- [Prices](https://posttodata.com/prices.json)
- [Capabilities, live](https://posttodata.com/v1)
- [Status](https://posttodata.com/status)
- [Playground](https://posttodata.com/playground)