ZV-2026-0228 · 2026-08-20 · api.captapi.com

api.captapi.com: Type of details on facebook_marketplace_search changed string → boolean.

breaking

What changed

Type of details on facebook_marketplace_search changed string → boolean. Field audio_id was removed from instagram_reels_by_audio_id input; consumers still sending it may be rejected or silently ignored. New required field audioId on instagram_reels_by_audio_id; requests without it will fail. Field limit was removed from spotify_podcast input; consumers still sending it may be rejected or silently ignored. Type of period on tiktok_popular_songs changed string → integer. Type of cursor on tiktok_search_users changed integer → string.

What to do

If your agents call api.captapi.com, pin the new snapshot, patch the affected call sites, and let a green contract check confirm the fix. If you don't use the changed tools, nothing is required, but the rest of the ecosystem just learned about it at the same moment you did.

The redline

string
+  boolean   facebook_marketplace_search
audio_id  Field audio_id was removed from instagram_reels_by_audio_id input; consumers still sending it may be rejected or silently ignored.
audioId  New required field audioId on instagram_reels_by_audio_id; requests without it will fail.
limit  Field limit was removed from spotify_podcast input; consumers still sending it may be rejected or silently ignored.
string
+  integer   tiktok_popular_songs
integer
+  string   tiktok_search_users
Get current Captapi credit balance and plan limits. Costs ~0 credits; cached results are f…
+  Plan, subscription vs top-up credits, monthly quota, and renewsAt — 0 credits. Costs 0 cre…   account_balance
Daily request and credit usage summary. Costs ~0 credits; cached results are free, failure…
+  Day-by-day credit usage for spend monitoring (0 credits). Costs 0 credits. Empty results a…   account_daily_usage
Most used API routes by request count and credits. Costs ~0 credits; cached results are fr…
+  Ranked list of which Captapi routes your key calls most (0 credits). Costs 0 credits. Empt…   account_most_used_routes
Live request log with requestId, creditsUsed, cacheHit. Filter by endpoint/statusCode/sinc…
+  Recent API requests for your key — requestId, status, credits, cacheHit (0 credits). Costs…   account_request_history
+  cursor  Optional field cursor was added to account_request_history; may shift model behaviour.
Amazon seller storefront products with price, badges, scrapedAt, and cursor pagination. Co…
+  Third-party seller storefronts (/sp?seller= / /s?me=) — ASIN + canonical /dp URLs, price, …   amazon_shop_page
Same analytics/post object per URL (up to 10). 1 credit per resolved URL; cache hits free.…
+  Compare unified metrics across up to 10 URLs — each row is the analytics/post object (1 cr…   analytics_compare
Unified metrics for one post across 11 platforms (auto-detect). engagementRateBasis + comm…
+  Unified metrics for one post, video, or reel — platform auto-detected (1 credit). Costs 1 …   analytics_post
Metadata + engagement for a Bluesky post. Costs ~1 credit; cached results are free, failur…
+  Post thread via getPostThread — nested replies[], facet links/mentions/hashtags, rich auth…   bluesky_post_details
+  depth  Optional field depth was added to bluesky_post_details; may shift model behaviour.
Bluesky profile — counts, banner, verification{}, labels[], associated{}. Costs ~1 credit;…
+  Bluesky profile — handle, did, bio, counts, banner, verification{}, labels[], and associat…   bluesky_profile
+  cacheMaxAge  Optional field cacheMaxAge was added to bluesky_profile; may shift model behaviour.
Recent posts from a Bluesky profile — text, author, likes, reposts, embeds; cursor paginat…
+  Author feed — posts and reposts (isRepost marked), quote/external/images embeds, opaque cu…   bluesky_user_posts
+  filter  Optional field filter was added to bluesky_user_posts; may shift model behaviour.
+  includeReposts  Optional field includeReposts was added to bluesky_user_posts; may shift model behaviour.
Meta/Facebook ad details. Costs ~2 credits; cached results are free, failures are never ch…
+  One Meta ad by ID — same creative as search, plus delivery breakdowns when Meta publishes …   facebook_ad_library_ad_details
Returns the ad's written copy — headline, body text, CTA and landing URL. Meta does not ex…
+  Written creative copy from a Meta ad — headline, body, CTA, landing URL. Not a speech tran…   facebook_ad_library_ad_transcript
Ads for a Facebook page or Meta Ad Library URL. Costs ~2 credits; cached results are free,…
+  Company Ads Costs 2 credits. Empty results and failures are never charged. Pass cache=true…   facebook_ad_library_company_ads
Search Meta/Facebook ads by keyword with status, media, date, and sort filters. Costs ~2 c…
+  Search Meta Ad Library by keyword — active/inactive, media type, date range, platforms, cu…   facebook_ad_library_search
+  cursor  Optional field cursor was added to facebook_ad_library_search; may shift model behaviour.
+  platforms  Optional field platforms was added to facebook_ad_library_search; may shift model behaviour.
+  trim  Optional field trim was added to facebook_ad_library_search; may shift model behaviour.
Find advertisers/pages in the Meta Ad Library by name. Costs ~2 credits; cached results ar…
+  Find Meta Ad Library pages by brand — name-matched, pageId for company-ads (not profileId)…   facebook_ad_library_search_companies
Replies to a Facebook comment — same author/reactions shape as comments. Costs ~2 credits;…
+  Comment Replies Costs 2 credits. Empty results and failures are never charged. Pass cache=…   facebook_comment_replies
Facebook comments — 10-type reactions{}, stable author.id, replyCount, hasMore. Costs ~2 c…
+  Facebook post comments with reactionCount, reactions.like when mixed, author.id (pfbid), a…   facebook_comments
Facebook post or Reel details — engagement, author id, SD/HD video, captions, and music wh…
+  Facebook post or Reel — caption, engagement, author id, video{} playback, and music when F…   facebook_details
Facebook event — title, local start/end, timezone, place, hosts, attendance when exposed. …
+  Get a Facebook event — title, local start/end, timezone, place, host id, and attendance wh…   facebook_event_details
Search Facebook events by topic/city — same Event shape as details/profile-events. 2 credi…
+  Search Facebook events by topic and city — local startDate/timezone, venue. 2 credits. Cos…   facebook_event_search
Public Facebook group posts — author IDs, permalink, sortBy, engagement (shares null when …
+  Public Facebook group posts — listingHits / hydrateFailures / hydrateSkipped, sortBy, and …   facebook_group_posts
Marketplace listing details — title, price, status, seller when exposed. Flat 2 credits. C…
+  Marketplace listing — title, priceAmount, status, seller{}, condition, coords (2 credits).…   facebook_marketplace_item
Disambiguate city names into Marketplace hubs — id + lat/lng. Bare cities use a local tabl…
+  Disambiguate city names into Marketplace hubs — id + lat/lng. Flat 2 credits. Costs 2 cred…   facebook_marketplace_location_search
Search Facebook Marketplace listings by keyword and city name. Costs ~2 credits; cached re…
+  Search Marketplace by keyword + city — filters, isLocal/shipsOutsideRadius, opaque cursor …   facebook_marketplace_search
Facebook page profile — distinct likes vs followers, talkingAbout, category, website, publ…
+  Facebook page profile — likes vs followers (distinct), talkingAbout, category, website, an…   facebook_page_details
List a Facebook Page's events — same Event shape as search/details. 2 credits native (~2/r…
+  List a Facebook Page's events — local startDate, timezone, venue. 2 credits. Costs 2 credi…   facebook_profile_events
Photos from a Facebook profile or page. Costs ~12 credits; cached results are free, failur…
+  Photo grid from a Facebook Page — full image URL plus accessibilityCaption (alt-text, not …   facebook_profile_photos
Latest posts from a Facebook profile/page. Costs ~12 credits; cached results are free, fai…
+  Latest posts and Reels from a Facebook page — listingHits / timings.phase; 60s deadline, f…   facebook_profile_posts
Latest page Reels with full engagement; newest-first, archive cliff. Costs ~2 credits; cac…
+  Latest Facebook page Reels — views, likes, comments, shares; newest-first without archive …   facebook_profile_reels
AI summary of a Facebook video or post. Costs ~4 credits; cached results are free, failure…
+  Summarizer Costs 4 credits. Empty results and failures are never charged. Pass cache=true …   facebook_summarize
Public events with typed payload (Push commits/ref, PR/issue action). 90-event ceiling; op…
+  Public events with typed payload (Push commits/ref, PR/issue action) — 90-event ceiling. C…   github_activity
Real contribution graph — totalContributions, currentStreak, days[{date,count,level}] from…
+  GitHub contribution graph — sorted days[], currentStreak (today grace), longestStreak (2 c…   github_contributions
Follower cards {id,login,type,url,avatar}. ~0.1/row; opaque Link cursor. Large accounts ex…
+  Follower cards {id, login, type, url, avatar} — ~0.1/row; large accounts are expensive to …   github_followers
Same card and ~0.1/row pricing as followers. Opaque Link cursor. Costs ~3 credits; cached …
+  Accounts a user follows — same card and ~0.1/row pricing as followers. Costs ~3 credits (0…   github_following
List PRs with draft, labels, author{}, head/base; state echoed; opaque Link cursor. Costs …
+  List repo PRs — draft, labels, author{}, head/base, opaque Link cursor (state echoed). Cos…   github_pull_requests
List repos with sort/direction/type echoed; opaque Link cursor. parent/watchers only on gi…
+  List a user's repos with sort/direction/type — opaque Link cursor (~0.4/repo). Costs ~12 c…   github_repositories
Repo details — stars, real watchers (subscribers), openIssuesAndPrs, license (NOASSERTION→…
+  GitHub repo — stars, real watchers (subscribers), openIssuesAndPrs, license, parent when f…   github_repository
github.com/trending/developers — windowed ranks with popularRepo + hydrated followers/bio.…
+  github.com/trending/developers — windowed ranks with popularRepo + followers (2 credits). …   github_trending_developers
github.com/trending — repos ranked by starsGained (since=daily|weekly|monthly), not all-ti…
+  github.com/trending — repos ranked by starsGained (daily|weekly|monthly), not all-time sta…   github_trending_repositories
Public GitHub profile as camelCase JSON (type User|Organization, email when public). 1 cre…
+  GitHub public profile — login, type User|Organization, email when public, followers (1 cre…   github_user
Google publishes spend and impression ranges only for election ads in regions that require…
+  Google publishes spend and impression ranges only for election ads; commercial advertisers…   google_ad_library_ad_details
Search Google Ads advertisers. Costs ~1 credit; cached results are free, failures are neve…
+  Find Google Ads Transparency AR… entities — ranked multi-result (1 credit when found; empt…   google_ad_library_advertiser_search
Google publishes spend and impression ranges only for election ads in regions that require…
+  Google publishes spend and impression ranges only for election ads; commercial advertisers…   google_ad_library_company_ads
+  sort  Optional field sort was added to google_ad_library_company_ads; may shift model behaviour.
+  topic  Optional field topic was added to google_ad_library_company_ads; may shift model behaviour.
Instagram profile by user ID/@handle — camelCase (followers, externalUrl, businessAddress)…
+  Instagram profile by user ID or @handle — camelCase schema aligned with Channel Details (f…   instagram_basic_profile
+  cacheMaxAge  Optional field cacheMaxAge was added to instagram_basic_profile; may shift model behaviour.
Profile info & stats for an Instagram account. Costs ~1 credit; cached results are free, f…
+  Instagram profile stats — fixed key set (null fillers), fbid, bioLinks, isBusinessAccount,…   instagram_channel_details
+  cacheMaxAge  Optional field cacheMaxAge was added to instagram_channel_details; may shift model behaviour.
Latest posts from an Instagram profile. Costs ~6 credits; cached results are free, failure…
+  Latest posts from a public Instagram profile — carousel children[], mediaCount, user{} in …   instagram_channel_posts
Latest Reels from an Instagram profile — url or userId; nextCursor + hasMore. Costs ~6 cre…
+  Latest Reels from a public Instagram profile — pass userId to skip resolve; ceil(n×0.3) cr…   instagram_channel_reels
Comments on an Instagram post or reel. Costs ~45 credits; cached results are free, failure…
+  Get the comments on any Instagram post or Reel — text, author, avatar, likes, and timestam…   instagram_comments
Details for an Instagram post or reel. Costs ~1 credit; cached results are free, failures …
+  Get an Instagram post, Reel or carousel — caption, likes, comments, views, media URLs, aut…   instagram_details
Embed HTML for an Instagram post, reel, or profile. Costs ~1 credit; cached results are fr…
+  Classic Instagram embed snippet — blockquote.instagram-media + embed.js. Drop html into yo…   instagram_embed
Search Instagram posts by hashtag (native grid). Costs ~2 credits; cached results are free…
+  Native Instagram hashtag Explore — Reels-heavy top surface with real likes, views, caption…   instagram_hashtag_search
Persistent Story Highlight albums for a public profile — id, title, cover, owner. Flat 1 c…
+  Persistent Story Highlight albums for a public profile — id, title, cover, owner. Flat 1 c…   instagram_highlights
Items inside one Instagram Story Highlight album — media URLs, type, takenAt. Flat 1 credi…
+  Items inside one Instagram Story Highlight album — media URLs, type, takenAt. Flat 1 credi…   instagram_highlights_details
Resolve a brand or @handle to one Instagram profile with id, bio, links, and stats (not ni…
+  Resolve a brand or @handle to one public Instagram profile — stable id, bio, links, and st…   instagram_profile_search
Reels by audio + isTrendingInClips / trendRank / music{}. Costs ~28 credits; cached result…
+  Is this Instagram sound trending? Reels that use it + isTrendingInClips / trendRank / rich…   instagram_reels_by_audio_id
Native Instagram Reels hashtag search — views/plays, author verified/followers, datePosted…
+  Native Instagram Reels hashtag search — engagement.views + viewsSource, location, commerci…   instagram_reels_search
AI summary of an Instagram Reel. Costs ~4 credits; cached results are free, failures are n…
+  Get an AI summary of any Instagram Reel — a short paragraph plus key points, without watch…   instagram_summarize
Tagged posts — author id, views, hashtags/mentions; cursor pagination. Costs ~1 credit; ca…
+  Posts that tag an Instagram account — author verified/avatar when available, staleFeed whe…   instagram_tagged_posts
Transcript of an Instagram Reel. Costs ~2 credits; cached results are free, failures are n…
+  Turn any Instagram Reel's speech into text — the full transcript plus timestamped segments…   instagram_transcript
Cache-first trending Reels — flat 2 credits every call (4h TTL). Use reels-search for keyw…
+  Cache-first trending Reels — flat 2 credits every call (4h TTL). Costs 2 credits. Empty re…   instagram_trending_reels
Kick clip — creator vs channel, category, maturity, VOD; or recent channel clips. Costs ~1…
+  Get a Kick clip — creator vs channel, HLS playback, VOD deep-link, views, and duration as …   kick_clip
+  cacheMaxAge  Optional field cacheMaxAge was added to kick_clip; may shift model behaviour.
Komi page — id/displayName/bio, socials{} (incl. website), content LINK/PRODUCT rows with …
+  Komi link-in-bio → identity, socials{} (incl. website), content LINK/PRODUCT rows with pri…   komi_page
+  cacheMaxAge  Optional field cacheMaxAge was added to komi_page; may shift model behaviour.
Kwai post metadata and engagement. Costs ~17 credits; cached results are free, failures ar…
+  Single Kwai video — caption ("" when none), hashtags[], author, mp4 (2 credits). Costs 2 c…   kwai_post
Kwai profile — bio, counts, verification, and post privacy flags. Costs ~1 credit; cached …
+  Fetch Kwai profile — display name, bio, counts, and verification as structured JSON. Costs…   kwai_profile
Recent Kwai videos from a profile. Costs ~45 credits; cached results are free, failures ar…
+  Kwai profile posts — caption ("" when none), engagement, mp4 + transcript (~1 credit/post)…   kwai_user_posts
+  cursor  Optional field cursor was added to kwai_user_posts; may shift model behaviour.
lnk.bio page — id, socials{} (often filled where SC is null), titled links[], website/emai…
+  lnk.bio → id, socials{}, titled links[], website/email/whatsapp, other[]. Flat 1 credit. C…   linkbio_page
+  cacheMaxAge  Optional field cacheMaxAge was added to linkbio_page; may shift model behaviour.
One LinkedIn Ad Library ad. LinkedIn withholds Ran-from on most creatives — those keys omi…
+  One LinkedIn Ad Library ad by ID. LinkedIn withholds Ran-from / impressions / targeting on…   linkedin_ad_library_ad_details
LinkedIn Ad Library SERP cards. Run dates/impressions/targeting only on a subset — source …
+  LinkedIn publishes run dates, impressions and targeting only on a subset of creatives. Sea…   linkedin_ad_library_search_ads
+  company  Optional field company was added to linkedin_ad_library_search_ads; may shift model behaviour.
+  paginationToken  Optional field paginationToken was added to linkedin_ad_library_search_ads; may shift model behaviour.
Public LinkedIn company page details. Costs ~2 credits; cached results are free, failures …
+  Company page for B2B intel — specialties, similarPages, employeeCount, founded, slogan, co…   linkedin_company
Recent public posts from a LinkedIn company page, with cursor pagination (nextCursor + has…
+  Company posts with engagement{likes,comments} — cursor pages up to 100. Flat 1 credit on t…   linkedin_company_posts
Metadata + engagement for a LinkedIn post. Costs ~1 credit; cached results are free, failu…
+  Get a LinkedIn post — text, author, reactions, and comments count as structured JSON. Cost…   linkedin_post_details
Extract post text as a transcript for a LinkedIn post. Costs ~1 credit; cached results are…
+  LinkedIn post text as a transcript — paragraph segments, timingSource none. Flat 1 credit.…   linkedin_post_transcript
Public LinkedIn person profile details. Costs ~2 credits; cached results are free, failure…
+  LinkedIn person profile with experience[], education[], similarProfiles[] — masked guest t…   linkedin_profile
Search public LinkedIn posts by keyword — cursor pagination (nextCursor + hasMore) up to 5…
+  Keyword search of public LinkedIn posts — offset cursor, ceiling 50. Costs ~16 credits (0.…   linkedin_search_posts
Public Linkme profile links and metadata. Costs ~4 credits; cached results are free, failu…
+  Linkme profile → bio, profileVisitCount, featured links, webLinks, email/infoLinks, stripe…   linkme_profile
+  cacheMaxAge  Optional field cacheMaxAge was added to linkme_profile; may shift model behaviour.
Public Linktree profile links (incl. GROUP children), socials, email, verticals. Costs ~1 …
+  Link-in-bio → creator graph: typed links, socialAccounts{} that feed TikTok/Instagram/Spot…   linktree_page
+  cacheMaxAge  Optional field cacheMaxAge was added to linktree_page; may shift model behaviour.
Pillar page — id/displayName/bio/location/email, socials{}, links[] with clicks, products[…
+  Pillar link-in-bio → identity, socials{}, links[] with per-link clicks, products[]. Flat 1…   pillar_page
+  cacheMaxAge  Optional field cacheMaxAge was added to pillar_page; may shift model behaviour.
Board pins — cursor pagination (nextCursor + hasMore) up to the pidgets window (~100). ~0.…
+  Pins on a Pinterest board — saves, imageOriginal, destinationUrl, top-level author. ~0.5 c…   pinterest_board
Pin title, description, link, board, originAuthor, images, and engagement (1 credit). Cost…
+  Get a Pinterest pin — title, description, link, board, origin creator, and engagement as s…   pinterest_pin_details
Search Pinterest pins by keyword — cursor pagination up to the SERP window (40). ~0.5 cred…
+  Keyword pin search — offset cursor, SERP window 40. Costs ~13 credits (0.5/result). Empty …   pinterest_search
Boards on a Pinterest profile — cursor pagination (nextCursor + hasMore) up to 200. ~0.5 c…
+  Boards on a Pinterest profile — pinCount, coverImage (474x), privacy, sections. Board foll…   pinterest_user_boards
Pins from a Pinterest profile — cursor pagination (nextCursor + hasMore) up to the pidgets…
+  Pins from a Pinterest profile — offset cursor, pidgets window ~100. Costs ~13 credits (0.5…   pinterest_user_pins
Comments on a Reddit post — cursor pagination (nextCursor + hasMore). Costs ~2 credits; ca…
+  Flat Reddit comment threads with depth/parentId, cursor pagination, and the parent post in…   reddit_post_comments
Metadata + stats for a Reddit post. Costs ~1 credit; cached results are free, failures are…
+  Get a Reddit post — title, body, score, comments count, subreddit, and author as structure…   reddit_post_details
Returns the post's written content — title, body and top comments — as text. Reddit does n…
+  Written post text — title, body and top comments. Not a speech transcript. Flat 2 credits.…   reddit_post_transcript
Site-wide Reddit search with sort/timeframe, scores, authorFullname, cursor. Costs ~2 cred…
+  Reddit site-wide post search — sort + timeframe + cursor, score/upvoteRatio, authorFullnam…   reddit_search
Subreddit card — t5_ id, members, activeUsers, rules[], ISO createdAt. Costs ~1 credit; ca…
+  Subreddit card — id (t5_…), members, activeUsers, rules[], ISO createdAt, nsfw/type. Flat …   reddit_subreddit_details
Posts in a subreddit with sort/timeframe and cursor pagination (nextCursor + hasMore). Cos…
+  List posts from a subreddit with sort, timeframe, and cursor pagination — title, score, up…   reddit_subreddit_posts
Search posts inside one subreddit — not subreddit discovery. Costs ~2 credits; cached resu…
+  Search posts inside one subreddit — not subreddit discovery. Same sort/timeframe as site-w…   reddit_subreddit_search
List videos from a Rumble channel. Costs ~12 credits; cached results are free, failures ar…
+  Rumble channel uploads — lean streams[{url,type}]; call video-details for rendition meta. …   rumble_channel_videos
Comments on a Rumble video. Costs ~30 credits; cached results are free, failures are never…
+  Rumble top-level comments — publishedAt ISO-8601 UTC from title= on the comment time link.…   rumble_comments
Search Rumble videos by keyword. Costs ~12 credits; cached results are free, failures are …
+  Rumble keyword search — same video card shape as channel-videos (type, durationSeconds + d…   rumble_search
Rumble video metadata + stats: real likes/comments (null when unknown), durationSeconds, c…
+  Rumble video metadata — uniform streams[] with rendition meta, captions[], audioStreams. C…   rumble_video_details
Published Rumble captions as timed segments (parses .vtt; not STT). 404 is free. Costs ~1 …
+  Rumble published captions as timed segments — parses the .vtt from video-details (not spee…   rumble_video_transcript
Public Snapchat profile — highlights with snap lists, Spotlight engagement, related accoun…
+  Snapchat profile — unwrapped highlight ids, mediaType image/video, category labels, Spotli…   snapchat_user_profile
SoundCloud artist — bio, counts, badges, creator subscription tier. Costs ~1 credit; cache…
+  SoundCloud artist — handle + name, subscriptionTier, externalLinks, verified (1 credit). C…   soundcloud_artist
+  cacheMaxAge  Optional field cacheMaxAge was added to soundcloud_artist; may shift model behaviour.
Tracks from a SoundCloud artist profile, with cursor pagination (nextCursor + hasMore). Co…
+  Artist track list — opaque cursor, native-window when the api-v2 page ends (2 credits; emp…   soundcloud_artist_tracks
SoundCloud track metadata and engagement stats. Costs ~1 credit; cached results are free, …
+  SoundCloud track — plays/likes/license, tags[], nested artist{}, streamUrl when streamable…   soundcloud_track
+  cacheMaxAge  Optional field cacheMaxAge was added to soundcloud_track; may shift model behaviour.
Spotify album metadata and track count. Costs ~6 credits; cached results are free, failure…
+  Spotify album — tracks[] with playCount, joinable artists[], releaseDate, explicit (1 cred…   spotify_album
+  raw  Optional field raw was added to spotify_album; may shift model behaviour.
Spotify artist — followers, monthlyListeners, worldRank, topCities, topTracks with playCou…
+  Spotify artist — followers, monthlyListeners, worldRank, topCities, topTracks with playCou…   spotify_artist
+  raw  Optional field raw was added to spotify_artist; may shift model behaviour.
Spotify podcast — publisher, rating, topics, explicit, totalEpisodes. Costs ~1 credit; cac…
+  Spotify podcast show — publisher, rating, topics, explicit flag, and totalEpisodes as clea…   spotify_podcast
List episodes for a Spotify podcast/show. Costs ~23 credits; cached results are free, fail…
+  Podcast episode archive — previewUrl, releaseDate, explicit, cursor pagination (flat 2 cre…   spotify_podcast_episodes
+  cursor  Optional field cursor was added to spotify_podcast_episodes; may shift model behaviour.
+  raw  Optional field raw was added to spotify_podcast_episodes; may shift model behaviour.
Search Spotify by type (tracks/albums/artists/podcasts/episodes) - canonical URIs, explici…
+  Search Spotify — canonical spotify: URIs, explicit, fetchedAt (flat 2 credits). Costs 2 cr…   spotify_search
+  raw  Optional field raw was added to spotify_search; may shift model behaviour.
Spotify track — playCount, artist/album IDs, explicit rating. Costs ~1 credit; cached resu…
+  Spotify track — playCount, joinable artists[]/album{}, explicit, releaseDate (1 credit). C…   spotify_track
+  raw  Optional field raw was added to spotify_track; may shift model behaviour.
Metadata + engagement for a Threads post. Costs ~1 credit; cached results are free, failur…
+  Threads post — engagement (views when exposed), comments[], relatedPosts[], threadId/isRep…   threads_post_details
Threads profile — bio, followers, verified, isPrivate, bioLinks, transparencyLabel, HD ava…
+  Threads profile — displayName, private/isPrivate, bioLinks (Meta verified), isThreadsOnlyU…   threads_profile
Threads keyword search — flat 2 native (~0.7/post Apify). Meta Top SERP; no sort/date. Cos…
+  Threads keyword search — posts with engagement + media. Flat 2 credits. Costs 2 credits. E…   threads_search
Distinct authors from keyword search — id, avatar, verified. Flat 1 native. Costs ~1 credi…
+  Threads user discovery from keyword search — id, handle, avatar, verified. Flat 1 credit. …   threads_search_users
Recent Threads posts — views+engagement, threadId/isReply. Flat 2 native. Costs ~2 credits…
+  Recent Threads posts — engagement{views,likes,replies,reposts,quotes}, threadId/isReply. F…   threads_user_posts
TikTok ad details by ad URL or ID. Always 2 credits; fetchPath native|fallback. Costs ~2 c…
+  One TikTok Commercial Content Library ad by ID — calendar-day dates, always 2 credits. Cos…   tiktok_ad_library_ad_details
EU DSA Ad Library search — match=any|all, matchedFrom/filteredOut, empty free, ~40s cap. C…
+  Search TikTok Commercial Content Library — relevance-filtered, uniform null schema (2 cred…   tiktok_ad_library_search
Creative Center Top Ads — browser list XHR early-exit, 30–60s typical; flat 2 / ~1 Apify. …
+  TikTok Creative Center Top Ads — one ~20-row leaderboard page, not a library search (flat …   tiktok_ad_library_top_ads
Ranked country breakdown of a TikTok creator's audience, based on people who comment on th…
+  Audience country + language mix for a TikTok creator — engagement sample, not a follower c…   tiktok_audience_demographics
+  countriesLimit  Optional field countriesLimit was added to tiktok_audience_demographics; may shift model behaviour.
+  videos  Optional field videos was added to tiktok_audience_demographics; may shift model behaviour.
Resolve @handle → id + secUid; createTime, ttSeller, bioLink.risk, category, commerce flag…
+  Resolve a TikTok @handle to id + secUid — createTime, ttSeller, bioLink, decoded privacy f…   tiktok_channel_details
+  cacheMaxAge  Optional field cacheMaxAge was added to tiktok_channel_details; may shift model behaviour.
+  raw  Optional field raw was added to tiktok_channel_details; may shift model behaviour.
Latest videos from a TikTok profile — caption, engagement, thumbnail, sound, and hashtags …
+  Latest videos from a TikTok profile. May return a labelled 6h-stale snapshot (degraded + s…   tiktok_channel_posts
Replies under a TikTok comment — text, author, likes, timestamp, with cursor pagination (n…
+  Replies under a TikTok comment — same authorId/authorSecUid/commentLanguage shape as comme…   tiktok_comment_replies
Comments on a TikTok video — text, author, avatar, likes, and timestamp, plus totalComment…
+  TikTok comments — clean schema plus authorName, stable authorId/authorSecUid and commentLa…   tiktok_comments
isLive/status, creator.id/secUid, streamQualities with flv/hls/cmaf/dash. Flat 1 credit. C…
+  Is this TikTok creator live — isLive/status, creator.id/secUid, room, streamQualities with…   tiktok_live
True alias of /live (same payload) at 7 credits. Costs ~7 credits; cached results are free…
+  Identical to TikTok Live (isLive, creator.id/secUid, streamQualities hls/cmaf). Costs 7 cr…   tiktok_live_info
Posts using a specific TikTok sound/music. Costs ~32 credits; cached results are free, fai…
+  List TikTok videos that use a specific sound — caption, author, exact engagement, canonica…   tiktok_music_posts
+  cursor  Optional field cursor was added to tiktok_music_posts; may shift model behaviour.
Popular TikTok creators by country and ranking mode. Costs ~28 credits; cached results are…
+  Creative Center creators + createTime / bioLinkRisk / ttSeller hydrate for partnership vet…   tiktok_popular_creators
+  cacheMaxAge  Optional field cacheMaxAge was added to tiktok_popular_creators; may shift model behaviour.
+  page  Optional field page was added to tiktok_popular_creators; may shift model behaviour.
TikTok Creative Center hashtag chart (population videoCount). Costs ~2 credits; cached res…
+  TikTok Creative Center hashtag chart — real videoCount/totalPlays, plus rankDiff and trend…   tiktok_popular_hashtags
+  country  Optional field country was added to tiktok_popular_hashtags; may shift model behaviour.
+  industryId  Optional field industryId was added to tiktok_popular_hashtags; may shift model behaviour.
+  newOnBoard  Optional field newOnBoard was added to tiktok_popular_hashtags; may shift model behaviour.
+  page  Optional field page was added to tiktok_popular_hashtags; may shift model behaviour.
+  period  Optional field period was added to tiktok_popular_hashtags; may shift model behaviour.
+  sortBy  Optional field sortBy was added to tiktok_popular_hashtags; may shift model behaviour.
Creative Center popular/surging sounds — rankDiff, trend[], commercialMusic. Flat 2 credit…
+  Creative Center popular/surging sounds — rankDiff, trend[], commercialMusic. 110s deadline…   tiktok_popular_songs
Where a TikTok creator is likely based and what language they use — country, language, and…
+  Find out where a TikTok creator is likely based and what language they use — country, lang…   tiktok_profile_region
+  raw  Optional field raw was added to tiktok_profile_region; may shift model behaviour.
Search TikTok videos by hashtag — video URL, caption, author, and engagement counts per re…
+  Videos from TikTok's /tag/{name} challenge feed — not keyword or username search. Cursor +…   tiktok_search_by_hashtag
The autocomplete terms TikTok suggests in its search bar for a seed keyword — the real phr…
+  Get the autocomplete terms TikTok suggests in its search bar for a keyword — the real phra…   tiktok_search_suggestions
Search TikTok users — id, secUid, followers/following, verified, sample videos; cursor pag…
+  Search TikTok users — distinct creators only, id + secUid, per-counter isApproximate flags…   tiktok_search_users
+  fallback  Optional field fallback was added to tiktok_search_users; may shift model behaviour.
PDP with price/originalPrice/discount, skus[]+saleProps, images, categories. 2 credits nat…
+  PDP — price/originalPrice/typed discount, images[], skus[] with per-variant stock + salePr…   tiktok_shop_product_details
Shop product reviews — stars, text, SKU, verified, country, review photos. Not video comme…
+  TikTok Shop product reviews — star rating, text, SKU variant, verified purchase, country, …   tiktok_shop_product_reviews
Store catalog + shopInfo. Flat 2 credits on native SSR (limit does not multiply). Costs ~2…
+  Store catalog with shopInfo (sold/followers/rating) + products priced with sold, rating, t…   tiktok_shop_products
+  region  Optional field region was added to tiktok_shop_products; may shift model behaviour.
TikTok Shop keyword search — SERP window of 10 PDP links (windowMax=10). limit default 10,…
+  TikTok Shop keyword search — priced products with sold, rating/reviews, typed discount, se…   tiktok_shop_search
Creator affiliate shelf — sold, rating, originalPrice, seller name/url (PDP-hydrated). Cos…
+  Creator Shop showcase — affiliate shelf products with per-product sold, rating, typed disc…   tiktok_shop_user_showcase
Sound metadata — usageCount, artists[], commerce rights, chorus timing; 1 credit native. C…
+  TikTok sound metadata — usageCount, artists[{id,secUid,handle}], audio{bpm,loudness,beats}…   tiktok_song_details
AI summary of a TikTok video. Costs ~4 credits; cached results are free, failures are neve…
+  Summarizer Costs 4 credits. Empty results and failures are never charged. Pass cache=true …   tiktok_summarize
Top/General search: videos + photo carousels (contentType/images), cursor pagination. Cost…
+  TikTok Top/General search — videos and photo carousels when TikTok includes them, with con…   tiktok_top_search
+  cursor  Optional field cursor was added to tiktok_top_search; may shift model behaviour.
Transcript of a TikTok video (via captions). Costs ~2 credits; cached results are free, fa…
+  Transcript Costs 2 credits. Empty results and failures are never charged. Pass cache=true …   tiktok_transcript
TikTok trending (For You) videos by region. Costs ~2 credits; cached results are free, fai…
+  For You by default; pass orderBy/period/page for Creative Center popular videos (like/hot/…   tiktok_trending_feed
+  countryCode  Optional field countryCode was added to tiktok_trending_feed; may shift model behaviour.
+  orderBy  Optional field orderBy was added to tiktok_trending_feed; may shift model behaviour.
+  page  Optional field page was added to tiktok_trending_feed; may shift model behaviour.
+  period  Optional field period was added to tiktok_trending_feed; may shift model behaviour.
Followers — id, secUid, createTime, region, language; total + nextCursor. Flat 1 credit na…
+  List a TikTok user's followers — id, secUid, createTime, region, language, cursor paginati…   tiktok_user_followers
Followings — id, secUid, createTime, region, language; total + nextCursor. Flat 1 credit n…
+  List who a TikTok user follows — id, secUid, createTime, region, language, cursor paginati…   tiktok_user_followings
Metadata + stats for a TikTok video. Costs ~1 credit; cached results are free, failures ar…
+  Get everything about one TikTok video from its URL — caption, view/like/comment/share/save…   tiktok_video_details
Truth Social post metadata, text, media and engagement. Costs ~5 credits; cached results a…
+  One Truth — text, links[], card, reblog/quote chain, media.meta, externalVideoId. Flat 1 c…   truth_social_post
Public Truth Social profile (bot/isPrivate/group, static media, emojis). Prominent account…
+  Prominent public Truth Social profiles — isPrivate/bot/group, fields[], avatar/banner. Fla…   truth_social_profile
Recent public posts from a Truth Social profile, with cursor pagination (nextCursor + hasM…
+  Recent Truths — same post mapper as /post (links, card, reblog/quote, mentions). 2 credits…   truth_social_user_posts
Twitch clip — curator vs channel, qualities, token expiry. Costs ~1 credit; cached results…
+  Twitch clip — curator vs channel, signedVideoUrl, unwrapped token, relatedClips (1 credit)…   twitch_clip
+  cacheMaxAge  Optional field cacheMaxAge was added to twitch_clip; may shift model behaviour.
Twitch channel — live stream, last broadcast, recent videos with embedUrl, game box art, s…
+  Twitch channel — handle + displayName, socials[], topClips, schedule preview, stream only …   twitch_profile
+  cacheMaxAge  Optional field cacheMaxAge was added to twitch_profile; may shift model behaviour.
Upcoming Twitch schedule data when exposed on the public channel. Costs ~1 credit; cached …
+  Twitch channel schedule — startAt/endAt, title, game, isRecurring (0 credits when empty). …   twitch_user_schedule
+  limit  Optional field limit was added to twitch_user_schedule; may shift model behaviour.
Channel VODs with filterBy/sortBy, cursor, broadcaster id/followers. Costs ~2 credits; cac…
+  Twitch channel VODs — lean rows, video-id cursor, filter/sort, top-level broadcaster{} (fl…   twitch_user_videos
Details for an X (Twitter) community. Costs ~1 credit; cached results are free, failures a…
+  X Community metadata — ISO createdAt, flat creator handle, isNsfw + bannerImage, rules[]. …   twitter_community
Community posts — flat 2 native; ~0.7/tweet Apify fallback. Costs ~2 credits; cached resul…
+  Posts in an X Community — same 6-metric tweet shape as search. Flat 2 credits. Costs 2 cre…   twitter_community_tweets
X profile with blue/identity/affiliate verification, listed/media/likes counts, banner, pi…
+  X profile: verified + blue/legacy/identity, displayName, avatar/banner, tipjar→contact{}, …   twitter_profile
+  cacheMaxAge  Optional field cacheMaxAge was added to twitter_profile; may shift model behaviour.
Extract tweet text as transcript text. Costs ~1 credit; cached results are free, failures …
+  Tweet text as a transcript — timingSource none (not Whisper). Flat 1 credit. Costs 1 credi…   twitter_transcript
Metadata + engagement stats for a tweet. Costs ~1 credit; cached results are free, failure…
+  One tweet as JSON — text, author (followers), likes/replies/retweets/quotes, media, ISO pu…   twitter_tweet_details
Recent tweets from a Twitter/X profile. Costs ~2 credits; cached results are free, failure…
+  Most popular public tweets from a Twitter/X profile (~100 cap) — not chronological. Text, …   twitter_user_tweets
POST multipart Whisper + AI summary PLUS full transcript. durationSeconds/creditsCharged. …
+  Whisper + AI summary of an uploaded file — transcript included; 1 credit/min + 1. Costs 1 …   video_summarize
POST multipart Whisper transcript. Returns language, durationSeconds, creditsCharged. 1 cr…
+  Whisper transcription of an uploaded file — 1 credit/min; noSpeech=true and 0 credits when…   video_transcript
Whisper-class speech-to-text for YouTube audio (Groq turbo when configured). 2 credits/min…
+  Speech-to-text for YouTube audio. Use it when a video has no captions — or when you want a…   youtube_audio_transcript
Channel info & numeric stats for a YouTube channel — plus handle, verified, links, email, …
+  YouTube channel stats — ISO country, createdAt date-only, real banner or null, quote-aware…   youtube_channel_details
Channel playlists with cursor — id, title, totalVideos, thumbnailUrl. Costs ~2 credits; ca…
+  Channel playlists with cursor pagination — id, title, totalVideos, thumbnailUrl. Flat 2 cr…   youtube_channel_playlists
Channel Shorts with cursor pagination — same row shape as channel-videos. Costs ~2 credits…
+  Channel Shorts with cursor pagination — same row shape as channel-videos (exact publishedA…   youtube_channel_shorts
Channel Live tab only — 0 credits when hasLiveTab=false; flat 2 when streams are fetched. …
+  Channel Live tab only — liveStatus per row; 0 credits when hasLiveTab is false. Costs 2 cr…   youtube_channel_streams
Channel uploads with cursor pagination — exact publishedAt via reel_item_watch. Costs ~2 c…
+  Channel uploads with cursor pagination — exact publishedAt from reel_item_watch (same as c…   youtube_channel_videos
Top-level comment replies — parentReplyCount + cursor; nested reply ids 404. Costs ~2 cred…
+  Replies under a top-level comment — parentReplyCount + cursor. Nested reply ids return 404…   youtube_comment_replies
Comments on a YouTube video, with cursor pagination (nextCursor + hasMore). Costs ~2 credi…
+  Get comments on any YouTube video — text, author, likes, and truncated publishedTimeApprox…   youtube_comments
One community post — list schema + commentCount trio + isEdited. Costs ~1 credit; cached r…
+  One community post — list schema + commentCount trio + isEdited. Costs 1 credit. Empty res…   youtube_community_post_details
Community posts — channel{}, publishedTimeApprox, likeCountIsApproximate, linkedVideos[], …
+  Community posts — channel{}, publishedTimeApprox, likeCountIsApproximate, linkedVideos[], …   youtube_community_posts
Hashtag page feed — nested channel{}, viewCountIsApproximate; fixed shelf, billed per resu…
+  Videos from youtube.com/hashtag/{name} — nested channel{}, viewCountIsApproximate. Not key…   youtube_hashtag_search
Playlist metadata only — title, channel{}, totalVideos, thumbnailUrl (no videos[]). Costs …
+  Playlist metadata only — title, channel{}, totalVideos, thumbnailUrl. No videos[]. Flat 1 …   youtube_playlist
Paginated playlist contents — cursor/nextCursor/hasMore, same row shape as channel-videos.…
+  Paginated playlist contents — cursor/nextCursor/hasMore, same row shape as channel-videos.…   youtube_playlist_videos
YouTube search — typed hits, ids, canonical URLs, cursor pagination, filters. Costs ~2 cre…
+  YouTube search with cursor pagination — typed hits, ids, canonical URLs, filters (2 credit…   youtube_search
Comments on a YouTube Short — same engine as /comments (flat 2 credits). Costs ~2 credits;…
+  Comments on a YouTube Short — rejects long-form videos (≤3 min only). Costs 2 credits. Emp…   youtube_shorts_comments
Same schema as Video Details for a Short (isShort:true); long-form returns 422. Costs ~1 c…
+  YouTube Short metadata — same schema as Video Details, with isShort:true; long-form videos…   youtube_shorts_details
AI summary of a YouTube Short. Costs ~3 credits; cached results are free, failures are nev…
+  AI summary of a YouTube Short — rejects long-form videos (≤3 min only). Costs 3 credits. E…   youtube_shorts_summarize
Transcript of a YouTube Short. Costs ~1 credit; cached results are free, failures are neve…
+  Transcript for a YouTube Short — rejects long-form videos (≤3 min only). Costs 1 credit. E…   youtube_shorts_transcript
AI summary (key points, topics, sentiment) of a YouTube video. Costs ~3 credits; cached re…
+  GPT summary from YouTube's published captions — same source as /transcript. Flat 3 credits…   youtube_summarize
YouTube published captions (not STT). 404 is free; see audio-transcript for ASR. Costs ~1 …
+  YouTube's published captions with timestamps — not speech-to-text. Flat 1 credit; 404 is f…   youtube_transcript
Shorts reel_watch_sequence — fixed window per call (no cursor), not a keyword search. Cost…
+  YouTube Shorts recommendation sequence — fixed window per call (no cursor), not a global c…   youtube_trending_shorts
Metadata + engagement stats for a YouTube video. Costs ~1 credit; cached results are free,…
+  YouTube video metadata + stats. Always includes degraded / degradedReason — retry when deg…   youtube_video_details
SponsorBlock segments (CC BY-NC-SA 4.0) — source/license disclosed; empty bills 0. Costs ~…
+  SponsorBlock community segments — free while the CC BY-NC-SA commercial-use exception is p…   youtube_video_sponsors
Full api.captapi.com changelog →JSON feedWatch this for my agents