Captapi

官方

面向 AI 代理的公开社交媒体数据：来自 TikTok、Instagram、YouTube、X、Facebook、Threads、Reddit 和 LinkedIn 公司页面的个人资料、帖子、评论、转录文本和搜索，以及 Meta、Google、LinkedIn 和 TikTok 广告库。

访问 captapi.com

你可以用 Captapi MCP 做什么？

  • 获取转录文本 — 通过 URL 请求公开的 YouTube、TikTok、Instagram、Facebook 或 X 视频的转录文本。
  • 总结社交内容 — 请求对受支持平台上的视频、Reel 或帖子进行 AI 总结。
  • 拉取评论和回复 — 检索给定帖子或视频的评论或评论回复。
  • 搜索和资料查询 — 搜索帖子、用户或话题标签，并获取频道、个人资料或页面详情。
  • 比较帖子指标 — 获取一个 URL 或最多 10 个 URL 的标准化观看量、点赞数、评论数、分享数和互动率。
  • 检查账户用量 — 查询你的积分余额、请求历史或每日用量。

托管 MCP 服务器

npx add-mcp 'https://api.captapi.com/mcp'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

简介

Captapi 通过一个统一的 REST API，为你提供来自公开社交媒体的结构化数据。发送来自 YouTube、TikTok、Instagram、Facebook 等平台的公开 URL，即可获得干净的 JSON 数据——包括个人资料、帖子、转录文本、AI 摘要、评论、搜索结果和广告库数据。无需 OAuth，无需各平台 SDK，也无需维护数据采集基础设施。

  • • 一个 API 密钥即可用于全部 33 个平台。
  • • 传入 cache=true 即可从 24 小时共享缓存中提供数据（命中时消耗 0 积分）。默认始终获取最新数据。
  • • 仅对成功的请求收费。

快速开始

在注册并从控制台复制 API 密钥后，发起你的第一个请求：

curl "https://api.captapi.com/v1/youtube/transcript?url=https%3A%2F%2Fyoutube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ" \
  -H "Authorization: Bearer capt_live_..."

机器可读资源：OpenAPI 3.1 规范（参数、响应模式、错误、各端点的积分消耗）、单行端点列表以及 llms.txt。

身份验证

所有请求均使用 Bearer 令牌进行身份验证。在你的控制台中生成密钥，并通过 Authorization 请求头发送。请妥善保管密钥——切勿在客户端代码中暴露 capt_live_ 密钥。

作为 Authorization: Bearer 的替代方案，也可以将同一密钥作为 x-api-key: <key> 发送。

Authorization: Bearer capt_live_xxxxxxxxxxxxxxxxxxxx

发起请求

大多数端点接受 url 或 q 查询参数。部分端点则需要其他标识符——例如 userId、username、repo、advertiser 或 comment_id。请查看各端点的文档以了解确切的参数。构建查询字符串时，必须对 URL 值进行 URL 编码，以免被误解析为多个参数。

# URL-encode the target URL before passing it
urlencode "https://youtube.com/watch?v=dQw4w9WgXcQ"

响应格式

每个响应都是 JSON，包含顶层的 success 布尔值和 data 对象。

成功

{
  "success": true,
  "data": {
    "language": "en",
    "segments": [
      { "start": 0.0, "end": 4.12, "text": "Hey everyone, welcome back." }
    ],
    "text": "Hey everyone, welcome back."
  }
}

错误

HTTP/1.1 502 Bad Gateway
Retry-After: 60

{
  "success": false,
  "error": {
    "code": "UPSTREAM_UNAVAILABLE",
    "message": "The upstream data source failed for this request. Retry shortly.",
    "retryable": true
  }
}

响应头。 X-Captapi-Credits 表示所扣积分，X-Captapi-Cache 在缓存命中时为 1，否则为 0，X-Captapi-Request-Id 标识本次调用；联系支持时请提供该值。Server-Timing 给出请求所花费的总时间（毫秒），例如 total;dur=4387。

