# Captapi endpoints

> 190 endpoints, one per line: METHOD path | credit cost | what it does.
> Generated from https://captapi.com/openapi.json, which has every parameter and response schema.

Base URL: https://api.captapi.com
Auth: Authorization: Bearer capt_live_... (or X-API-Key). A human creates keys at https://captapi.com/dashboard/api-keys.
Failed requests (4xx/5xx) are not billed. X-Captapi-Credits on each response shows what was charged.
Empty results: on many list and search endpoints a call that found nothing costs 0 credits; where an empty result is still billed, the endpoint description says so.
Variable cost: a cost with "fallback" in it rises when a slower fallback path serves the call; the spec's x-credit-cost.note has the full rule.

## Account

GET /v1/account/balance | 0 credits | Plan, subscription vs top-up credits, monthly quota, and renewsAt — 0 credits.
GET /v1/account/request-history | 0 credits | Recent API requests for your key — requestId, status, credits, cacheHit (0 credits).
GET /v1/account/daily-usage | 0 credits | Day-by-day credit usage for spend monitoring (0 credits).
GET /v1/account/most-used-routes | 0 credits | Ranked list of which Captapi routes your key calls most (0 credits).
GET /v1/account/usage | 0 credits | Your live credit balance plus your most recent requests (endpoint, credits used, cache hit, status code, response time), newest first.
GET /v1/account/limits | 0 credits | Plan name, monthly quota, remaining subscription and top-up credits, and the per-minute rate limit for the calling key.

## Amazon Shop

GET /v1/amazon-shop/page | 1 credit per 16 products (default limit 20 = 2) | Third-party seller storefronts (/sp?seller= / /s?me=) — ASIN + canonical /dp URLs, price, badges.

## Batch

POST /v1/batch | Sum of the items; each is billed like a direct call | Runs up to 20 Captapi GET calls in one request, 10 at a time, through the same auth, credit, cache and rate-limit pipeline as direct calls.

## Bluesky

GET /v1/bluesky/profile | 1 credit | Bluesky profile — handle, did, bio, counts, banner, verification{}, labels[], and associated{} (1 credit).
GET /v1/bluesky/user-posts | ~3 credits (0.1/result) | Author feed — posts and reposts (isRepost marked), quote/external/images embeds, opaque cursor.
GET /v1/bluesky/post-details | 1 credit | Post thread via getPostThread — nested replies[], facet links/mentions/hashtags, rich author (1 credit).

## Facebook

GET /v1/facebook/details | 2 credits | Facebook post or Reel — caption, engagement, author id, video{} playback, and music when Facebook exposes them.
GET /v1/facebook/summarize | 4 credits | Turn any Facebook video into an AI summary with key points, topics, and sentiment.
GET /v1/facebook/comments | 2 credits | Facebook post comments with reactionCount, reactions.like when mixed, author.id (pfbid), and replyCount.
GET /v1/facebook/page-details | 2 credits | Facebook page profile — likes vs followers (distinct), talkingAbout, category, website, and public email.
GET /v1/facebook/profile-posts | 2 credits | Latest posts and Reels from a Facebook page — listingHits / timings.phase; 60s deadline, failures 0 credits.
GET /v1/facebook/profile-reels | 2 credits | Latest Facebook page Reels — views, likes, comments, shares; newest-first without archive padding.
GET /v1/facebook/group-posts | 2 credits | Public Facebook group posts — listingHits / hydrateFailures / hydrateSkipped, sortBy, and per-count *IsApproximate.
GET /v1/facebook/comment-replies | 2 credits | Pull replies under a Facebook comment — author, text, likes, and time.
GET /v1/facebook/profile-photos | 2 credits | Photo grid from a Facebook Page — full image URL plus accessibilityCaption (alt-text, not a post caption).

## Facebook Ad Library

