Captapi

cdcstream/captapi-mcp

Connects Claude to Captapi's social media data extraction service across YouTube, TikTok, Instagram, and Facebook. You get 62 tools covering transcripts, AI summaries, comments, engagement metrics, channel analytics, video downloads, and search. The backend runs Apify scrapers with OpenAI summarization, so you can pull video metadata, batch fetch comments with pagination, grab channel stats, or upload video files for Whisper transcription. Requires a Captapi API key and charges credits per request based on your subscription tier. Useful when you're building content analysis workflows, monitoring social campaigns, or need structured data from social platforms without writing scrapers yourself.

tools: 80
auth: Secret needed
transport: STDIO, HTTP
env vars: 3
last updated: Nov 7, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://api.captapi.com/mcp --name captapi --header 'Authorization: Bearer ${API_TOKEN}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http captapi https://api.captapi.com/mcp --header 'Authorization: YOUR_AUTHORIZATION'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 80 tools

Verified live against the running server on Nov 6, 2026.

youtube_transcriptYouTube's published captions with timestamps — not speech-to-text. Flat 1 credit; 404 is free. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).3 params

YouTube's published captions with timestamps — not speech-to-text. Flat 1 credit; 404 is free. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

languagestring

Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.

url*string

Public YouTube video URL, e.g. https://youtube.com/watch?v=ID. Not a TikTok/Instagram/Facebook URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTu...

youtube_audio_transcriptSpeech-to-text for YouTube audio. Use it when a video has no captions — or when you want a transcript of what was actually spoken rather than YouTube's published captions. Priced per started minute of audio. Costs 2 credits/min of audio. Empty results and failures are never ch...4 params

Speech-to-text for YouTube audio. Use it when a video has no captions — or when you want a transcript of what was actually spoken rather than YouTube's published captions. Priced per started minute of audio. Costs 2 credits/min of audio. Empty results and failures are never ch...

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

languagestring

Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.

maxCreditsinteger

Refuse before STT when estimatedCredits would exceed this (400 cost_exceeds_max, 0 credits). The estimate is on every success and, when the extract miss is retryable, as estimatedCreditsIfRetried.

url*string

youtube_summarizeAI summary from YouTube's published captions — same source as /transcript. Flat 3 credits; caption-miss 404 is free. Costs 3 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).3 params

AI summary from YouTube's published captions — same source as /transcript. Flat 3 credits; caption-miss 404 is free. Costs 3 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

languagestring

Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.

url*string

youtube_video_detailsYouTube video metadata + stats. Always includes degraded / degradedReason — retry when degraded is true. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).2 params

YouTube video metadata + stats. Always includes degraded / degradedReason — retry when degraded is true. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

url*string

youtube_commentsGet comments on any YouTube video — text, author, likes, and truncated publishedTimeApprox from the relative label, with cursor pagination (nextCursor + hasMore). Flat 2 credits per call; 0 when the video has comments turned off (commentsDisabled: true). Costs 2 credits. Empty...4 params

Get comments on any YouTube video — text, author, likes, and truncated publishedTimeApprox from the relative label, with cursor pagination (nextCursor + hasMore). Flat 2 credits per call; 0 when the video has comments turned off (commentsDisabled: true). Costs 2 credits. Empty...

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.

limitinteger

Max items to return (default 50, max 500). Flat 2 credits per call.

url*string

youtube_channel_detailsYouTube channel stats — ISO country, createdAt date-only, real banner or null, quote-aware SEO tags, absolute links. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).2 params

YouTube channel stats — ISO country, createdAt date-only, real banner or null, quote-aware SEO tags, absolute links. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

url*string

YouTube channel URL, @handle, bare handle, or UC... channel ID, e.g. https://youtube.com/@handle or @mkbhd. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e....

youtube_searchYouTube search with cursor pagination — typed hits, ids, canonical URLs, filters (2 credits/page, 0 when a page finds nothing). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).9 params

YouTube search with cursor pagination — typed hits, ids, canonical URLs, filters (2 credits/page, 0 when a page finds nothing). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.

durationstring

any | under_4 | 4_20 | over_20. Applies to long-form videos (not Shorts).

limitinteger

Max items to return (default 20, max 200). Flat 2 credits per call.

q*string

Search query or keywords (min 2 characters).

regionstring

ISO country code for localized results (default US).

sortBystring

relevance | views (alias: popular→views). date and rating answer 400 SORT_NOT_SUPPORTED: YouTube no longer orders search by upload date (use uploadDate) or by rating. With type=shorts only relevanc...

typestring

all | videos | shorts | channels | playlists.

uploadDatestring

any | today | this_week | this_month | this_year.

youtube_channel_videosChannel uploads with cursor pagination — exact publishedAt from reel_item_watch (same as channel-shorts). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).5 params

Channel uploads with cursor pagination — exact publishedAt from reel_item_watch (same as channel-shorts). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.

fastboolean

Set true to use YouTube RSS for faster results with less detailed metadata. Leave false when viewCount/duration quality matters.

limitinteger

Max items to return (default 20, max 200). Flat 2 credits per call.

url*string

youtube_playlist_videosPaginated playlist contents — cursor/nextCursor/hasMore, same row shape as channel-videos. Flat 2 credits/page. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).5 params