source 字段。 能以多种方式提供数据的端点会在 data 中包含 source：native（平台自身的页面或 API）、extended（较慢的回退路径；部分端点对此定价不同，并在其页面上注明）、cache（由 24 小时缓存提供）、captions（来自平台已发布字幕的转录文本）或 asr（由语音识别生成的转录文本）。

已弃用：timings 字段。 data 中的 timings 对象将于 2026-12-17 从响应体中移除。请改为读取 Server-Timing 响应头。

积分与缓存

积分是计费单位。费用按端点计算（参见各文档页面）——简单查询通常为 1–4 积分；许多列表/搜索/评论端点每次调用固定为 2 积分，而部分列表端点仍随结果数量变化（通常更高）。失败的请求从不收费。

空结果免费。 已执行但未找到任何内容的列表或搜索调用消耗 0 积分，例如没有匹配项的搜索、没有评论的帖子，或超出最后一页的结果。X-Captapi-Credits 响应头始终显示调用的实际费用。

少数端点在由较慢的回退路径提供服务时费用更高，例如平台自身页面无法加载时。其页面说明了规则以及我们观察到的范围：TikTok Song Details、LinkedIn Company Posts 和 TikTok Shop Products。

默认情况下，每个数据请求都会获取最新数据（cache=false）。传入 cache=true 即可从共享的 24 小时响应缓存中提供数据，消耗 0 积分。

错误

错误会返回非 2xx 状态码以及一个 error 对象，其中包含稳定的 code、人类可读的 message 和 retryable。仅当 retryable 为 true 时，在 Retry-After 响应头指定的时间之后重试。失败的请求从不收费。请精确匹配 code：不同代码的大小写不同。下表列出了常见错误；各端点页面列出了其特定代码。

状态码代码可重试含义
400BAD_REQUESTfalse参数缺失或无效，例如来自错误平台的 URL。部分端点使用更具体的代码，例如 HASHTAG_HAS_SPACES。
400plaintext_not_allowedfalseAPI 密钥通过 http://. 发送。请轮换密钥并使用 https:// 重试——重定向无法保护第一跳。
401UNAUTHORIZEDfalseAPI 密钥缺失、无效或已被撤销。
402insufficient_creditsfalse你的余额不足以完成此请求。不会扣除任何费用。
404NOT_FOUNDfalse目标资源不存在或不是公开的。部分端点会指明具体情况，例如 no_captions 或 PROFILE_NOT_FOUND。
422VALIDATION_ERRORfalse参数未通过验证。error.issues 列出每个字段。
429rate_limit_exceededtrue超出你套餐的每分钟限制。请等待 Retry-After。
502UPSTREAM_UNAVAILABLEtrue平台在处理此请求时失败。请稍后重试。
503SERVICE_UNAVAILABLEtrue暂时不可用。部分端点使用更具体的代码，例如 COMMUNITY_UNAVAILABLE。
504UPSTREAM_TIMEOUTtrue平台未及时响应。请稍后重试。

速率限制

速率限制随你的套餐而变化，并通过 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset 响应头在每次响应中返回。超出限制时，你会收到 429——请退避并在重置窗口后重试。

API 参考

36 个分组中共有 179 个端点。点击任意端点可查看完整参数、示例和常见问题。

YouTube 与 Shorts

方法端点积分描述
GET/v1/youtube/transcript1转录文本
GET/v1/youtube/audio-transcript2音频转录文本
GET/v1/youtube/summarize3摘要生成器
GET/v1/youtube/video-details1视频详情
GET/v1/youtube/comments2评论
GET/v1/youtube/channel-details1频道详情
GET/v1/youtube/search2搜索
GET/v1/youtube/channel-videos2频道视频
GET/v1/youtube/playlist-videos2播放列表视频
GET/v1/youtube/playlist1播放列表
GET/v1/youtube/shorts/transcript1Shorts 转录文本
GET/v1/youtube/shorts/summarize3Shorts 摘要生成器
GET/v1/youtube/shorts/video-details1Shorts 统计
GET/v1/youtube/shorts/comments2Shorts 评论
GET/v1/youtube/channel-shorts2频道 Shorts
GET/v1/youtube/trending-shorts2热门 Shorts
GET/v1/youtube/channel-streams2频道直播
GET/v1/youtube/hashtag-search~20话题标签搜索
GET/v1/youtube/comment-replies2评论回复
GET/v1/youtube/channel-playlists2频道播放列表
GET/v1/youtube/community-posts1社区帖子
GET/v1/youtube/community-post-details1社区帖子详情
GET/v1/youtube/video-sponsors0视频赞助商