GET /v1/ad-library/facebook/search | 2 credits | Search Meta Ad Library by keyword — active/inactive, media type, date range, platforms, cursor, and spend/impressions when Meta publishes them.
GET /v1/ad-library/facebook/company-ads | 2 credits | Ads for one Meta page — active by default, cursor through the HTML batch, same envelope as /facebook/search.
GET /v1/ad-library/facebook/search-companies | 2 credits | Find Meta Ad Library pages by brand — name-matched, pageId for company-ads (not profileId).
GET /v1/ad-library/facebook/ad-details | 2 credits | One Meta ad by ID — same creative as search, plus delivery breakdowns when Meta publishes them.
GET /v1/ad-library/facebook/ad-transcript | 2 credits | Written creative copy from a Meta ad — headline, body, CTA, landing URL.

## Facebook Events

GET /v1/facebook/event-search | 2 credits | Search Facebook events by topic and city — local startDate/timezone, venue.
GET /v1/facebook/event-details | 2 credits | Get a Facebook event — title, local start/end, timezone, place, host id, and attendance when exposed.
GET /v1/facebook/profile-events | 2 credits | List a Facebook Page's events — local startDate, timezone, venue.

## Facebook Marketplace

GET /v1/facebook/marketplace-search | 2 credits | Search Marketplace by keyword + city — filters, isLocal/shipsOutsideRadius, opaque cursor (2 credits).
GET /v1/facebook/marketplace-location-search | 2 credits | Disambiguate city names into Marketplace hubs — id + lat/lng.
GET /v1/facebook/marketplace-item | 2 credits | Marketplace listing — title, priceAmount, status, seller{}, condition, coords (2 credits).

## GitHub

GET /v1/github/user | 1 credit | GitHub public profile — login, type User|Organization, email when public, followers (1 credit).
GET /v1/github/repositories | ~12 credits (0.4/result) | List a user's repos with sort/direction/type — opaque Link cursor (~0.4/repo).
GET /v1/github/pull-requests | ~12 credits (0.4/result) | List repo PRs — draft, labels, author{}, head/base, opaque Link cursor (state echoed).
GET /v1/github/activity | ~12 credits (0.4/result) | Public events with typed payload (Push commits/ref, PR/issue action) — 90-event ceiling.
GET /v1/github/followers | ~3 credits (0.1/result) | Follower cards {id, login, type, url, avatar} — ~0.1/row; large accounts are expensive to page fully.
GET /v1/github/following | ~3 credits (0.1/result) | Accounts a user follows — same card and ~0.1/row pricing as followers.
GET /v1/github/contributions | 2 credits | GitHub contribution graph — sorted days[], currentStreak (today grace), longestStreak (2 credits).
GET /v1/github/repository | 1 credit | GitHub repo — stars, real watchers (subscribers), openIssuesAndPrs, license, parent when fork (1 credit).
GET /v1/github/trending-repositories | 2 credits | github.com/trending — repos ranked by starsGained (daily|weekly|monthly), not all-time stars (2 credits).
GET /v1/github/trending-developers | 2 credits | github.com/trending/developers — windowed ranks with popularRepo + followers (2 credits).

## Google Ad Library

GET /v1/ad-library/google/company-ads | 2 credits | Google publishes spend and impression ranges only for election ads; commercial advertisers omit both.
GET /v1/ad-library/google/ad-details | 2 credits | Google publishes spend and impression ranges only for election ads; commercial advertisers omit both.
GET /v1/ad-library/google/advertiser-search | 1 credit | Find Google Ads Transparency AR… entities — ranked multi-result (1 credit when found; empty is free).

## Google Maps

GET /v1/google/business-search | 2 credits | Local businesses from a Maps search — name, address, phone, website, rating, hours, place id.

## History

GET /v1/history | 1 credit | Returns the counts (followers, views, likes, ...) Captapi stored each time a tracked profile or post was fetched fresh.

## Instagram