Paginated playlist contents — cursor/nextCursor/hasMore, same row shape as channel-videos. Flat 2 credits/page. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.

fastboolean

Set true to use YouTube RSS for faster results with less detailed metadata. Leave false when viewCount/duration quality matters.

limitinteger

Max items to return (default 50, max 500). Flat 2 credits per call.

url*string

YouTube playlist URL, e.g. https://youtube.com/playlist?list=ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook...

youtube_playlistPlaylist metadata only — title, channel{}, totalVideos, thumbnailUrl. No videos[]. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).2 params

Playlist metadata only — title, channel{}, totalVideos, thumbnailUrl. No videos[]. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

url*string

youtube_shorts_transcriptTranscript for a YouTube Short — rejects long-form videos (≤3 min only). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).3 params

Transcript for a YouTube Short — rejects long-form videos (≤3 min only). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

languagestring

Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.

url*string

Public YouTube Shorts URL, e.g. https://youtube.com/shorts/ID (≤3 min). Long-form videos return HTTP 422 — use the matching /v1/youtube/… endpoint instead. The URL platform must match this endpoint...

youtube_shorts_summarizeAI summary of a YouTube Short — rejects long-form videos (≤3 min only). Costs 3 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).3 params

AI summary of a YouTube Short — rejects long-form videos (≤3 min only). Costs 3 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

languagestring

Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.

url*string

youtube_shorts_detailsYouTube Short metadata — same schema as Video Details, with isShort:true; long-form videos get HTTP 422. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).2 params

YouTube Short metadata — same schema as Video Details, with isShort:true; long-form videos get HTTP 422. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

url*string

youtube_shorts_commentsComments on a YouTube Short — rejects long-form videos (≤3 min only). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).4 params

Comments on a YouTube Short — rejects long-form videos (≤3 min only). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.

limitinteger

Max items to return (default 50, max 500). Flat 2 credits per call.

url*string

youtube_channel_shortsChannel Shorts with cursor pagination — same row shape as channel-videos (exact publishedAt). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).4 params

Channel Shorts with cursor pagination — same row shape as channel-videos (exact publishedAt). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.

limitinteger

Max items to return (default 20, max 200). Flat 2 credits per call.

url*string

youtube_trending_shortsYouTube Shorts recommendation sequence — fixed window per call (no cursor), not a global chart. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).3 params

YouTube Shorts recommendation sequence — fixed window per call (no cursor), not a global chart. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

limitinteger

Max items to return (default 20, max 100). Returns a single window; use limit to size it. No cursor. Flat 2 credits per call.

qstring

Optional topic seed for the Shorts recommendation sequence. Omit (or pass trending/shorts) for the default reel feed — not a keyword search.

youtube_channel_streamsChannel Live tab only — liveStatus per row; 0 credits when hasLiveTab is false. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).3 params

Channel Live tab only — liveStatus per row; 0 credits when hasLiveTab is false. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

limitinteger

Max items to return (default 20, max 200). Flat 2 credits when hasLiveTab is true; 0 credits when hasLiveTab is false.

url*string

youtube_hashtag_searchDefault ~10 credits (limit 10; 1/result). Videos from youtube.com/hashtag/{name} — nested channel{}, viewCountIsApproximate. Not keyword search. Costs ~10 credits (1/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always...3 params

Default ~10 credits (limit 10; 1/result). Videos from youtube.com/hashtag/{name} — nested channel{}, viewCountIsApproximate. Not keyword search. Costs ~10 credits (1/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always...

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

limitinteger

Max items to return (default 10, max 200). Returns a single window; use limit to size it. No cursor. Billed per result.

q*string

Hashtag with or without the # (min 2 characters). One token — spaces are 400 HASHTAG_HAS_SPACES.

youtube_comment_repliesReplies under a top-level comment — parentReplyCount + cursor. Nested reply ids return 404. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).5 params

Replies under a top-level comment — parentReplyCount + cursor. Nested reply ids return 404. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

commentId*string

ID of the parent (top-level) comment to fetch replies for — from the comments endpoint. Legacy alias: comment_id.

cursorstring

Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.

limitinteger

Max items to return (default 50, max 500). Flat 2 credits per call.

url*string

youtube_channel_playlistsChannel playlists with cursor pagination — id, title, totalVideos, thumbnailUrl. Flat 2 credits/page. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).4 params

Channel playlists with cursor pagination — id, title, totalVideos, thumbnailUrl. Flat 2 credits/page. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.

limitinteger

Max items to return (default 20, max 200). Flat 2 credits per call.

url*string

youtube_community_postsCommunity posts — channel{}, publishedTimeApprox, likeCountIsApproximate, linkedVideos[], cursor (1 credit). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).4 params

Community posts — channel{}, publishedTimeApprox, likeCountIsApproximate, linkedVideos[], cursor (1 credit). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.

limitinteger

Max items to return (default 20, max 200). Flat 1 credit per call.

url*string

youtube_community_post_detailsOne community post — list schema + commentCount trio + isEdited. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).2 params

One community post — list schema + commentCount trio + isEdited. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

url*string

YouTube community post URL (/post/Ugkx… or /community?lb=). Trailing whitespace is stripped. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to T...