TikTok

方法端点积分描述
GET/v1/tiktok/transcript2转录文本
GET/v1/tiktok/summarize4摘要生成器
GET/v1/tiktok/video-details1视频详情
GET/v1/tiktok/comments2评论
GET/v1/tiktok/channel-details1频道详情
GET/v1/tiktok/profile-region2个人资料地区
GET/v1/tiktok/audience-demographics3受众人口统计
GET/v1/tiktok/search-suggestions2搜索建议
GET/v1/tiktok/channel-posts2频道帖子
GET/v1/tiktok/comment-replies2评论回复
GET/v1/tiktok/user-followers1用户粉丝
GET/v1/tiktok/user-followings1用户关注
GET/v1/tiktok/music-posts2音乐帖子
GET/v1/tiktok/top-search2热门搜索
GET/v1/tiktok/search/hashtag~14按话题标签搜索
GET/v1/tiktok/search/users1搜索用户
GET/v1/tiktok/song-details1歌曲详情
GET/v1/tiktok/trending-feed2热门信息流
GET/v1/tiktok/popular-hashtags2热门话题标签
GET/v1/tiktok/popular-songs2热门歌曲
GET/v1/tiktok/live1直播
GET/v1/tiktok/live-info1直播信息
GET/v1/tiktok/popular-creators2热门创作者

Instagram Reels

方法端点积分描述
GET/v1/instagram/transcript2转录文本
GET/v1/instagram/summarize4摘要生成器
GET/v1/instagram/details1帖子和 Reel 详情
GET/v1/instagram/comments~45帖子评论
GET/v1/instagram/channel-details1频道详情
GET/v1/instagram/channel-posts~6频道帖子
GET/v1/instagram/channel-reels~6频道 Reels
GET/v1/instagram/reels-search2Reels 搜索
GET/v1/instagram/trending-reels2热门 Reels
GET/v1/instagram/tagged-posts1被标记的帖子
GET/v1/instagram/reels-by-audio-id~28按音频 ID 获取 Reels
GET/v1/instagram/hashtag-search2话题标签搜索
GET/v1/instagram/profile-search1个人资料搜索
GET/v1/instagram/embed1嵌入 HTML
GET/v1/instagram/highlights1精选
GET/v1/instagram/highlights-details1精选详情
GET/v1/instagram/basic-profile1基本资料

Facebook

方法端点积分描述
GET/v1/facebook/details2帖子和 Reel 详情
GET/v1/facebook/summarize4摘要生成器
GET/v1/facebook/comments2评论
GET/v1/facebook/page-details2页面详情
GET/v1/facebook/profile-posts2个人资料帖子
GET/v1/facebook/profile-reels2个人资料 Reels
GET/v1/facebook/group-posts~20群组帖子
GET/v1/facebook/comment-replies2评论回复
GET/v1/facebook/profile-photos2个人资料照片

Twitter / X

方法端点积分描述
GET/v1/twitter/tweet-details1推文详情
GET/v1/twitter/transcript1转录文本
GET/v1/twitter/profile1个人资料
GET/v1/twitter/user-tweets2用户推文
GET/v1/twitter/community1社区
GET/v1/twitter/community-tweets2社区推文

Reddit

方法端点积分描述
GET/v1/reddit/subreddit-posts2子版块帖子
GET/v1/reddit/post-details1帖子详情
GET/v1/reddit/post-comments2帖子评论
GET/v1/reddit/post-transcript2帖子转录文本
GET/v1/reddit/search2搜索
GET/v1/reddit/subreddit-details1子版块详情
GET/v1/reddit/subreddit-search2在子版块中搜索帖子

