captapi

{'type': 'object', 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'properties': {'days': {'type': 'integer', 'minimum': 1, 'description': 'Number of days to include (default 30, max 365).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'days': {'type': 'integer', 'minimum': 1, 'description': 'Number of days to include (default 30, max 365).'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max rows to return (default 20, max 100). Free — does not consume credits.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max rows to return (default 50, max 500). Free — does not consume credits.'}, 'since': {'type': 'string', 'description': 'Inclusive lower bound on createdAt (ISO date or datetime).'}, 'until': {'type': 'string', 'description': 'Exclusive upper bound on createdAt (ISO date or datetime).'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from nextCursor (createdAt of the last row). Leave empty for the first page.'}, 'endpoint': {'type': 'string', 'description': 'Exact Captapi path filter, e.g. /v1/instagram/basic-profile.'}, 'statusCode': {'type': 'integer', 'minimum': 1, 'description': 'Filter by HTTP status code (e.g. 500).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Amazon seller storefront URL (/sp?seller=… or /s?me=…) or raw seller ID. Not influencer /shop/<handle> pages. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max products to include (default 20, max 200; 0 = seller metadata only). Billed per storefront page — 1 credit per ~16 products.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from nextCursor (page or page:offset). Leave empty for the first page.'}, 'marketplace': {'type': 'string', 'description': 'Amazon marketplace code. Default US.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['urls'], 'properties': {'urls': {'type': 'string', 'description': 'Comma-separated post/video/reel URLs (up to 10), any mix of the same 11 platforms as Post Analytics. Example: a TikTok URL and a YouTube URL in one call.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Public post/video/reel URL from one of 11 platforms: YouTube, TikTok, Instagram, Facebook, X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, or Rumble. Platform is auto-detected — cross-platform URLs are expected here (unlike single-platform endpoints). Not in scope: Kwai, Twitch, Spotify, Snapchat, and other Captapi platforms.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Bluesky post URL, e.g. https://bsky.app/profile/handle/post/RKEY. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'depth': {'type': 'integer', 'minimum': 1, 'description': 'Reply nesting levels under the post (0 = post only with no replies[], default 1, max 6). Maps to Bluesky getPostThread depth.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Bluesky profile URL, @handle, or handle, e.g. bsky.app/profile/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 Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.'}, 'cacheMaxAge': {'type': 'string', 'description': 'Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Bluesky profile URL, @handle, or handle, e.g. https://bsky.app/profile/handle.bsky.social. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 25, max 100). Billed per result.'}, 'cursor': {'type': 'string', 'description': 'Opaque pagination cursor from the previous nextCursor. Leave empty for the first page. Do not invent a cursor from publishedAt — the feed is ordered by feed time (reposts sort by repost time).'}, 'filter': {'type': 'string', 'description': 'Bluesky getAuthorFeed filter: posts_with_replies (default), posts_no_replies, posts_with_media, posts_and_author_threads, or posts_with_video. Controls replies/media/threads — not reposts. Use includeReposts=false to drop reposts.'}, 'includeReposts': {'type': 'boolean', 'description': 'When false, omit repost rows (reasonRepost). Default true — reposts are included and marked with isRepost / repostedBy / repostedAt.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Meta Ad Library ad URL or ad 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 to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Meta Ad Library ad URL or ad ID. Returns the ad's written copy — headline, body text, CTA and landing URL. Meta does not expose ad audio, so this is not a speech transcript. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "pageId from /search-companies (preferred), libraryUrl, vanity page URL (facebook.com/nike/), or Ad Library URL with view_all_page_id. Do not pass profileId from facebook.com/{digits}/ when it differs from pageId. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 2 credits per call on the native path; the extended fallback bills per returned ad.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from a previous nextCursor. Pages through the current Meta HTML result batch.'}, 'status': {'type': 'string', 'description': 'Ad delivery status: ACTIVE (default), INACTIVE, or ALL. Use ACTIVE for "what are they running now?".'}, 'country': {'type': 'string', 'description': 'Two-letter ISO country code. Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Keyword, brand, or advertiser to search Meta Ad Library (min 2 characters).'}, 'trim': {'type': 'boolean', 'description': 'When true, omit cards/images/videos typed arrays (media[] stays). Captapi payloads are already lean vs Meta nested snapshots.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 2 credits per call.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from a previous nextCursor. Pages through the current Meta HTML result batch.'}, 'status': {'type': 'string', 'description': 'Ad delivery status: ACTIVE (default), INACTIVE, or ALL. Use ACTIVE for "what are they running now?".'}, 'ad_type': {'type': 'string', 'description': 'all (default) or political_and_issue_ads. Spend/impressions are typically only filled for political/issue ads.'}, 'country': {'type': 'string', 'description': 'Two-letter ISO country code (e.g. US, GB, DE). Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY — Meta would otherwise ignore the code and search globally while echoing it back as if the filter worked.'}, 'sort_by': {'type': 'string', 'description': 'Meta sort mode: total_impressions or relevancy_monthly_grouped.'}, 'end_date': {'type': 'string', 'description': 'Only ads with delivery start on/before this date (YYYY-MM-DD).'}, 'platforms': {'type': 'string', 'description': 'Comma-separated publisher platforms to keep: FACEBOOK, INSTAGRAM, MESSENGER, AUDIENCE_NETWORK, THREADS.'}, 'media_type': {'type': 'string', 'description': 'Creative filter: ALL (default), IMAGE, VIDEO, MEME, IMAGE_AND_MEME, or NONE.'}, 'start_date': {'type': 'string', 'description': 'Only ads with delivery start on/after this date (YYYY-MM-DD).'}, 'search_type': {'type': 'string', 'description': 'keyword_unordered (default) or keyword_exact_phrase.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Company or brand name to search for (min 2 characters). Name-matched — off-brand pages are dropped.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 2 credits per call.'}, 'country': {'type': 'string', 'description': 'Two-letter ISO country code. Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url', 'commentId'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 50, max 500). Flat 2 credits per call.'}, 'commentId': {'type': 'string', 'description': 'ID of the parent (top-level) comment to fetch replies for — from the comments endpoint. Legacy alias: comment_id.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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 you get that post's comments (each comment's url names the actual post)."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 50, max 500). Flat 2 credits per call.'}, 'feedbackId': {'type': 'string', 'description': 'Post feedback id from /v1/facebook/details (base64 feedback:POSTID). Prefer when you already have it — also accepts feedback_id.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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 Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Facebook event URL, e.g. https://facebook.com/events/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 to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': "Topic keyword, e.g. 'comedy'. Pair with location for city-scoped results."}, 'to': {'type': 'string', 'description': 'Inclusive local start date filter YYYY-MM-DD.'}, 'from': {'type': 'string', 'description': 'Inclusive local start date filter YYYY-MM-DD. Use for upcoming-only windows — Facebook/SERP may return past events.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 2 credits per call. Response `source` is native or extended (fetch path — not a price change).'}, 'location': {'type': 'string', 'description': 'City/place geo filter (e.g. London). Matches timezone, location.city, or coords near the city — not a title substring.'}, 'upcoming': {'type': 'boolean', 'description': "When true and from is omitted, sets from to today's UTC date so past events are dropped."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 2 credits per call.'}, 'sortBy': {'type': 'string', 'description': 'TOP_POSTS | RECENT_ACTIVITY | CHRONOLOGICAL (default) | CHRONOLOGICAL_LISTINGS. Maps to Facebook sorting_setting.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Facebook Marketplace item 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': "City/place query. Bare names like 'Austin' may return multiple candidates (TX/MN/IN); include a state for a single hit (e.g. 'Austin, TX')."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 10, max 50). Flat 2 credits per call.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q', 'searchLocation'], 'properties': {'q': {'type': 'string', 'description': 'Product or keyword to search Facebook Marketplace for.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'How many listings to return (1–200). Flat 2 credits when details=false; details=true billed as 2 + 2 per listing.'}, 'cursor': {'type': 'string', 'description': 'Opaque pagination cursor from a previous nextCursor.'}, 'sortBy': {'type': 'string', 'description': 'suggested | distance | creation_time | price_ascend | price_descend.'}, 'details': {'type': 'boolean', 'description': 'When true, adds description/condition/coordinates/full photo gallery/seller/distanceMiles — billed as 2 + 2 credits per listing. Default false → flat 2 credits; cover photo is still in image.'}, 'category': {'type': 'string', 'description': 'Top-level category slug, e.g. electronics.'}, 'location': {'type': 'string', 'description': 'Alias of searchLocation. Prefer searchLocation. Either one is required.'}, 'maxPrice': {'type': 'integer', 'minimum': 1, 'description': 'Maximum price in local currency units.'}, 'minPrice': {'type': 'integer', 'minimum': 1, 'description': 'Minimum price in local currency units.'}, 'condition': {'type': 'string', 'description': 'new, like_new, good, fair (comma-separated ok).'}, 'radiusMiles': {'type': 'integer', 'minimum': 1, 'description': 'Radius in miles: 1,2,5,10,20,40,60,80,100,250,500. Does not exclude nationwide shipped inventory.'}, 'availability': {'type': 'string', 'description': 'available | sold | all.'}, 'deliveryMethod': {'type': 'string', 'description': 'local_pickup | shipping | all. Shipped listings can appear nationwide outside radiusMiles — use local_pickup for nearby-only; rows expose isLocal / shipsOutsideRadius.'}, 'searchLocation': {'type': 'string', 'description': "Search-origin city or place name, e.g. 'Austin, TX'. Required — there is no default city. Echoed on the envelope and inside filters. Not listings[].location. Names that don't resolve to a real place are a definitive 400 UNKNOWN_LOCATION (Facebook would otherwise silently search an unrelated metro) — /v1/facebook/marketplace-location-search finds valid ones."}, 'daysSinceListed': {'type': 'string', 'description': 'Facebook calendar-day recency: 1 = since the start of yesterday (not a rolling 24 hours), 7, or 30.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 2 credits per call. Response `source` is native or extended (fetch path — not a price change).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': '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.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': '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 is capped at 12s. The next-item fit check uses that 12s cap, not the typical 6–10s, so a call cannot exceed 60s. The loop stops when the next item would miss the 60s deadline and returns what it has (truncatedReason=hydrate-budget | deadline). Asking for 20 cannot return 20 inside that ceiling. Flat 2 credits per call.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 2 credits per call.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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 Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['username'], 'properties': {'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 30, max 90). Billed per result.'}, 'cursor': {'type': 'string', 'description': "Opaque cursor from a previous nextCursor. Pagination stops after GitHub's 90-event public activity ceiling."}, 'username': {'type': 'string', 'description': 'GitHub username or profile URL, e.g. getify.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['username'], 'properties': {'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'username': {'type': 'string', 'description': 'GitHub username or profile URL, e.g. getify or https://github.com/getify.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['username'], 'properties': {'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 30, max 100). Billed per result.'}, 'cursor': {'type': 'string', 'description': 'Opaque cursor from a previous nextCursor (GitHub Link page=). Not a bare page number.'}, 'username': {'type': 'string', 'description': 'GitHub username or profile URL, e.g. getify.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['username'], 'properties': {'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 30, max 100). Billed per result.'}, 'cursor': {'type': 'string', 'description': 'Opaque cursor from a previous nextCursor (GitHub Link page=). Not a bare page number.'}, 'username': {'type': 'string', 'description': 'GitHub username or profile URL, e.g. getify.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['repo'], 'properties': {'repo': {'type': 'string', 'description': 'Repository URL or owner/name, e.g. vercel/next.js.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 30, max 100). Billed per result.'}, 'state': {'type': 'string', 'description': 'open (API default), closed, or all. Echoed as data.state. Docs example uses closed so mergedAt is visible.'}, 'cursor': {'type': 'string', 'description': 'Opaque cursor from a previous nextCursor (GitHub Link page=). Not a bare page number.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['username'], 'properties': {'sort': {'type': 'string', 'description': "created | updated | pushed | full_name (default updated). Not stars — GitHub's user-repos API has no stars sort. Echoed as data.sort."}, 'type': {'type': 'string', 'description': 'owner (default) | member | all — affiliation filter. Echoed as data.type.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 30, max 100). Billed per result.'}, 'cursor': {'type': 'string', 'description': 'Opaque cursor from a previous nextCursor (GitHub Link page=). Not a bare page number.'}, 'username': {'type': 'string', 'description': 'GitHub username or profile URL, e.g. torvalds.'}, 'direction': {'type': 'string', 'description': 'asc or desc (default desc). Echoed as data.direction.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['repo'], 'properties': {'repo': {'type': 'string', 'description': 'Repository URL or owner/name, e.g. torvalds/linux or https://github.com/torvalds/linux.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 25, max 100). Flat 2 credits per call.'}, 'since': {'type': 'string', 'description': 'Trending window: daily (default), weekly, or monthly — matches github.com/trending/developers?since=.'}, 'language': {'type': 'string', 'description': 'Optional programming-language slug → /trending/developers/{language}.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 25, max 100). Flat 2 credits per call.'}, 'since': {'type': 'string', 'description': 'Trending window: daily (default), weekly, or monthly — matches github.com/trending?since=.'}, 'language': {'type': 'string', 'description': 'Optional programming-language slug (e.g. python, typescript) → /trending/{language}.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['username'], 'properties': {'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'username': {'type': 'string', 'description': 'GitHub username or profile URL, e.g. getify or https://github.com/getify.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['creative_id'], 'properties': {'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'country': {'type': 'string', 'description': 'Two-letter ISO country code. Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY.'}, 'creative_id': {'type': 'string', 'description': 'Google Ads Transparency URL containing AR... advertiser and CR... creative IDs. A creative that does not exist under the advertiser is a definitive 404 AD_NOT_FOUND (upstream answered) — 503 is reserved for actual transport failures.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Brand, domain, or advertiser name (min 2 characters). Expanded + ranked so US prefers Inc. over SRL.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 10, max 50). Flat 1 credit when results are returned; 0 credits when totalReturned is 0.'}, 'country': {'type': 'string', 'description': 'Two-letter ISO country code used for ranking (e.g. US). Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['advertiser'], 'properties': {'sort': {'type': 'string', 'description': 'Client-side sort: last_shown (recent activity first) or first_shown. Default is ATC order.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 2 credits when results are returned; 0 credits when totalReturned is 0.'}, 'topic': {'type': 'string', 'description': 'Only "all" is supported (commercial ATC). Google publishes spend and impression ranges only for election ads; commercial advertisers omit both. isActive is true when lastShown is within 7 UTC days.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from nextCursor.'}, 'region': {'type': 'string', 'description': 'Alias for country.'}, 'country': {'type': 'string', 'description': 'Two-letter ISO country / region code (soft filter). Default US. Alias: region. Non-ISO codes are a definitive 400 INVALID_COUNTRY.'}, 'end_date': {'type': 'string', 'description': 'YYYY-MM-DD — keep creatives whose shown window overlaps this end.'}, 'advertiser': {'type': 'string', 'description': 'Advertiser name, domain (e.g. nike.com), or Google advertiser ID (AR…). Prefer AR… from advertiser-search.'}, 'start_date': {'type': 'string', 'description': 'YYYY-MM-DD — keep creatives whose shown window overlaps this start.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['userId'], 'properties': {'cache': {'type': 'boolean', 'description': 'Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.'}, 'userId': {'type': 'string', 'description': '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.'}, 'cacheMaxAge': {'type': 'string', 'description': 'Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.'}, 'cacheMaxAge': {'type': 'string', 'description': 'Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Billed per result.'}, 'cursor': {'type': 'string', 'description': '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.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Instagram profile URL, @handle, or username. Omit when userId is set. The URL platform must match this endpoint's platform."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Billed per result.'}, 'cursor': {'type': 'string', 'description': '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 hasMore is false.'}, 'userId': {'type': 'string', 'description': '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.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 50, max 500). Billed per result.'}, 'cursor': {'type': 'string', 'description': '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 + truncatedReason).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Hashtag without the # (min 2 characters). One token — spaces are 400 HASHTAG_HAS_SPACES.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 50). Flat 2 credits per call.'}, 'mediaType': {'type': 'string', 'description': 'all (default) or reels — return only Reels/clips when set to reels.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Instagram profile URL, @handle, or username. Omit when userId is set.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'userId': {'type': 'string', 'description': '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.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Highlight id from /v1/instagram/highlights (with or without highlight: prefix).'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Account name, @handle, or profile URL to resolve (min 2 characters). A leading _ is stripped. Not a niche keyword search.'}, 'cache': {'type': 'boolean', 'description': 'Serve from the 24h shared cache when available (0 credits on hit). Default true — set false to always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['audioId'], 'properties': {'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Billed per result.'}, 'audioId': {'type': 'string', 'description': 'Instagram audio/music ID or full audio URL, e.g. 27919946310946207.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Hashtag without the # (min 2 characters). One token — spaces are 400 HASHTAG_HAS_SPACES.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 50). Flat 2 credits per call.'}, 'datePosted': {'type': 'string', 'description': 'last_24_hours | last_week | last_month | last_year (aliases: today, this_week, this_month, this_year).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'language': {'type': 'string', 'description': 'ISO code, e.g. "tr": pins the speech language and sets the summary output language. Defaults to auto-detect + English summary.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 1 credit per call.'}, 'cursor': {'type': 'string', 'description': 'Leave empty for the first page; then pass the nextCursor value returned in the previous response.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'language': {'type': 'string', 'description': 'Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'cache': {'type': 'boolean', 'description': '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 miss 45–75s, hard-capped at 110s). Raise client timeouts above 90s — n8n/Make defaults will fail a miss. The fresh result still refreshes the cache.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 10, max 50). Flat 2 credits per call.'}, 'country': {'type': 'string', 'description': "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[]."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Kick clip URL for one enriched clip (e.g. https://kick.com/{channel}/clips/clip_…), or channel input for recent clips[]: kick.com/{name}, kick.com/@{name}, @{name}, or {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/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Channel mode only — max recent clips to return (default 30, max 100). Ignored when url is a clip. Flat 1 credit. No cursor — Kick returns a single page.'}, 'cacheMaxAge': {'type': 'string', 'description': 'Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Komi page URL or username, e.g. https://komi.io/kimkardashian or https://kimkardashian.komi.io/. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.'}, 'cacheMaxAge': {'type': 'string', 'description': 'Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Kwai video URL, e.g. https://www.kwai.com/@topfilmeseseriesnatv/video/5240932700689736196. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Kwai profile URL or @handle, e.g. https://www.kwai.com/@topfilmeseseriesnatv. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Kwai profile URL or @handle, e.g. https://www.kwai.com/@topfilmeseseriesnatv. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max posts to return (1–200). Default 20. ~1 credit per post returned (min 2).'}, 'cursor': {'type': 'string', 'description': 'Opaque pagination cursor from the previous nextCursor. Pages within posts from one profile fetch.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Linkbio (lnk.bio) page URL or username, e.g. https://lnk.bio/charlidamelio. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.'}, 'cacheMaxAge': {'type': 'string', 'description': 'Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "LinkedIn Ad Library URL or numeric ad ID (also accepts urn:li:sponsoredCreative:ID). Inputs that are neither numeric nor an ad-library detail URL are a definitive 400. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Advertiser / account owner name (min 2 when used). Provide q/company, keyword, or companyId.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': "Max items to return (default 20, max 200). One LinkedIn SERP page is ~25 cards — when limit is higher, further pages are pulled automatically within the request's time budget, so limit=50 fills to 50 when LinkedIn has the ads (hasMore + nextCursor cover the rest). Flat 2 credits per call on the native path; the extended fallback bills ~3.5 credits per returned ad. Response `source` is native or extended so you can see which price applied."}, 'cursor': {'type': 'string', 'description': 'Pagination token from paginationToken / nextCursor.'}, 'company': {'type': 'string', 'description': 'Alias of q — advertiser / account owner name.'}, 'country': {'type': 'string', 'description': 'Single ISO country code. Default US. Ignored when countries is set. Non-ISO codes are a definitive 400 INVALID_COUNTRY — LinkedIn would otherwise answer an empty result set as if the filter worked.'}, 'endDate': {'type': 'string', 'description': 'Custom range end YYYY-MM-DD (use with startDate).'}, 'keyword': {'type': 'string', 'description': 'Optional keyword filter on ad creative copy. Whole-word hits are ordered first; already-fetched SERP cards without a literal hit fill behind them up to limit (matchedFrom [] = ranked fill).'}, 'companyId': {'type': 'string', 'description': 'LinkedIn numeric company id for exact advertiser match.'}, 'countries': {'type': 'string', 'description': 'Comma-separated ISO country codes (e.g. US,CA,MX). Each code is validated — non-ISO codes are a 400 INVALID_COUNTRY.'}, 'startDate': {'type': 'string', 'description': 'Custom range start YYYY-MM-DD (use with endDate).'}, 'paginationToken': {'type': 'string', 'description': 'Alias of cursor.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "LinkedIn company URL, e.g. https://www.linkedin.com/company/shopify. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "LinkedIn company URL, e.g. https://linkedin.com/company/slug. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 100). Flat 1 credit per call.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 20). A null nextCursor means the end of the list (max 100 posts).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "LinkedIn post or activity 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "LinkedIn post or activity 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "LinkedIn profile URL, e.g. https://www.linkedin.com/in/paul-martin-a5aa98. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Search query or keywords (min 2 characters).'}, 'sort': {'type': 'string', 'description': 'relevance (default, search-engine rank — dates can span years) or date (recency).'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 50). Billed per result.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 20). A null nextCursor means the end of the list (max 50 posts).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Linkme profile URL or username, e.g. https://link.me/danucd or danucd. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.'}, 'cacheMaxAge': {'type': 'string', 'description': 'Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Linktree profile URL or username. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.'}, 'cacheMaxAge': {'type': 'string', 'description': 'Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Pillar page URL or username. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.'}, 'cacheMaxAge': {'type': 'string', 'description': 'Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Pinterest board URL (.../username/board-name/), not a /pin/ URL. Example: https://www.pinterest.com/potterybarn/rustic-lodge-lookbook/. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 25, max 200). Billed per result.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 25). A null nextCursor means the end of the retrievable window (pidgets ~100).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Pinterest pin URL, e.g. https://pinterest.com/pin/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 to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Keywords or search query (min 2 characters).'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 25, max 200). Billed per result.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 25). A null nextCursor means the end of the SERP window (max 40).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Pinterest profile URL or username. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 25, max 200). Billed per result.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 25). A null nextCursor means the end of the retrievable window (max 200).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Pinterest profile URL or username. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 25, max 200). Billed per result.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 25). A null nextCursor means the end of the retrievable window (pidgets ~100).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 50, max 500). Flat 2 credits per call.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 50, max 200). Flat 2 credits per call.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Keyword or phrase to search Reddit posts site-wide (min 2 characters).'}, 'sort': {'type': 'string', 'description': 'relevance (default) | new | top | hot | comments (alias: comment_count).'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 25, max 200). Flat 2 credits per call.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.'}, 'timeframe': {'type': 'string', 'description': 'For sort=top or comments: hour | day | week | month | year | all (default all).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Subreddit URL, r/name, or bare name (case-insensitive), e.g. r/technology or AskReddit. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'sort': {'type': 'string', 'description': 'Feed sort: best, hot, new (default), top, or rising.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 25, max 200). Flat 2 credits per call.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.'}, 'timeframe': {'type': 'string', 'description': 'For sort=top: hour, day (default), week, month, year, or all.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url', 'q'], 'properties': {'q': {'type': 'string', 'description': 'Keywords or search query (min 2 characters).'}, 'url': {'type': 'string', 'format': 'uri', 'description': "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, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'sort': {'type': 'string', 'description': 'relevance (default) | new | top | hot | comments (alias: comment_count).'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 25, max 200). Flat 2 credits per call.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.'}, 'timeframe': {'type': 'string', 'description': 'For sort=top or comments: hour | day | week | month | year | all (default all).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Rumble channel URL, e.g. https://rumble.com/c/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/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Billed per result.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Rumble video URL, e.g. https://rumble.com/vXXXX-title.html. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 50, max 500). Flat 2 credits per call.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Keywords or search query (min 2 characters).'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Billed per result.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Rumble video URL, e.g. https://rumble.com/vXXXX-title.html. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Rumble video URL, e.g. https://rumble.com/vXXXX-title.html. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'language': {'type': 'string', 'description': 'Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Snapchat username or profile 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "SoundCloud artist profile URL or username. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.'}, 'cacheMaxAge': {'type': 'string', 'description': 'Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "SoundCloud artist profile URL or username. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 100). Flat 2 credits per call.'}, 'cursor': {'type': 'string', 'description': 'Opaque pagination cursor from the previous nextCursor. Leave empty for the first page. Do not edit or invent values.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "SoundCloud track 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.'}, 'cacheMaxAge': {'type': 'string', 'description': 'Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'raw': {'type': 'boolean', 'description': 'Include the upstream GraphQL payload as data.raw. Default false — omit unless you need fields not in the normalized shape.'}, 'url': {'type': 'string', 'format': 'uri', 'description': "Spotify URL, URI, or 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 to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'raw': {'type': 'boolean', 'description': 'Include the upstream GraphQL payload as data.raw. Default false — omit unless you need fields not in the normalized shape (~80% of the old response body).'}, 'url': {'type': 'string', 'format': 'uri', 'description': "Spotify URL, URI, or 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 to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Spotify show/podcast URL, URI, or ID (e.g. https://open.spotify.com/show/…). Not an artist URL.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'raw': {'type': 'boolean', 'description': 'Include slimmed per-episode upstream payload as episodes[].raw. Default false. visualIdentity / playedState / podcastV2 are never included.'}, 'url': {'type': 'string', 'format': 'uri', 'description': 'Spotify show/podcast URL, URI, or ID (e.g. https://open.spotify.com/show/…). Not an artist URL.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 50). Flat 2 credits per call.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Search term (min 2 chars).'}, 'raw': {'type': 'boolean', 'description': 'Include per-result upstream payload as results[].raw. Default false. Pathfinder GraphQL vs Apify scraper shapes differ — see FAQ.'}, 'type': {'type': 'string', 'description': 'Result kind: tracks (default), albums, artists, podcasts, or episodes.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 50). Flat 2 credits per call.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'raw': {'type': 'boolean', 'description': 'Include the upstream GraphQL payload as data.raw. Default false — getTrack embeds bulky artist discography.'}, 'url': {'type': 'string', 'format': 'uri', 'description': "Spotify URL, URI, or 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 to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Threads post URL, e.g. https://threads.net/@user/post/CODE. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Threads profile URL or @handle, e.g. https://threads.net/@username. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Keyword or phrase to search public Threads posts (min 2 characters).'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 25, max 200). Flat 2 credits per call.'}, 'orderBy': {'type': 'string', 'description': 'Sort the fetched page: relevant (default, Meta Top / similar to query), post_dated (newest publishedAt first), or engagement (likes+replies+reposts+quotes+views). Unknown values are 400.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Keyword to find Threads users / creators (min 2 characters).'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 100). Flat 1 credit per call.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Threads 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 Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 100). Threads exposes only a short window of recent public posts on this surface. limit caps what you receive; it cannot increase what Threads returns. Flat 2 credits on every successful path (native and extended).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "TikTok Ad Library URL or numeric ad ID. Inputs with no extractable numeric ID are a definitive 400. An ID TikTok's library positively reports as nonexistent is a definitive 404 AD_NOT_FOUND (ads outside the EU/EEA+UK+CH never enter the library, and entries expire one year after last impression). 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'country': {'type': 'string', 'description': "Two-letter ISO country code. Default GB. Only EU/EEA + UK + CH are covered by TikTok's library; other codes return 400 UNSUPPORTED_REGION."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Keyword or advertiser to search TikTok Commercial Content Library (min 2 characters).'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 2 credits per call.'}, 'match': {'type': 'string', 'description': 'Keyword token mode: "any" (default, OR whole-word) or "all" (AND). hair ≠ wheelchair. Literal hits lead; already-fetched SERP ads fill behind them up to limit (matchedFrom [] = ranked fill). Empty results are free.'}, 'country': {'type': 'string', 'description': "Two-letter ISO country code (e.g. GB, DE, FR). Default GB. TikTok's Commercial Content Library only covers the EU/EEA, the UK and Switzerland (32 countries) — other codes (US, SA, …) return 400 UNSUPPORTED_REGION with the supported list; TikTok has no ad-library data for them."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'q': {'type': 'string', 'description': "Optional keyword that ranks the one ~20-row leaderboard page — not a library search. Case-insensitive whole-word hits on title/brandName/industry/objective (hair ≠ wheelchair) come first; the rest of TikTok's keyword-ranked page follows as fill (matchedFrom [] on those ads, rankedFill in the envelope). There is no tags field. advertiser.name is often null in the default US market. Envelope candidatesScanned is the pre-filter pool size. For a known advertiser, use /tiktok/ad-details by ad id."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 20). One Creative Center leaderboard page is ~20 rows; limit only trims that pool — it cannot scan more candidates. Flat 2 credits on Decodo-native; Apify ~1 credit per returned ad (min 2).'}, 'match': {'type': 'string', 'description': 'Keyword token mode: "any" (default, OR) or "all" (AND). Zero whole-word hits still return TikTok\'s keyword-ranked page as matchBasis=ranked (literalMatches=0).'}, 'period': {'type': 'integer', 'minimum': 1, 'description': 'Lookback window in days: 7, 30, or 180. Default 30.'}, 'country': {'type': 'string', 'description': 'Two-letter ISO country code. Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY (Creative Center used to quietly return an empty leaderboard for them).'}, 'orderBy': {'type': 'string', 'description': 'Sort: for_you, likes, ctr, impressions, or cost. Default for_you.'}, 'adFormat': {'type': 'string', 'description': 'Optional format filter: spark or non_spark. Served only by the extended fetcher — while it is disabled, adFormat returns 503 filter_unavailable (retryable false, not billed). Omit adFormat for the native leaderboard.'}, 'industry': {'type': 'string', 'description': 'Optional industry key or label from Creative Center.'}, 'objective': {'type': 'string', 'description': 'Optional campaign objective (e.g. Traffic, Conversion, Reach).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'videos': {'type': 'integer', 'minimum': 1, 'description': 'How many recent videos to sample comments from: 12 (default, 3 credits), 30 (5 credits), or 60 (8 credits).'}, 'countriesLimit': {'type': 'integer', 'minimum': 1, 'description': 'Max countries in audienceLocations; remainder folds into other{count,percentage}. Omit for the full list (other is omitted when unused).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'raw': {'type': 'boolean', 'description': "Set true to include TikTok's upstream user/statsV2 blob under raw, plus createTimeUnix (unix twin of createTime). Default false — curated fields only."}, 'url': {'type': 'string', 'format': 'uri', 'description': "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. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.'}, 'cacheMaxAge': {'type': 'string', 'description': 'Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': "How many of the creator's latest videos to return on this page (default 20, max 200). Newest first. Native serves cost a flat 2 credits; extended serves scale with returned posts — 1 credit per 20, minimum 2 (200 posts = 10 credits)."}, 'cursor': {'type': 'string', 'description': "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 end of the list."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url', 'commentId'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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 cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 50, max 500). Flat 2 credits per call.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value from the previous response.'}, 'commentId': {'type': 'string', 'description': 'ID of the parent (top-level) comment to fetch replies for — from the comments endpoint. Legacy alias: comment_id.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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 cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 50, max 500). Flat 2 credits per call.'}, 'cursor': {'type': 'string', 'description': '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.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 2 credits per call.'}, 'cursor': {'type': 'string', 'description': '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.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'page': {'type': 'integer', 'minimum': 1, 'description': 'Creative Center page (default 1).'}, 'sort': {'type': 'string', 'description': 'follower, engagement, or popularity. Default follower.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 100). Flat 2 credits per call.'}, 'country': {'type': 'string', 'description': 'Two-letter ISO country code. Default US.'}, 'cacheMaxAge': {'type': 'string', 'description': 'Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.'}, 'follower_count': {'type': 'string', 'description': 'Optional range on FYP/Apify fallthrough: 10k-100k, 100k-1m, 1m-10m, >10m.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'page': {'type': 'integer', 'minimum': 1, 'description': 'Creative Center page (default 1).'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 100). Flat 2 credits per call.'}, 'query': {'type': 'string', 'description': 'Optional niche seed for co-occurrence + challenge/detail enrich. Omit, or pass trending, to try the Creative Center chart (25s); a miss falls through to related tags for fyp (source=niche_fallback) and opens a service-wide chart circuit. Later default calls skip the chart (chartStatus=skipped_circuit_open) until the cooldown expires. Any other value skips the chart.'}, 'period': {'type': 'integer', 'minimum': 1, 'description': 'Lookback days: 7, 30, or 120 (180→120). Default 7.'}, 'sortBy': {'type': 'string', 'description': 'Chart sort: popular (default).'}, 'country': {'type': 'string', 'description': 'Two-letter ISO country for the Creative Center chart. Default US.'}, 'industryId': {'type': 'string', 'description': 'Optional Creative Center industry_id.'}, 'newOnBoard': {'type': 'boolean', 'description': 'Only hashtags newly on the Top 100.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'page': {'type': 'integer', 'minimum': 1, 'description': 'Creative Center page (1–20). Echoed on a native chart 200 with hasMore. Omitted on the extended path — that list is one page.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 20). Flat 2 credits per call.'}, 'period': {'type': 'integer', 'minimum': 1, 'description': '7, 30, or 120 days (180→120). Default 7.'}, 'country': {'type': 'string', 'description': 'Two-letter ISO country. Default US.'}, 'rankType': {'type': 'string', 'description': 'popular | surging. Default popular.'}, 'newOnBoard': {'type': 'boolean', 'description': 'Only sounds newly on the Top 100.'}, 'commercialMusic': {'type': 'boolean', 'description': 'Only Commercial Music Library–cleared sounds.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'raw': {'type': 'boolean', 'description': "Set true to include TikTok's upstream user/statsV2 blob under raw. Default false — curated fields only."}, 'url': {'type': 'string', 'format': 'uri', 'description': "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. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': '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.'}, 'cacheMaxAge': {'type': 'string', 'description': 'Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Single hashtag token for the /tag/{name} challenge feed, with or without # (min 2). Spaces are 400 — use /v1/tiktok/search/top for a keyword query.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 100). Billed per result.'}, 'cursor': {'type': 'integer', 'minimum': 1, 'description': '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.'}, 'region': {'type': 'string', 'description': 'Two-letter ISO 3166-1 country our request is sent from. Default US. Does not filter results by country.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Seed keyword to expand into autocomplete suggestions, e.g. skincare.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 100). Flat 2 credits per call.'}, 'country': {'type': 'string', 'description': 'Two-letter ISO country code that localizes the suggestions to a market, e.g. US, GB, DE. Default US.'}, 'language': {'type': 'string', 'description': 'Interface language for the suggestions, e.g. en-US or de-DE. Default en-US.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Search query matched against usernames, display names and bios (min 2 characters).'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 100). Flat 1 credit per call.'}, 'cursor': {'type': 'string', 'description': '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 means the end of the results.'}, 'fallback': {'type': 'boolean', 'description': 'Opt into the scraper actor when native search is unavailable (~2 min, capped at 100 s, degraded-empty on timeout). Default false — return an empty degraded page (0 credits) instead.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "TikTok Shop product URL, e.g. https://shop.tiktok.com/view/product/1731410956394792439?region=BR or https://www.tiktok.com/shop/pdp/1731098552908944370. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'region': {'type': 'string', 'description': 'Two-letter market region (default US). A region= or oec_region= query on the product URL wins over this default so a BR share URL is not fetched as US. Echoed as data.region.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "TikTok Shop product URL, e.g. https://www.tiktok.com/shop/pdp/1731962298839634826. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Billed per result.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "TikTok Shop store URL with numeric shop id, e.g. https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079. A slug-only /shop/store/{name} URL is a definitive 400 — TikTok's catalog SSR is keyed by shop id. Get the full URL from /v1/tiktok-shop/user-showcase or a product's seller.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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 2 credits per call.'}, 'region': {'type': 'string', 'description': 'Two-letter market region (default US). Non-US coverage depends on TikTok exposing that shop in the selected region — empty results outside the US are often a platform limit, not a Captapi bug.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Product search query (min 2 characters), e.g. phone case.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 10, max 10). Flat 2 credits per call.'}, 'region': {'type': 'string', 'description': "Two-letter market region for the search (default US). Echoed on the response as data.region — not a creator home country. Native search is a SERP window (not TikTok's full catalog); compare requested to serpHits / windowMax."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['username'], 'properties': {'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Billed per result.'}, 'username': {'type': 'string', 'description': 'TikTok username, @handle, or profile URL, e.g. jeffreestar or https://www.tiktok.com/@jeffreestar.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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 cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'language': {'type': 'string', 'description': 'ISO code, e.g. "tr": pins the speech language and sets the summary output language. Defaults to auto-detect + English summary.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Search query or keywords (min 2 characters).'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 2 credits per call.'}, 'cursor': {'type': 'integer', 'minimum': 1, 'description': 'Pagination cursor. Leave 0 for the first page; then pass nextCursor from the previous response. TikTok may return duplicates across pages.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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 cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Serve from the 24h shared cache when available (0 credits on hit). Default true — set false to always fetch fresh.'}, 'language': {'type': 'string', 'description': 'Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'page': {'type': 'integer', 'minimum': 1, 'description': 'Creative Center page (default 1). page>1 triggers chart mode.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 2 credits per call.'}, 'period': {'type': 'integer', 'minimum': 1, 'description': '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.'}, 'country': {'type': 'string', 'description': 'Two-letter ISO country (default US). For You: region-availability hint. Creative Center mode: chart market.'}, 'orderBy': {'type': 'string', 'description': '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) switches from For You to the popular-videos chart. On a For You fallthrough the same sort is applied locally.'}, 'countryCode': {'type': 'string', 'description': 'Alias of country. Wins when both are set.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 50, max 500). Flat 1 credit per call.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor (TikTok minCursor). Leave empty for the first page; then pass nextCursor from the previous response.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 50, max 500). Flat 1 credit per call.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor (TikTok minCursor). Leave empty for the first page; then pass nextCursor from the previous response.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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 cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Truth Social post URL or post 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 to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Truth Social profile URL or @username. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Truth Social profile URL or @username. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': "Max posts to return (default 20, max 80). Truth Social's statuses page is ~20 items — a full page returns nextCursor. On the extended path hasMore can be true with nextCursor null (truncatedReason=single_page_only). Flat 2 credits."}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Twitch clip URL (clips.twitch.tv/<slug> or twitch.tv/<channel>/clip/<slug>). 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.'}, 'cacheMaxAge': {'type': 'string', 'description': 'Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Twitch channel URL or username, e.g. https://www.twitch.tv/shroud. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.'}, 'cacheMaxAge': {'type': 'string', 'description': 'Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Twitch channel URL or username, e.g. https://www.twitch.tv/shroud. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max schedule segments to return (default 50, max 100). Flat 1 credit per call.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Twitch channel URL or username, e.g. https://www.twitch.tv/shroud. 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."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 100). Flat 2 credits per call. Hard ceiling: first 100 matching videos only — deeper history is not available (windowMax=100).'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor = last video id from the previous nextCursor. Leave empty for the first page. Pages the first 100 matching videos only (not a raw offset).'}, 'sortBy': {'type': 'string', 'description': 'TIME (default, newest first) or VIEWS.'}, 'filterBy': {'type': 'string', 'description': 'ARCHIVE | HIGHLIGHT | UPLOAD. Omit for all types — there is no default filter (unset filterBy is omitted, not null).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 25, max 200). Flat 2 credits per call.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to use the 1-hour profile cache (0 credits on hit). Default false — always fetch fresh. Prefer cacheMaxAge for 1d–30d.'}, 'cacheMaxAge': {'type': 'string', 'description': 'Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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 to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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 to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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 Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': "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."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['file'], 'properties': {'file': {'type': 'string', 'description': 'Video or audio file (multipart form field — use -F file=@path, not a query string). Max 200MB / 60 minutes.'}, 'language': {'type': 'string', 'description': 'ISO-639-1 Whisper language hint, e.g. "en" or "tr". Omit to auto-detect.'}, 'translate': {'type': 'boolean', 'description': 'When true, translate speech to English before summarizing. Default false.'}, 'timestampGranularity': {'type': 'string', 'description': 'segment (default) or word.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['file'], 'properties': {'file': {'type': 'string', 'description': 'Video or audio file (multipart form field — use -F file=@path, not a query string). Max 200MB / 60 minutes.'}, 'language': {'type': 'string', 'description': 'ISO-639-1 Whisper language hint, e.g. "en" or "tr". Omit to auto-detect.'}, 'translate': {'type': 'boolean', 'description': 'When true, translate speech to English (Whisper translations API). Default false.'}, 'timestampGranularity': {'type': 'string', 'description': 'segment (default) or word — word-level timings when Whisper exposes them.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'language': {'type': 'string', 'description': 'Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.'}, 'maxCredits': {'type': 'integer', 'minimum': 1, 'description': '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.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 2 credits per call.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 2 credits per call.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 2 credits when hasLiveTab is true; 0 credits when hasLiveTab is false.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'fast': {'type': 'boolean', 'description': 'Set true to use YouTube RSS for faster results with less detailed metadata. Leave false when viewCount/duration quality matters.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 2 credits per call.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url', 'commentId'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 50, max 500). Flat 2 credits per call.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.'}, 'commentId': {'type': 'string', 'description': 'ID of the parent (top-level) comment to fetch replies for — from the comments endpoint. Legacy alias: comment_id.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 50, max 500). Flat 2 credits per call.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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 TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 1 credit per call.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Hashtag with or without the # (min 2 characters). One token — spaces are 400 HASHTAG_HAS_SPACES.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Returns a single window; use limit to size it. No cursor. Billed per result.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'fast': {'type': 'boolean', 'description': 'Set true to use YouTube RSS for faster results with less detailed metadata. Leave false when viewCount/duration quality matters.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 50, max 500). Flat 2 credits per call.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Search query or keywords (min 2 characters).'}, 'type': {'type': 'string', 'description': 'all | videos | shorts | channels | playlists.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 200). Flat 2 credits per call.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.'}, 'region': {'type': 'string', 'description': 'ISO country code for localized results (default US).'}, 'sortBy': {'type': 'string', 'description': 'relevance | date | views | rating (alias: popular→views).'}, 'duration': {'type': 'string', 'description': 'any | under_4 | 4_20 | over_20. Applies to long-form videos (not Shorts).'}, 'uploadDate': {'type': 'string', 'description': 'any | today | this_week | this_month | this_year.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 50, max 500). Flat 2 credits per call.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'language': {'type': 'string', 'description': 'Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'language': {'type': 'string', 'description': 'Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'language': {'type': 'string', 'description': 'Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'language': {'type': 'string', 'description': 'Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Optional topic seed for the Shorts recommendation sequence. Omit (or pass trending/shorts) for the default reel feed — not a keyword search.'}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'limit': {'type': 'integer', 'minimum': 1, 'description': 'Max items to return (default 20, max 100). Returns a single window; use limit to size it. No cursor. Flat 2 credits per call.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "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. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."}, 'cache': {'type': 'boolean', 'description': 'Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.'}, 'minVotes': {'type': 'integer', 'minimum': 1, 'description': 'Minimum SponsorBlock votes to keep a segment. Default 0 (drops community-rejected votes < 0).'}, 'categories': {'type': 'string', 'description': 'Comma-separated categories. Default sponsor,selfpromo,interaction. Also intro,outro,preview,music_offtopic,poi_highlight,filler.'}}, 'additionalProperties': False}