youtube_video_sponsorsSponsorBlock community segments — free while the CC BY-NC-SA commercial-use exception is pending. Costs 0 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).4 params

SponsorBlock community segments — free while the CC BY-NC-SA commercial-use exception is pending. Costs 0 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

categoriesstring

Comma-separated categories. Default sponsor,selfpromo,interaction. Also intro,outro,preview,music_offtopic,poi_highlight,filler.

minVotesinteger

Minimum SponsorBlock votes to keep a segment. Default 0 (drops community-rejected votes < 0).

url*string

tiktok_transcriptTranscript Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).3 params

Transcript Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Serve from the 24h shared cache when available (0 credits on hit). Default true — set false to always fetch fresh.

languagestring

Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.

url*string

Public TikTok video URL, e.g. https://www.tiktok.com/@khaby.lame/video/7646812028874673439. Not a YouTube/Instagram/Facebook URL. The URL platform must match this endpoint's platform. Do not pass c...

tiktok_summarizeSummarizer Costs 4 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).3 params

Summarizer Costs 4 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

languagestring

ISO code, e.g. "tr": pins the speech language and sets the summary output language. Defaults to auto-detect + English summary.

url*string

tiktok_video_detailsGet everything about one TikTok video from its URL — caption, view/like/comment/share/save counts, creator, sound, hashtags, and thumbnail. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).2 params

Get everything about one TikTok video from its URL — caption, view/like/comment/share/save counts, creator, sound, hashtags, and thumbnail. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

url*string

tiktok_commentsTikTok comments — clean schema plus authorName, stable authorId/authorSecUid and commentLanguage for listening loops. Unresolvable videos are 404 at 0 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default alwa...4 params

TikTok comments — clean schema plus authorName, stable authorId/authorSecUid and commentLanguage for listening loops. Unresolvable videos are 404 at 0 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default alwa...

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (a numeric offset, e.g. 50). A null nextCursor means the end of the comments.

limitinteger

Max items to return (default 50, max 500). Flat 2 credits per call.

url*string

tiktok_channel_detailsResolve a TikTok @handle to id + secUid — createTime, ttSeller, bioLink, decoded privacy flags. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).4 params

Resolve a TikTok @handle to id + secUid — createTime, ttSeller, bioLink, decoded privacy flags. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.

cacheMaxAgestring

Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.

rawboolean

Set true to include TikTok's upstream user/statsV2 blob under raw, plus createTimeUnix (unix twin of createTime). Default false — curated fields only.

url*string

TikTok profile URL, @handle, or username, e.g. https://tiktok.com/@username. Not a YouTube channel URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. Y...

tiktok_profile_regionFind out where a TikTok creator is likely based and what language they use — country, language, stable ids, and core profile stats. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).4 params

Find out where a TikTok creator is likely based and what language they use — country, language, stable ids, and core profile stats. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 7d response cache (0 credits on hit). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.

cacheMaxAgestring

Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.

rawboolean

Set true to include TikTok's upstream user/statsV2 blob under raw. Default false — curated fields only.

url*string

tiktok_audience_demographicsAudience country + language mix for a TikTok creator — engagement sample, not a follower census. Costs 3 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).4 params

Audience country + language mix for a TikTok creator — engagement sample, not a follower census. Costs 3 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

countriesLimitinteger

Max countries in audienceLocations; remainder folds into other{count,percentage}. Omit for the full list (other is omitted when unused).

url*string

videosinteger

How many recent videos to sample comments from: 12 (default, 3 credits), 30 (5 credits), or 60 (8 credits).

tiktok_search_suggestionsGet the autocomplete terms TikTok suggests in its search bar for a keyword — the real phrases people search, ranked, so you can find trending queries and long-tail keyword ideas. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cach...5 params

Get the autocomplete terms TikTok suggests in its search bar for a keyword — the real phrases people search, ranked, so you can find trending queries and long-tail keyword ideas. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cach...

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

countrystring

Two-letter ISO country code that localizes the suggestions to a market, e.g. US, GB, DE. Default US.

languagestring

Interface language for the suggestions, e.g. en-US or de-DE. Default en-US.

limitinteger

Max items to return (default 20, max 100). Flat 2 credits per call.

q*string

Seed keyword to expand into autocomplete suggestions, e.g. skincare.

tiktok_channel_postsLatest videos from a TikTok profile, cursor-paginated. Flat 2 credits; failures are 0 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).4 params

Latest videos from a TikTok profile, cursor-paginated. Flat 2 credits; failures are 0 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (TikTok's max_cursor timestamp, e.g. 1783614676000). A null nextCursor means the...

limitinteger

How many of the creator's latest videos to return on this page (default 20, max 200). Newest first. Flat 2 credits per successful call.

url*string

tiktok_comment_repliesReplies under a TikTok comment — same authorId/authorSecUid/commentLanguage shape as comments. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).5 params

Replies under a TikTok comment — same authorId/authorSecUid/commentLanguage shape as comments. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

commentId*string

ID of the parent (top-level) comment to fetch replies for — from the comments endpoint. Legacy alias: comment_id.

cursorstring

Pagination cursor. Leave empty for the first page; then pass the nextCursor value from the previous response.

limitinteger