Threads

方法端点积分描述
GET/v1/threads/profile1个人资料
GET/v1/threads/user-posts2用户帖子
GET/v1/threads/post-details1帖子详情
GET/v1/threads/search2帖子搜索
GET/v1/threads/search-users1搜索用户

Bluesky

方法端点积分描述
GET/v1/bluesky/profile1个人资料
GET/v1/bluesky/user-posts~3用户帖子
GET/v1/bluesky/post-details1帖子详情

Pinterest

方法端点积分描述
GET/v1/pinterest/pin-details1Pin 详情
GET/v1/pinterest/user-pins~13用户 Pin
GET/v1/pinterest/search2搜索
GET/v1/pinterest/board~13画板
GET/v1/pinterest/user-boards~13用户画板

LinkedIn

方法端点积分描述
GET/v1/linkedin/profile1个人资料
GET/v1/linkedin/company2公司
GET/v1/linkedin/post-details1帖子详情
GET/v1/linkedin/post-transcript1帖子转录文本
GET/v1/linkedin/company-posts1公司帖子
GET/v1/linkedin/search-posts~16搜索帖子

Rumble

方法端点积分描述
GET/v1/rumble/video-details1视频详情
GET/v1/rumble/video/transcript1视频转录文本
GET/v1/rumble/channel-videos~12频道视频
GET/v1/rumble/search~12搜索
GET/v1/rumble/comments2评论

TikTok Shop

方法端点积分描述
GET/v1/tiktok-shop/shop-search2店铺搜索
GET/v1/tiktok-shop/shop-products2店铺商品
GET/v1/tiktok-shop/product-details2商品详情
GET/v1/tiktok-shop/product-reviews~45商品评价
GET/v1/tiktok-shop/user-showcase~45用户橱窗

Facebook Marketplace

方法端点积分描述
GET/v1/facebook/marketplace-search2Marketplace 搜索
GET/v1/facebook/marketplace-location-search2位置搜索
GET/v1/facebook/marketplace-item2Marketplace 商品

Facebook Events

方法端点积分描述
GET/v1/facebook/event-search2活动搜索
GET/v1/facebook/event-details2活动详情
GET/v1/facebook/profile-events2个人资料活动

Facebook Ad Library

方法端点积分描述
GET/v1/ad-library/facebook/search2搜索
GET/v1/ad-library/facebook/company-ads2公司广告
GET/v1/ad-library/facebook/search-companies2搜索公司
GET/v1/ad-library/facebook/ad-details2广告详情
GET/v1/ad-library/facebook/ad-transcript2广告文案

TikTok Ad Library

方法端点积分描述
GET/v1/ad-library/tiktok/search2搜索
GET/v1/ad-library/tiktok/top-ads2热门广告
GET/v1/ad-library/tiktok/ad-details2广告详情

Google Ad Library

方法端点积分描述
GET/v1/ad-library/google/company-ads2公司广告
GET/v1/ad-library/google/ad-details2广告详情
GET/v1/ad-library/google/advertiser-search1广告主搜索

LinkedIn Ad Library

方法端点积分描述
GET/v1/ad-library/linkedin/search-ads2搜索广告
GET/v1/ad-library/linkedin/ad-details2广告详情

Amazon Seller Storefront

方法端点积分描述
GET/v1/amazon-shop/page1卖家店铺

GitHub

方法端点积分描述
GET/v1/github/user1用户
GET/v1/github/repositories~12仓库
GET/v1/github/pull-requests~12拉取请求
GET/v1/github/activity~12活动
GET/v1/github/followers~3关注者
GET/v1/github/following~3正在关注
GET/v1/github/contributions2贡献
GET/v1/github/repository1仓库
GET/v1/github/trending-repositories2趋势
GET/v1/github/trending-developers2趋势开发者

Twitch