GET /v1/instagram/transcript | 2 credits | Turn any Instagram Reel's speech into text — the full transcript plus timestamped segments, ready for search, subtitles, or AI pipelines.
GET /v1/instagram/summarize | 4 credits | Get an AI summary of any Instagram Reel — a short paragraph plus key points, without watching the video.
GET /v1/instagram/details | 1 credit | Get an Instagram post, Reel or carousel — caption, likes, comments, views, media URLs, author, and per-slide children on carousels.
GET /v1/instagram/comments | ~45 credits (0.9/result) | Session-paged Instagram comments — a logged-out 2-row preview of a larger thread is 503 SESSION_UNAVAILABLE at 0 credits.
GET /v1/instagram/channel-details | 1 credit | Instagram profile stats — fixed key set (null fillers), fbid, bioLinks, isBusinessAccount, approx flags.
GET /v1/instagram/channel-posts | ~6 credits (0.3/result) | Latest posts from a public Instagram profile — carousel children[], mediaCount, user{} in one call.
GET /v1/instagram/channel-reels | ~6 credits (0.3/result) | Latest Reels from a public Instagram profile — pass userId to skip resolve; ceil(n×0.3) credits; nextCursor + hasMore.
GET /v1/instagram/reels-search | 2 credits | Native tag feed first, slower fallback paths on a miss.
GET /v1/instagram/trending-reels | 2 credits | Cache-first trending Reels.
GET /v1/instagram/tagged-posts | 1 credit | Posts that tag an Instagram account — author verified/avatar when available, staleFeed when Instagram only exposes an archive.
GET /v1/instagram/reels-by-audio-id | ~28 credits (1.4/result) | Is this Instagram sound trending?
GET /v1/instagram/hashtag-search | 2 credits | Hashtag Explore: native grid first, fallback path only on miss.
GET /v1/instagram/profile-search | 1 credit | Resolve a brand or @handle to one public Instagram profile — stable id, bio, links, and stats (not niche discovery).
GET /v1/instagram/embed | 1 credit | Classic Instagram embed snippet — blockquote.instagram-media + embed.js.
GET /v1/instagram/highlights | 1 credit | Persistent Story Highlight albums for a public profile — id, title, cover, owner.
GET /v1/instagram/highlights-details | 1 credit | Items inside one Instagram Story Highlight album — media URLs, type, takenAt.
GET /v1/instagram/basic-profile | 1 credit | Instagram profile by user ID or @handle — camelCase schema aligned with Channel Details (followers, externalUrl, businessAddress).

## Kick

GET /v1/kick/clip | 1 credit | Get a Kick clip — source, 7d clip cache, fallback paths on a miss.

## Komi