Max items to return (default 50, max 500). Flat 2 credits per call.

url*string

tiktok_user_followersList a TikTok user's followers — id, secUid, createTime, region, language, cursor pagination. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).4 params

List a TikTok user's followers — id, secUid, createTime, region, language, cursor pagination. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Pagination cursor (TikTok minCursor). Leave empty for the first page; then pass nextCursor from the previous response.

limitinteger

Max items to return (default 50, max 500). Flat 1 credit per call.

url*string

tiktok_user_followingsList who a TikTok user follows — id, secUid, createTime, region, language, cursor pagination. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).4 params

List who a TikTok user follows — id, secUid, createTime, region, language, cursor pagination. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Pagination cursor (TikTok minCursor). Leave empty for the first page; then pass nextCursor from the previous response.

limitinteger

Max items to return (default 50, max 500). Flat 1 credit per call.

url*string

tiktok_music_postsList TikTok videos that use a specific sound — caption, author, exact engagement, canonical hashtags, and mentions, with cursor pagination. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).4 params

List TikTok videos that use a specific sound — caption, author, exact engagement, canonical hashtags, and mentions, with cursor pagination. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response. hasMore is true only when nextCursor is present.

limitinteger

Most videos to return (default 20, 1–50; outside that range is a 400). TikTok serves this feed in short pages, so a call can return fewer than limit with a nextCursor to continue. Flat 2 credits pe...

url*string

TikTok music/sound URL, e.g. https://tiktok.com/music/name-ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook,...

tiktok_top_searchTikTok Top/General search — videos and photo carousels when TikTok includes them, with contentType + images[]. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).4 params

TikTok Top/General search — videos and photo carousels when TikTok includes them, with contentType + images[]. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorinteger

Pagination cursor. Leave 0 for the first page; then pass nextCursor from the previous response. TikTok may return duplicates across pages.

limitinteger

Max items to return (default 20, max 200). Flat 2 credits per call.

q*string

Search query or keywords (min 2 characters).

tiktok_search_by_hashtagDefault ~7 credits (limit 10; 0.7/result). Videos from TikTok's /tag/{name} challenge feed — not keyword or username search. Cursor + hasMore. Costs ~7 credits (0.7/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always...5 params

Default ~7 credits (limit 10; 0.7/result). Videos from TikTok's /tag/{name} challenge feed — not keyword or username search. Cursor + hasMore. Costs ~7 credits (0.7/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always...

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorinteger

Pagination offset. Leave at 0 (or omit) for the first page; then pass the nextCursor value returned in the previous response. A null nextCursor means the end of the results.

limitinteger

Max items to return (default 10, max 100). Billed per result.

q*string

Single hashtag token for the /tag/{name} challenge feed, with or without # (min 2). Spaces are 400 — use /v1/tiktok/top-search for a keyword query.

regionstring

Two-letter ISO 3166-1 country code. Default US. Accepted for compatibility; does not filter results by country.

tiktok_search_usersSearch TikTok users — distinct creators only, id + secUid, per-counter isApproximate flags, cursor pagination. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).5 params

Search TikTok users — distinct creators only, id + secUid, per-counter isApproximate flags, cursor pagination. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Pagination cursor. Omit (or pass 0) for the first page; then pass the nextCursor value from the previous response verbatim — it carries the search session, not just an offset. A null nextCursor mea...

fallbackboolean

Deprecated — no effect, removed on 2026-12-17. Sending it adds an X-Captapi-Warning response header. When native search is unavailable the response is an empty degraded page (0 credits).

limitinteger

Max items to return (default 20, max 100). Flat 1 credit per call.

q*string

Search query matched against usernames, display names and bios (min 2 characters).

tiktok_song_detailsTikTok sound metadata — usageCount, artists[{id,secUid,handle}], audio{bpm,loudness,beats}, commerce rights (1 credit; 2 via the fallback path). Costs 1 credit (2 via fallback path). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (defaul...2 params

TikTok sound metadata — usageCount, artists[{id,secUid,handle}], audio{bpm,loudness,beats}, commerce rights (1 credit; 2 via the fallback path). Costs 1 credit (2 via fallback path). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (defaul...

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

url*string

TikTok music/sound URL, e.g. https://tiktok.com/music/name-ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook,...

tiktok_trending_feedFor You by default; pass orderBy/period/page for Creative Center popular videos (like/hot/comment/repost) with totalCount. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).7 params

For You by default; pass orderBy/period/page for Creative Center popular videos (like/hot/comment/repost) with totalCount. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

countrystring

Two-letter ISO country (default US). For You: region-availability hint. Creative Center mode: chart market.

countryCodestring

Alias of country. Wins when both are set.

limitinteger

Max items to return (default 20, max 200). Flat 2 credits per call.

orderBystring

Creative Center sort: hot (views), like, comment, or repost. Unknown values are 400. vv/views/plays are aliases of hot — the response echoes the public name. Setting this (or period / page>1) switc...

pageinteger

Creative Center page (default 1). page>1 triggers chart mode.

periodinteger

Lookback days: 7, 30, or 120 (180→120). Triggers chart mode. Every returned publishedAt is inside this window — a For You fallthrough is filtered the same way.

tiktok_popular_hashtagsRelated TikTok hashtags — Creative Center chart when it answers, otherwise a disclosed niche fallback. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).9 params