方法端点积分描述
GET/v1/twitch/profile1个人资料
GET/v1/twitch/user-videos2用户视频
GET/v1/twitch/user-schedule1用户日程
GET/v1/twitch/clip1剪辑

Spotify

方法端点积分描述
GET/v1/spotify/artist1艺人
GET/v1/spotify/track1曲目
GET/v1/spotify/album1专辑
GET/v1/spotify/search2搜索
GET/v1/spotify/podcast1播客
GET/v1/spotify/podcast-episodes2播客单集

SoundCloud

方法端点积分描述
GET/v1/soundcloud/artist1艺人
GET/v1/soundcloud/artist-tracks2艺人曲目
GET/v1/soundcloud/track1曲目

Linktree

方法端点积分描述
GET/v1/linktree/page1页面

Snapchat

方法端点积分描述
GET/v1/snapchat/user-profile1用户资料

Truth Social

方法端点积分描述
GET/v1/truth-social/profile1个人资料
GET/v1/truth-social/user-posts2用户帖子
GET/v1/truth-social/post1帖子

Kick

方法端点积分描述
GET/v1/kick/clip1剪辑

CaptAPI 账户

方法端点积分描述
GET/v1/account/balance0积分余额
GET/v1/account/request-history0请求历史
GET/v1/account/daily-usage0每日用量
GET/v1/account/most-used-routes0最常用路由

Kwai

方法端点积分描述
GET/v1/kwai/profile1个人资料
GET/v1/kwai/user-posts~20用户帖子
GET/v1/kwai/post2帖子

Komi

方法端点积分描述
GET/v1/komi/page1页面

Pillar

方法端点积分描述
GET/v1/pillar/page1页面

Linkbio

方法端点积分描述
GET/v1/linkbio/page1页面

Linkme

方法端点积分描述
GET/v1/linkme/profile1个人资料

Google Maps

方法端点积分描述
GET/v1/google/business-search2商家搜索

跨平台分析

方法端点积分描述
GET/v1/analytics/post1单条帖子/视频/Reel 的统一指标（平台自动识别）
GET/v1/analytics/compare1/url一次调用对比最多 10 个 URL 的统一指标

发布与排期工具的读取端配套功能：传入任意受支持的帖子、视频或 Reel URL（YouTube、TikTok、Instagram、Facebook、X、Reddit、Threads、Bluesky、Pinterest、LinkedIn 或 Rumble），即可获得一个标准化的指标对象——播放量、点赞数、评论数、分享数、收藏数、互动数和 engagementRate——平台会自动识别。网络未公开的字段保持为 null（YouTube 没有公开的分享/收藏计数）。

# Platform is auto-detected from the URL
curl "https://api.captapi.com/v1/analytics/post?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ" \
  -H "Authorization: Bearer capt_live_..."

# Compare several posts in one call (same metrics shape per URL)
curl "https://api.captapi.com/v1/analytics/compare?urls=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ,https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DjNQXAC9IVRw" \
  -H "Authorization: Bearer capt_live_..."

视频文件（直接上传）

方法端点积分描述
POST/v1/video/transcript1/分钟对上传文件进行语音转文字转录
POST/v1/video/summarize1/分钟 +1转录上传文件 + AI 摘要

集成

在 AI 智能体、工作流工具、云端执行器或终端中使用 Captapi——同样的 179 个端点，无需处理 REST 底层细节。

查看所有集成

[

MCP Server

Model Context Protocol 服务器，将全部 179 个端点作为类型化工具提供给 Claude、Cursor、VS Code 以及任何 MCP 智能体。

](https://captapi.com/docs/integrations#mcp)[

CLI

在终端、脚本或 CI 中调用全部 179 个端点——一条命令，JSON 输出到 stdout。

](https://captapi.com/docs/integrations#cli)[

n8n

社区节点（n8n-nodes-captapi），将全部 179 个端点引入你的 n8n 工作流。

](https://captapi.com/docs/integrations#n8n)

准备好开始构建了吗？

获取你的免费 API 密钥，60 秒内完成首次调用。

获取你的 API 密钥