Captapi

官方

AI 代理適用的公開社群媒體資料:來自 TikTok、Instagram、YouTube、X、Facebook、Threads、Reddit 和 LinkedIn 公司頁面的個人檔案、貼文、留言、逐字稿與搜尋,以及 Meta、Google、LinkedIn 和 TikTok 廣告資料庫。

你可以用 Captapi MCP 做什麼?

  • 擷取逐字稿 — 透過 URL 要求取得公開的 YouTube、TikTok、Instagram、Facebook 或 X 影片的逐字稿。
  • 摘要社群內容 — 要求 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 狀態碼,以及包含穩定 code、人類可讀的 message 與 retryable 的 error 物件。僅當 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 金鑰