Related TikTok hashtags — Creative Center chart when it answers, otherwise a disclosed niche fallback. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

countrystring

Two-letter ISO country for the Creative Center chart. Default US.

industryIdstring

Optional Creative Center industry_id.

limitinteger

Max items to return (default 20, max 100). Flat 2 credits per call.

newOnBoardboolean

Only hashtags newly on the Top 100.

pageinteger

Creative Center page (default 1).

periodinteger

Lookback days: 7, 30, or 120 (180→120). Default 7.

querystring

Optional niche seed for co-occurrence + challenge/detail enrich. Omit, or pass trending, to try the Creative Center chart (10s cap); a miss falls through to related tags for fyp (source=niche_fallb...

sortBystring

Chart sort: popular (default).

tiktok_liveCheck whether a TikTok creator is live right now and get the stream URLs (CMAF/DASH + FLV, HLS when TikTok exposes it) — one GET with an @handle, 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fr...2 params

Check whether a TikTok creator is live right now and get the stream URLs (CMAF/DASH + FLV, HLS when TikTok exposes it) — one GET with an @handle, 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fr...

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

url*string

tiktok_live_infoIdentical to TikTok Live (isLive, creator.id/secUid, streamQualities hls/cmaf). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).2 params

Identical to TikTok Live (isLive, creator.id/secUid, streamQualities hls/cmaf). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

url*string

tiktok_popular_creatorsCreative Center creators + createTime / bioLinkRisk / ttSeller hydrate for partnership vetting. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).7 params

Creative Center creators + createTime / bioLinkRisk / ttSeller hydrate for partnership vetting. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.

cacheMaxAgestring

Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.

countrystring

Two-letter ISO country code. Default US.

follower_countstring

Optional range on the For You ranking: 10k-100k, 100k-1m, 1m-10m, >10m.

limitinteger

Max items to return (default 20, max 100). Flat 2 credits per call.

pageinteger

Creative Center page (default 1).

sortstring

follower, engagement, or popularity. Default follower.

instagram_transcriptTurn any Instagram Reel's speech into text — the full transcript plus timestamped segments, ready for search, subtitles, or AI pipelines. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).3 params

Turn any Instagram Reel's speech into text — the full transcript plus timestamped segments, ready for search, subtitles, or AI pipelines. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

languagestring

Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.

url*string

Instagram Reel URL, e.g. https://instagram.com/reel/ID/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, Linked...

instagram_summarizeGet an AI summary of any Instagram Reel — a short paragraph plus key points, without watching the video. Costs 4 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).3 params

Get an AI summary of any Instagram Reel — a short paragraph plus key points, without watching the video. Costs 4 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

languagestring

ISO code, e.g. "tr": pins the speech language and sets the summary output language. Defaults to auto-detect + English summary.

url*string

instagram_detailsGet an Instagram post, Reel or carousel — caption, likes, comments, views, media URLs, author, and per-slide children on carousels. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).2 params

Get an Instagram post, Reel or carousel — caption, likes, comments, views, media URLs, author, and per-slide children on carousels. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

url*string

Instagram post or reel URL, e.g. https://instagram.com/reel/ID/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook...

instagram_commentsDefault ~9 credits (limit 10; 0.9/result). Session-paged Instagram comments — a logged-out 2-row preview of a larger thread is 503 SESSION_UNAVAILABLE at 0 credits. Costs ~9 credits (0.9/result). Empty results and failures are never charged. Pass cache=true for a free 24h cach...4 params

Default ~9 credits (limit 10; 0.9/result). Session-paged Instagram comments — a logged-out 2-row preview of a larger thread is 503 SESSION_UNAVAILABLE at 0 credits. Costs ~9 credits (0.9/result). Empty results and failures are never charged. Pass cache=true for a free 24h cach...

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Pagination cursor from the previous nextCursor ({mediaPk}:{minId}). Omit on the first page. hasMore is true when nextCursor is set, or when more exist and cannot be paged (nextCursor null + truncat...

limitinteger

Max items to return (default 10, max 500). Billed per result.

url*string

instagram_channel_detailsInstagram profile stats — fixed key set (null fillers), fbid, bioLinks, isBusinessAccount, approx flags. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).3 params

Instagram profile stats — fixed key set (null fillers), fbid, bioLinks, isBusinessAccount, approx flags. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.

cacheMaxAgestring

Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.

url*string

Instagram profile URL, @handle, or username, e.g. https://instagram.com/username/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Ins...