GET /v1/komi/page | 1 credit | Komi link-in-bio → identity, socials{} (incl.

## Kwai

GET /v1/kwai/profile | 1 credit | Fetch Kwai profile — display name, bio, counts, and verification as structured JSON.
GET /v1/kwai/user-posts | ~20 credits (1/result) | Kwai profile posts — caption ("" when none), engagement, mp4 + transcript (~1 credit/post).
GET /v1/kwai/post | 2 credits | Single Kwai video — caption ("" when none), hashtags[], author, mp4 (2 credits).

## Linkbio

GET /v1/linkbio/page | 1 credit | lnk.bio → id, socials{}, titled links[], website/email/whatsapp, other[].

## LinkedIn

GET /v1/linkedin/profile | 1 credit | Public LinkedIn person profile — what a logged-out visitor sees: name, headline, location, about.
GET /v1/linkedin/company | 2 credits | Company page for B2B intel — specialties, similarPages, employeeCount, founded, slogan, cover.
GET /v1/linkedin/post-details | 1 credit | Get a LinkedIn post — text, author, reactions, and comments count as structured JSON.
GET /v1/linkedin/post-transcript | 1 credit | LinkedIn post text as a transcript — paragraph segments, timingSource none.
GET /v1/linkedin/company-posts | 1 credit | The recent posts a company page shows logged-out visitors (about 10), with engagement{likes,comments}.
GET /v1/linkedin/search-posts | ~16 credits (0.8/result) | Keyword search of public LinkedIn posts — offset cursor, ceiling 50.

## LinkedIn Ad Library

GET /v1/ad-library/linkedin/search-ads | 2 credits | LinkedIn publishes run dates, impressions and targeting only on a subset of creatives.
GET /v1/ad-library/linkedin/ad-details | 2 credits | One LinkedIn Ad Library ad by ID.

## Linkme

GET /v1/linkme/profile | 1 credit | Linkme profile → bio, profileVisitCount, featured links, webLinks, email/infoLinks, stripeStatus.

## Linktree

GET /v1/linktree/page | 1 credit | Link-in-bio → creator graph: typed links, socialAccounts{} that feed TikTok/Instagram/Spotify/SoundCloud, email, verticals.

## Monitors

GET /v1/monitors | 0 credits | All monitors on your account, newest first.
POST /v1/monitors | Free to manage; each scheduled run is billed like a direct call | Re-runs a list-returning Captapi GET endpoint on your interval and POSTs only new items to your webhook.
GET /v1/monitors/{monitor_id} | 0 credits | One of your monitors, including its webhook secret.
PATCH /v1/monitors/{monitor_id} | 0 credits | Change name, params, interval_minutes, webhook_url or active.
DELETE /v1/monitors/{monitor_id} | 0 credits | Deletes one of your monitors.
POST /v1/monitors/{monitor_id}/test | 0 credits | POSTs a signed monitor.test payload to the monitor's webhook_url so you can check signature verification.

## Pillar

GET /v1/pillar/page | 1 credit | Pillar link-in-bio → identity, socials{}, links[] with per-link clicks, products[].

## Pinterest

GET /v1/pinterest/pin-details | 1 credit | Get a Pinterest pin — title, description, link, board, origin creator, and engagement as structured JSON.
GET /v1/pinterest/user-pins | ~13 credits (0.5/result) | Pins from a Pinterest profile — offset cursor, pidgets window ~100.
GET /v1/pinterest/search | ~13 credits (0.5/result) | Keyword pin search — offset cursor, SERP window 40.
GET /v1/pinterest/board | ~13 credits (0.5/result) | Pins on a Pinterest board — saves, imageOriginal, destinationUrl, top-level author.
GET /v1/pinterest/user-boards | ~13 credits (0.5/result) | Boards on a Pinterest profile — pinCount, coverImage (474x), privacy, sections.

## Reddit

GET /v1/reddit/subreddit-posts | 2 credits | List posts from a subreddit with sort, timeframe, and cursor pagination — title, score, upvote ratio, flair, and more.
GET /v1/reddit/post-details | 1 credit | Get a Reddit post — title, body, score, comments count, subreddit, and author as structured JSON.
GET /v1/reddit/post-comments | 2 credits | Flat Reddit comment threads with depth/parentId, cursor pagination, and the parent post in one call.
GET /v1/reddit/post-transcript | 2 credits | Written post text — title, body and top comments.
GET /v1/reddit/search | 2 credits | Reddit site-wide post search — sort + timeframe + cursor, score/upvoteRatio, authorFullname.
GET /v1/reddit/subreddit-details | 1 credit | Subreddit card — id (t5_…), members, activeUsers, rules[], ISO createdAt, nsfw/type.
GET /v1/reddit/subreddit-search | 2 credits | Search posts inside one subreddit — not subreddit discovery.

## Rumble

GET /v1/rumble/video-details | 1 credit | Rumble video metadata — uniform streams[] with rendition meta, captions[], audioStreams.
GET /v1/rumble/video/transcript | 1 credit | Rumble published captions as timed segments — parses the .vtt from video-details (not speech-to-text).
GET /v1/rumble/channel-videos | ~12 credits (0.6/result) | Rumble channel uploads — lean streams[{url,type}]; call video-details for rendition meta.
GET /v1/rumble/search | ~12 credits (0.6/result) | Rumble keyword search — same video card shape as channel-videos (type, durationSeconds + durationText, UTC publishedAt).
GET /v1/rumble/comments | 2 credits | Rumble top-level comments — publishedAt ISO-8601 UTC from title= on the comment time link.

## Snapchat

GET /v1/snapchat/user-profile | 1 credit | Snapchat profile — stable identity card, millisecond timestamps, mediaType image/video (1 credit).

## SoundCloud

GET /v1/soundcloud/artist | 1 credit | SoundCloud artist — handle + name, subscriptionTier, externalLinks, verified (1 credit).
GET /v1/soundcloud/artist-tracks | 2 credits | Artist track list — opaque cursor, native-window when the api-v2 page ends (2 credits; empty is 0).
GET /v1/soundcloud/track | 1 credit | SoundCloud track — plays/likes/license, tags[], nested artist{}, streamUrl when streamable (1 credit).

## Spotify

GET /v1/spotify/artist | 1 credit | Spotify artist — followers, monthlyListeners, worldRank, topCities, topTracks with playCount, concerts, and related artists (1 credit).
GET /v1/spotify/track | 1 credit | Spotify track — playCount, joinable artists[]/album{}, explicit, releaseDate (1 credit).
GET /v1/spotify/album | 1 credit | Spotify album — tracks[] with playCount, joinable artists[], releaseDate, explicit (1 credit).
GET /v1/spotify/search | 2 credits | Search Spotify — canonical spotify: URIs, explicit, fetchedAt (flat 2 credits).
GET /v1/spotify/podcast | 1 credit | Spotify podcast show — publisher, rating, topics, explicit flag, and totalEpisodes as clean JSON.
GET /v1/spotify/podcast-episodes | 2 credits | Podcast episode archive — previewUrl, releaseDate, explicit, cursor pagination (flat 2 credits).

## Status

GET /v1/status | 0 credits | Per-platform health from the most recent requests in the last 24 hours.

## Threads

GET /v1/threads/profile | 1 credit | Threads profile — displayName, private/isPrivate, bioLinks (Meta verified), isThreadsOnlyUser, transparencyLabel, bioFragments, HD avatars (1 credit).
GET /v1/threads/user-posts | 2 credits | Recent Threads posts — engagement{views,likes,replies,reposts,quotes}, threadId/isReply.
GET /v1/threads/post-details | 1 credit | Threads post — engagement (views when exposed), comments[], relatedPosts[], threadId/isReply.
GET /v1/threads/search | 2 credits | Threads keyword search — posts with engagement + media.
GET /v1/threads/search-users | 1 credit | Threads user discovery from keyword search — id, handle, avatar, verified.

## TikTok

GET /v1/tiktok/transcript | 2 credits | Extract timestamped transcripts from any public TikTok video in a single request.
GET /v1/tiktok/summarize | 4 credits | Turn any TikTok video into an AI summary with key points, topics, and sentiment.
GET /v1/tiktok/video-details | 1 credit | Get everything about one TikTok video from its URL — caption, view/like/comment/share/save counts, creator, sound, hashtags, and thumbnail.
GET /v1/tiktok/comments | 2 credits | TikTok comments — clean schema plus authorName, stable authorId/authorSecUid and commentLanguage for listening loops.
GET /v1/tiktok/channel-details | 1 credit | Resolve a TikTok @handle to id + secUid — createTime, ttSeller, bioLink, decoded privacy flags.
GET /v1/tiktok/profile-region | 2 credits | Find out where a TikTok creator is likely based and what language they use — country, language, stable ids, and core profile stats.
GET /v1/tiktok/audience-demographics | 3 credits | Audience country + language mix for a TikTok creator — engagement sample, not a follower census.
GET /v1/tiktok/search-suggestions | 2 credits | 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.
GET /v1/tiktok/channel-posts | 2 credits (fallback: 1 per 20 posts, min 2) | Latest videos from a TikTok profile.
GET /v1/tiktok/comment-replies | 2 credits | Replies under a TikTok comment — same authorId/authorSecUid/commentLanguage shape as comments.
GET /v1/tiktok/user-followers | 1 credit | List a TikTok user's followers — id, secUid, createTime, region, language, cursor pagination.
GET /v1/tiktok/user-followings | 1 credit | List who a TikTok user follows — id, secUid, createTime, region, language, cursor pagination.
GET /v1/tiktok/music-posts | 2 credits | List TikTok videos that use a specific sound — caption, author, exact engagement, canonical hashtags, and mentions, with cursor pagination.
GET /v1/tiktok/top-search | 2 credits | TikTok Top/General search — videos and photo carousels when TikTok includes them, with contentType + images[].
GET /v1/tiktok/search/hashtag | ~14 credits (0.7/result) | Videos from TikTok's /tag/{name} challenge feed — not keyword or username search.
GET /v1/tiktok/search/users | 1 credit | Search TikTok users — distinct creators only, id + secUid, per-counter isApproximate flags, cursor pagination.
GET /v1/tiktok/song-details | 1 credit (2 via fallback path) | TikTok sound metadata — usageCount, artists[{id,secUid,handle}], audio{bpm,loudness,beats}, commerce rights (1 credit; 2 via the fallback path).
GET /v1/tiktok/trending-feed | 2 credits | For You by default; pass orderBy/period/page for Creative Center popular videos (like/hot/comment/repost) with totalCount.
GET /v1/tiktok/popular-hashtags | 2 credits | Related TikTok hashtags — Creative Center chart when it answers, otherwise a disclosed niche fallback.
GET /v1/tiktok/popular-songs | 2 credits | Removed 26 Sep 2026 — TikTok deleted the public Creative Center song chart in its TikTok One migration. (removed: returns 410)
GET /v1/tiktok/live | 1 credit | 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.
GET /v1/tiktok/live-info | 1 credit | Identical to TikTok Live (isLive, creator.id/secUid, streamQualities hls/cmaf).
GET /v1/tiktok/popular-creators | 2 credits | Creative Center creators + createTime / bioLinkRisk / ttSeller hydrate for partnership vetting.

## TikTok Ad Library

GET /v1/ad-library/tiktok/search | 2 credits (5 via fallback path) | Search TikTok Commercial Content Library — relevance-filtered, uniform null schema (2 credits native, 5 via fallback).
GET /v1/ad-library/tiktok/top-ads | 2 credits | TikTok Creative Center Top Ads — one ~20-row leaderboard page, not a library search (flat 2; ~1/ad on the fallback path).
GET /v1/ad-library/tiktok/ad-details | 2 credits | One TikTok Commercial Content Library ad by ID — calendar-day dates, always 2 credits.

## TikTok Shop

GET /v1/tiktok-shop/shop-search | 2 credits | TikTok Shop keyword search — priced products with sold, rating/reviews, typed discount, seller id.
GET /v1/tiktok-shop/shop-products | 2 credits (fallback: 2.8/product, min 2) | Store catalog with shopInfo (sold/followers/rating) + products priced with sold, rating, typed discount.
GET /v1/tiktok-shop/product-details | 2 credits | PDP — price (sku_min when guest min is *), sold vs stock, seller id/url, images[].
GET /v1/tiktok-shop/product-reviews | ~45 credits (2.25/result) | TikTok Shop product reviews — star rating, text, SKU variant, verified purchase, country, and review photos.
GET /v1/tiktok-shop/user-showcase | ~45 credits (2.25/result) | Creator Shop showcase — affiliate shelf products with per-product sold, rating, typed discount, and seller name/url.

## Truth Social

GET /v1/truth-social/profile | 1 credit | Prominent public Truth Social profiles — isPrivate/bot/group, CP-F counts, avatar/banner.
GET /v1/truth-social/user-posts | 2 credits | Recent Truths — same post mapper as /post (links, card, reblog/quote, mentions).
GET /v1/truth-social/post | 1 credit | One Truth — text, links[], card, reblog/quote chain, media.meta, externalVideoId.

## Twitch

GET /v1/twitch/profile | 1 credit | Twitch channel — handle + displayName, socials[], topClips, schedule preview, stream only when live (1 credit).
GET /v1/twitch/user-videos | 2 credits | Twitch channel VODs — lean rows, video-id cursor, filter/sort, top-level broadcaster{} (flat 2).
GET /v1/twitch/user-schedule | 1 credit | Twitch channel schedule — startAt/endAt, title, game, isRecurring (0 credits when empty).
GET /v1/twitch/clip | 1 credit | Twitch clip — curator vs channel, signedVideoUrl, unwrapped token, relatedClips (1 credit).

## Twitter / X

GET /v1/twitter/tweet-details | 1 credit | One tweet as JSON — text, author (followers), likes/replies/retweets/quotes, media, ISO publishedAt.
GET /v1/twitter/transcript | 1 credit | Tweet text as a transcript — timingSource none (not speech-to-text).
GET /v1/twitter/profile | 1 credit | X profile: verified + blue/legacy/identity, displayName, avatar/banner, tipjar→contact{}, expanded website.
GET /v1/twitter/user-tweets | 2 credits | Most popular public tweets from a Twitter/X profile (~100 cap) — not chronological.
GET /v1/twitter/community | 1 credit | X Community metadata — ISO createdAt, flat creator handle, isNsfw + bannerImage, rules[].
GET /v1/twitter/community-tweets | 2 credits | Posts in an X Community — same 6-metric tweet shape as search.

## Utilities

GET /v1/analytics/post | 1 credit | Unified metrics for one post, video, or reel — platform auto-detected (1 credit).
GET /v1/analytics/compare | 1 credit/url | Compare unified metrics across up to 10 URLs — each row is the analytics/post object (1 credit/resolved URL).
POST /v1/video/transcript | 1 credit/min | AI transcription of an uploaded file — 1 credit/min; noSpeech=true and 0 credits when there is no speech.
POST /v1/video/summarize | 1 credit/min +1 | AI transcription + summary of an uploaded file — transcript included; 1 credit/min + 1.

## YouTube

GET /v1/youtube/transcript | 1 credit | YouTube's published captions with timestamps — not speech-to-text.
GET /v1/youtube/audio-transcript | 2 credits/min of audio | Speech-to-text for YouTube audio.
GET /v1/youtube/summarize | 3 credits | AI summary from YouTube's published captions — same source as /transcript.
GET /v1/youtube/video-details | 1 credit | YouTube video metadata + stats.
GET /v1/youtube/comments | 2 credits | Get comments on any YouTube video — text, author, likes, and truncated publishedTimeApprox from the relative label, with cursor pagination (nextCursor + hasMore).
GET /v1/youtube/channel-details | 1 credit | YouTube channel stats — ISO country, createdAt date-only, real banner or null, quote-aware SEO tags, absolute links.
GET /v1/youtube/search | 2 credits | YouTube search with cursor pagination — typed hits, ids, canonical URLs, filters (2 credits/page).
GET /v1/youtube/channel-videos | 2 credits | Channel uploads with cursor pagination — exact publishedAt from reel_item_watch (same as channel-shorts).
GET /v1/youtube/playlist-videos | 2 credits | Paginated playlist contents — cursor/nextCursor/hasMore, same row shape as channel-videos.
GET /v1/youtube/playlist | 1 credit | Playlist metadata only — title, channel{}, totalVideos, thumbnailUrl.
GET /v1/youtube/shorts/transcript | 1 credit | Transcript for a YouTube Short — rejects long-form videos (≤3 min only).
GET /v1/youtube/shorts/summarize | 3 credits | AI summary of a YouTube Short — rejects long-form videos (≤3 min only).
GET /v1/youtube/shorts/video-details | 1 credit | YouTube Short metadata — same schema as Video Details, with isShort:true; long-form videos get HTTP 422.
GET /v1/youtube/shorts/comments | 2 credits | Comments on a YouTube Short — rejects long-form videos (≤3 min only).
GET /v1/youtube/channel-shorts | 2 credits | Channel Shorts with cursor pagination — same row shape as channel-videos (exact publishedAt).
GET /v1/youtube/trending-shorts | 2 credits | YouTube Shorts recommendation sequence — fixed window per call (no cursor), not a global chart.
GET /v1/youtube/channel-streams | 2 credits | Channel Live tab only — liveStatus per row; 0 credits when hasLiveTab is false.
GET /v1/youtube/hashtag-search | ~20 credits (1/result) | Videos from youtube.com/hashtag/{name} — nested channel{}, viewCountIsApproximate.
GET /v1/youtube/comment-replies | 2 credits | Replies under a top-level comment — parentReplyCount + cursor.
GET /v1/youtube/channel-playlists | 2 credits | Channel playlists with cursor pagination — id, title, totalVideos, thumbnailUrl.
GET /v1/youtube/community-posts | 1 credit | Community posts — channel{}, publishedTimeApprox, likeCountIsApproximate, linkedVideos[], cursor (1 credit).
GET /v1/youtube/community-post-details | 1 credit | One community post — list schema + commentCount trio + isEdited.
GET /v1/youtube/video-sponsors | 0 credits | SponsorBlock community segments — free while the CC BY-NC-SA commercial-use exception is pending.