instagram_channel_postsDefault ~3 credits (limit 10; 0.3/result). Latest posts from a public Instagram profile — carousel children[], mediaCount, user{} in one call. Costs ~3 credits (0.3/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always...4 params

Default ~3 credits (limit 10; 0.3/result). Latest posts from a public Instagram profile — carousel children[], mediaCount, user{} in one call. Costs ~3 credits (0.3/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always...

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (e.g. 3937014945555313553_1697296). A null nextCursor means the end of the list.

limitinteger

Max items to return (default 10, max 200). Billed per result.

url*string

instagram_channel_reelsDefault ~3 credits (limit 10; 0.3/result). Latest Reels from a public Instagram profile — pass userId to skip resolve; ceil(n×0.3) credits; nextCursor + hasMore. Costs ~3 credits (0.3/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache h...5 params

Default ~3 credits (limit 10; 0.3/result). Latest Reels from a public Instagram profile — pass userId to skip resolve; ceil(n×0.3) credits; nextCursor + hasMore. Costs ~3 credits (0.3/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache h...

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Pagination cursor. Leave empty for the first page; then pass nextCursor from the previous response (clips:{userId}:{opaque} on the native Reels path, or legacy {mediaId}_{userId}). Stop when hasMor...

limitinteger

Max items to return (default 10, max 200). Billed per result.

urlstring

Instagram profile URL, @handle, or username. Omit when userId is set. The URL platform must match this endpoint's platform.

userIdstring

Instagram numeric user ID (e.g. 173560420). Skips handle→ID resolve (legacy sequential WPI alone could cost ~80s). Prefer when you already have the ID from basic-profile or profile-search.

instagram_reels_searchNative tag feed first, slower fallback paths on a miss. Max 50. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).4 params

Native tag feed first, slower fallback paths on a miss. Max 50. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

datePostedstring

last_24_hours | last_week | last_month | last_year (aliases: today, this_week, this_month, this_year).

limitinteger

Max items to return (default 20, max 50). Flat 2 credits per call.

q*string

Hashtag without the # (min 2 characters). One token — spaces are 400 HASHTAG_HAS_SPACES.

instagram_trending_reelsCache-first trending Reels. Feed outage → labelled country hashtag-clips stand-in (listing field), never a silent swap. Max 50. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Successful calls bill even on cache hits.3 params

Cache-first trending Reels. Feed outage → labelled country hashtag-clips stand-in (listing field), never a silent swap. Max 50. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Successful calls bill even on cache hits.

Parameters* required

cacheboolean

Default true (cache-first): serve the per-country response cache when present (TTL 4 hours). Every successful call costs 2 credits — including cache hits. Set false to force a live scrape (measured...

countrystring

Country for Reels localization — full name or ISO code (e.g. 'United States', 'US', 'Turkey', 'TR'). Default United States. Unsupported values return 400 with supportedCountries[].

limitinteger

Max items to return (default 10, max 50). Flat 2 credits per call.

instagram_tagged_postsPosts that tag an Instagram account — author verified/avatar when available, staleFeed when Instagram only exposes an archive. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).4 params

Posts that tag an Instagram account — author verified/avatar when available, staleFeed when Instagram only exposes an archive. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Leave empty for the first page; then pass the nextCursor value returned in the previous response.

limitinteger

Max items to return (default 20, max 200). Flat 1 credit per call.

url*string

instagram_reels_by_audio_idDefault ~14 credits (limit 10; 1.4/result). Is this Instagram sound trending? Reels that use it + isTrendingInClips / trendRank / rich music{}. Costs ~14 credits (1.4/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default alway...3 params

Default ~14 credits (limit 10; 1.4/result). Is this Instagram sound trending? Reels that use it + isTrendingInClips / trendRank / rich music{}. Costs ~14 credits (1.4/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default alway...

Parameters* required

audioId*string

Instagram audio/music ID or full audio URL, e.g. 27919946310946207.

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

limitinteger

Max items to return (default 10, max 200). Billed per result.

instagram_hashtag_searchHashtag Explore: native grid first, fallback path only on miss. Max 50. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).4 params

Hashtag Explore: native grid first, fallback path only on miss. Max 50. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

limitinteger

Max items to return (default 20, max 50). Flat 2 credits per call.

mediaTypestring

all (default) or reels — return only Reels/clips when set to reels.

q*string

Hashtag without the # (min 2 characters). One token — spaces are 400 HASHTAG_HAS_SPACES.

instagram_profile_searchResolve a brand or @handle to one public Instagram profile — stable id, bio, links, and stats (not niche discovery). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).2 params

Resolve a brand or @handle to one public Instagram profile — stable id, bio, links, and stats (not niche discovery). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Serve from the 24h shared cache when available (0 credits on hit). Default true — set false to always fetch fresh.

q*string

Account name, @handle, or profile URL to resolve (min 2 characters). A leading _, accents (misión → mision), spaces and URL query strings (?igsh=…) are stripped. A q with no usable username charact...

instagram_embedClassic Instagram embed snippet — blockquote.instagram-media + embed.js. Drop html into your page. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).2 params

Classic Instagram embed snippet — blockquote.instagram-media + embed.js. Drop html into your page. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

url*string

Instagram post, reel, or profile URL (or @handle), e.g. https://instagram.com/reel/ID/ or https://instagram.com/username/. The URL platform must match this endpoint's platform. Do not pass cross-pl...

instagram_highlightsPersistent Story Highlight albums for a public profile — id, title, cover, owner. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).3 params

Persistent Story Highlight albums for a public profile — id, title, cover, owner. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

urlstring

Instagram profile URL, @handle, or username. Omit when userId is set.

userIdstring

Numeric Instagram user ID. Prefer when known — skips handle→ID resolve. When only userId is set we reverse-resolve the username so the WPI / profile-HTML shelf can still run.

instagram_highlights_detailsItems inside one Instagram Story Highlight album — media URLs, type, takenAt. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).2 params

Items inside one Instagram Story Highlight album — media URLs, type, takenAt. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

id*string

Highlight id from /v1/instagram/highlights (with or without highlight: prefix).

instagram_basic_profileInstagram profile by user ID or @handle — camelCase schema aligned with Channel Details (followers, externalUrl, businessAddress). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).3 params

Instagram profile by user ID or @handle — camelCase schema aligned with Channel Details (followers, externalUrl, businessAddress). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.

cacheMaxAgestring

Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.

userId*string

Instagram numeric pk (e.g. 13460080 — the id field on this endpoint), or a profile URL / @handle / username. A Facebook/Graph fbid (17-digit 17841…) is 400 WRONG_ID_TYPE.

facebook_detailsFacebook post or Reel — caption, engagement, author id, video{} playback, and music when Facebook exposes them. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).2 params

Facebook post or Reel — caption, engagement, author id, video{} playback, and music when Facebook exposes them. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

url*string

Public Facebook video or post URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pi...

facebook_summarizeSummarizer Costs 4 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).2 params

Summarizer Costs 4 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

url*string

facebook_commentsFacebook post comments with reactionCount, reactions.like when mixed, author.id (pfbid), and replyCount. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).4 params

Facebook post comments with reactionCount, reactions.like when mixed, author.id (pfbid), and replyCount. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

feedbackIdstring

Post feedback id from /v1/facebook/details (base64 feedback:POSTID). Prefer when you already have it — also accepts feedback_id.

limitinteger

Max items to return (default 50, max 500). Flat 2 credits per call.

urlstring

Facebook post or Reel URL. Omit when feedbackId is set. The URL platform must match this endpoint's platform. A page/profile URL also works: Facebook renders the page's most recent post first, so y...

facebook_page_detailsFacebook page profile — likes vs followers (distinct), talkingAbout, category, website, and public email. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).2 params

Facebook page profile — likes vs followers (distinct), talkingAbout, category, website, and public email. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

url*string

Facebook page URL, @handle, or page name, e.g. https://facebook.com/PageName. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagra...

facebook_profile_postsLatest posts and Reels from a Facebook page — listingHits / timings.phase; 60s deadline, failures 0 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).3 params

Latest posts and Reels from a Facebook page — listingHits / timings.phase; 60s deadline, failures 0 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

limitinteger

Max items to return (default 4, max 4). The logged-out listing hop is ~23–29s typical, hard-capped at 40s. Each hydrate is typically 6–10s (can be ~100ms when listing already carried the post) and...

url*string

Facebook profile/page URL, @handle, or page name. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X...

facebook_profile_reelsLatest Facebook page Reels — views, likes, comments, shares; newest-first without archive padding. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).3 params

Latest Facebook page Reels — views, likes, comments, shares; newest-first without archive padding. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

limitinteger

Max items to return (default 20, max 200). Flat 2 credits per call.

url*string

facebook_group_postsDefault ~10 credits (limit 10; 1/result). Newest posts from a public Facebook group — caption, author, engagement, sortBy; 1 credit per post. Costs ~10 credits (1/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fr...4 params

Default ~10 credits (limit 10; 1/result). Newest posts from a public Facebook group — caption, author, engagement, sortBy; 1 credit per post. Costs ~10 credits (1/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fr...

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

limitinteger

Max posts to return (default 10, max 200; up to 80 per call — above that you get 80 with truncatedReason per-call-cap). Billed 1 credit per returned post, minimum 2.

sortBystring

TOP_POSTS | RECENT_ACTIVITY | CHRONOLOGICAL (default) | CHRONOLOGICAL_LISTINGS. Maps to Facebook sorting_setting.

url*string

Public Facebook group URL, e.g. https://facebook.com/groups/ID. Must contain /groups/ — profile/page URLs are a definitive 400 (use /v1/facebook/profile-posts for those). The URL platform must matc...

facebook_comment_repliesComment Replies Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).4 params

Comment Replies Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

commentId*string

ID of the parent (top-level) comment to fetch replies for — from the comments endpoint. Legacy alias: comment_id.

limitinteger

Max items to return (default 50, max 500). Flat 2 credits per call.

url*string

Facebook post URL the comment belongs to. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter...

facebook_profile_photosPhoto grid from a Facebook Page — full image URL plus accessibilityCaption (alt-text, not a post caption). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).3 params

Photo grid from a Facebook Page — full image URL plus accessibilityCaption (alt-text, not a post caption). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

limitinteger

Max items to return (default 20, max 200). The public /photos grid is a single SSR batch (often ~8) — retrievableCount is that batch, not a promise Facebook will fill limit. Flat 2 credits per call.

url*string

twitter_tweet_detailsOne tweet as JSON — text, author (followers), likes/replies/retweets/quotes, media, ISO publishedAt. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).2 params

One tweet as JSON — text, author (followers), likes/replies/retweets/quotes, media, ISO publishedAt. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

url*string

Public tweet URL, e.g. https://x.com/user/status/ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn t...

twitter_transcriptTweet text as a transcript — timingSource none (not speech-to-text). Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).2 params

Tweet text as a transcript — timingSource none (not speech-to-text). Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

url*string

twitter_profileX profile: verified + blue/legacy/identity, displayName, avatar/banner, tipjar→contact{}, expanded website. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).3 params

X profile: verified + blue/legacy/identity, displayName, avatar/banner, tipjar→contact{}, expanded website. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to use the 24-hour profile cache (0 credits on hit). Default false — always fetch fresh. Prefer cacheMaxAge for 1d–30d.

cacheMaxAgestring

Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.

url*string

Twitter/X profile URL or @handle, e.g. https://x.com/username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook,...

twitter_user_tweetsMost popular public tweets from a Twitter/X profile (~100 cap) — not chronological. Text, author, engagement, hashtags, media. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).3 params

Most popular public tweets from a Twitter/X profile (~100 cap) — not chronological. Text, author, engagement, hashtags, media. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

limitinteger

Max tweets to return (default 20, max 200). Twitter's public surface usually caps around ~100 most popular posts — not chronological latest. Flat 2 credits per call.

url*string

Twitter/X profile URL or @handle. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pin...

twitter_communityX Community metadata — ISO createdAt, flat creator handle, isNsfw + bannerImage, rules[]. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).2 params

X Community metadata — ISO createdAt, flat creator handle, isNsfw + bannerImage, rules[]. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

url*string

X community URL (x.com/i/communities/ID) or community ID — not a tweet/status URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Ins...

twitter_community_tweetsPosts in an X Community — same 6-metric tweet shape as search. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).3 params

Posts in an X Community — same 6-metric tweet shape as search. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

limitinteger

Max items to return (default 25, max 200). Flat 2 credits per call.

url*string

reddit_subreddit_postsList posts from a subreddit with sort, timeframe, and cursor pagination — title, score, upvote ratio, flair, and more. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).6 params

List posts from a subreddit with sort, timeframe, and cursor pagination — title, score, upvote ratio, flair, and more. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.

limitinteger

Max items to return (default 25, max 200). Flat 2 credits per call.

sortstring

Feed sort: best, hot, new (default), top, or rising.

timeframestring

For sort=top: hour, day (default), week, month, year, or all.

url*string

Subreddit URL, r/name, or bare name, e.g. r/technology. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedI...

reddit_post_detailsGet a Reddit post — title, body, score, comments count, subreddit, and author as structured JSON. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).2 params

Get a Reddit post — title, body, score, comments count, subreddit, and author as structured JSON. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

url*string

Reddit post URL, e.g. https://reddit.com/r/sub/comments/ID/... The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook,...

reddit_post_commentsFlat Reddit comment threads with depth/parentId and the parent post in one call. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).4 params

Flat Reddit comment threads with depth/parentId and the parent post in one call. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).

Parameters* required

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

cursorstring

Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.

limitinteger

Max items to return (default 50, max 500). Flat 2 credits per call.

url*string

Reddit post URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.

Configuration

CAPTAPI_API_KEY*secret

Your capt_live_... API key. Create one at https://captapi.com/dashboard/api-keys (100 free credits).

CAPTAPI_BASE_URL

Override the Captapi API base URL (default https://api.captapi.com).

CAPTAPI_PLATFORMS

Comma-separated platform ids to load, e.g. instagram,tiktok (default: all platforms).

Readme

Captapi MCP server

Captapi's hosted Model Context Protocol server gives Claude, Cursor, VS Code and other MCP clients read access to public social media data through one API key. Each Captapi REST endpoint is exposed as one MCP tool that returns JSON.

This repository holds documentation and the registry manifest only. It contains no server source code.

Endpoint: https://api.captapi.com/mcp
Transport: Streamable HTTP (stateless, JSON-RPC over POST)
Auth: Authorization: Bearer <key> or x-api-key: <key>
Official MCP Registry: io.github.CDCStream/captapi
Docs: captapi.com/docs/integrations

What the tools cover

Public data only: nothing behind a login. For LinkedIn, only pages visible without signing in.

As of October 2026 the server lists 178 tools. Tool names follow <platform>_<action>, for example youtube_transcript, tiktok_comments or instagram_profile.

View the full README on GitHub

Details

Repository: github.com/cdcstream/captapi-mcp
Website: captapi.com
Categories: Data & Analytics, Media & Entertainment
Package: @captapi/mcp
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active
Tools verified: Nov 6, 2026

Related Data & Analytics MCP servers

View all

Swiss Living Indexch.swisslivingindex/swiss-living-indexOfficial Swiss data for all 26 cantons and 2,100 communes: tax, rent, health premiums, fuel, jobs.0stars

indiebiz-evidencechilayt/indiebiz-evidenceCross-check collected data across sources, with provenance, before trusting it. Zero-dependency MCP.0stars

Lithium Vault Mcpciinkwia/lithium-vault-mcpPrimary-source lithium & battery-metals mining data (AISC, reserves, filings) via x402.0stars

Nephyr Backtestclm-studios/nephyr-backtestPrediction market strategy backtesting with real on-chain Polymarket data0stars

Clonvoclonvodotcom/mcpWeb search, scraping, crawling, research, a browser agent, and company and people data.0stars

Billparsecloudcorprecords/billparseTurn invoice PDFs, scans and photos into checked spreadsheets and structured data.0stars