@captapi/sdk 0.2.0 → 0.3.0

package/dist/generated.d.ts

@@ -4,7 +4,7 @@ export interface YoutubeTranscriptParams {
     url: string;
     /** Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect. */
     language?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeAudioTranscriptParams {
@@ -12,9 +12,9 @@ export interface YoutubeAudioTranscriptParams {
     url: string;
     /** Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect. */
     language?: string;
-    /** Refuse before STT when estimatedCredits would exceed this (400 cost_exceeds_max, 0 credits). */
+    /** 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. */
     maxCredits?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeSummarizeParams {
@@ -22,13 +22,13 @@ export interface YoutubeSummarizeParams {
     url: string;
     /** Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect. */
     language?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeVideoDetailsParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeCommentsParams {
@@ -38,13 +38,13 @@ export interface YoutubeCommentsParams {
     limit?: number;
     /** Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeChannelDetailsParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeSearchParams {
@@ -56,7 +56,7 @@ export interface YoutubeSearchParams {
     cursor?: string;
     /** all | videos | shorts | channels | playlists. */
     type?: string;
-    /** relevance | date | views | rating (alias: popular→views). */
+    /** relevance | views (alias: popular→views). date and rating answer 400 SORT_NOT_SUPPORTED: YouTube no longer orders search by upload date (use uploadDate) or by rating. With type=shorts only relevance is supported. */
     sortBy?: string;
     /** any | today | this_week | this_month | this_year. */
     uploadDate?: string;
@@ -64,7 +64,7 @@ export interface YoutubeSearchParams {
     duration?: string;
     /** ISO country code for localized results (default US). */
     region?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeChannelVideosParams {
@@ -76,7 +76,7 @@ export interface YoutubeChannelVideosParams {
     cursor?: string;
     /** Set true to use YouTube RSS for faster results with less detailed metadata. Leave false when viewCount/duration quality matters. */
     fast?: boolean;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubePlaylistVideosParams {
@@ -88,13 +88,13 @@ export interface YoutubePlaylistVideosParams {
     cursor?: string;
     /** Set true to use YouTube RSS for faster results with less detailed metadata. Leave false when viewCount/duration quality matters. */
     fast?: boolean;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubePlaylistParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeShortsTranscriptParams {
@@ -102,7 +102,7 @@ export interface YoutubeShortsTranscriptParams {
     url: string;
     /** Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect. */
     language?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeShortsSummarizeParams {
@@ -110,13 +110,13 @@ export interface YoutubeShortsSummarizeParams {
     url: string;
     /** Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect. */
     language?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeShortsDetailsParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeShortsCommentsParams {
@@ -126,7 +126,7 @@ export interface YoutubeShortsCommentsParams {
     limit?: number;
     /** Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeChannelShortsParams {
@@ -136,7 +136,7 @@ export interface YoutubeChannelShortsParams {
     cursor?: string;
     /** Max items to return (default 20, max 200). Flat 2 credits per call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeTrendingShortsParams {
@@ -144,7 +144,7 @@ export interface YoutubeTrendingShortsParams {
     q?: string;
     /** Max items to return (default 20, max 100). Returns a single window; use limit to size it. No cursor. Flat 2 credits per call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeChannelStreamsParams {
@@ -152,15 +152,15 @@ export interface YoutubeChannelStreamsParams {
     url: string;
     /** Max items to return (default 20, max 200). Flat 2 credits when hasLiveTab is true; 0 credits when hasLiveTab is false. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeHashtagSearchParams {
-    /** Hashtag with or without the # (min 2 characters). */
+    /** Hashtag with or without the # (min 2 characters). One token — spaces are 400 HASHTAG_HAS_SPACES. */
     q: string;
-    /** Max items to return (default 20, max 200). Returns a single window; use limit to size it. No cursor. Billed per result. */
+    /** Max items to return (default 10, max 200). Returns a single window; use limit to size it. No cursor. Billed per result. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeCommentRepliesParams {
@@ -172,7 +172,7 @@ export interface YoutubeCommentRepliesParams {
     limit?: number;
     /** Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeChannelPlaylistsParams {
@@ -182,7 +182,7 @@ export interface YoutubeChannelPlaylistsParams {
     limit?: number;
     /** Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeCommunityPostsParams {
@@ -192,13 +192,13 @@ export interface YoutubeCommunityPostsParams {
     limit?: number;
     /** Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeCommunityPostDetailsParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface YoutubeVideoSponsorsParams {
@@ -208,7 +208,7 @@ export interface YoutubeVideoSponsorsParams {
     minVotes?: number;
     /** Comma-separated categories. Default sponsor,selfpromo,interaction. Also intro,outro,preview,music_offtopic,poi_highlight,filler. */
     categories?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class YoutubeApi {
@@ -218,15 +218,15 @@ export declare class YoutubeApi {
     transcript(params: YoutubeTranscriptParams): Promise<ApiEnvelope>;
     /** YouTube Audio Transcript — Speech-to-text for YouTube audio. Use it when a video has no captions — or when you want a transcript of what was actually spoken rather than YouTube's published captions. Priced per started minute of audio. (2 credits/min of audio) */
     audioTranscript(params: YoutubeAudioTranscriptParams): Promise<ApiEnvelope>;
-    /** YouTube Summarizer — GPT summary from YouTube's published captions — same source as /transcript. Flat 3 credits; caption-miss 404 is free. (3 credits) */
+    /** YouTube Summarizer — AI summary from YouTube's published captions — same source as /transcript. Flat 3 credits; caption-miss 404 is free. (3 credits) */
     summarize(params: YoutubeSummarizeParams): Promise<ApiEnvelope>;
     /** YouTube Video Details — YouTube video metadata + stats. Always includes degraded / degradedReason — retry when degraded is true. (1 credit) */
     videoDetails(params: YoutubeVideoDetailsParams): Promise<ApiEnvelope>;
-    /** YouTube Comments — Get comments on any YouTube video — text, author, likes, and truncated publishedTimeApprox from the relative label, with cursor pagination (nextCursor + hasMore). Flat 2 credits per call. (2 credits) */
+    /** YouTube Comments — Get comments on any YouTube video — text, author, likes, and truncated publishedTimeApprox from the relative label, with cursor pagination (nextCursor + hasMore). Flat 2 credits per call; 0 when the video has comments turned off (commentsDisabled: true). (2 credits) */
     comments(params: YoutubeCommentsParams): Promise<ApiEnvelope>;
     /** YouTube Channel Details — YouTube channel stats — ISO country, createdAt date-only, real banner or null, quote-aware SEO tags, absolute links. Flat 1 credit. (1 credit) */
     channelDetails(params: YoutubeChannelDetailsParams): Promise<ApiEnvelope>;
-    /** YouTube Search — YouTube search with cursor pagination — typed hits, ids, canonical URLs, filters (2 credits/page). (2 credits) */
+    /** YouTube Search — YouTube search with cursor pagination — typed hits, ids, canonical URLs, filters (2 credits/page, 0 when a page finds nothing). (2 credits) */
     search(params: YoutubeSearchParams): Promise<ApiEnvelope>;
     /** YouTube Channel Videos — Channel uploads with cursor pagination — exact publishedAt from reel_item_watch (same as channel-shorts). (2 credits) */
     channelVideos(params: YoutubeChannelVideosParams): Promise<ApiEnvelope>;
@@ -248,7 +248,7 @@ export declare class YoutubeApi {
     trendingShorts(params?: YoutubeTrendingShortsParams): Promise<ApiEnvelope>;
     /** YouTube Channel Streams — Channel Live tab only — liveStatus per row; 0 credits when hasLiveTab is false. (2 credits) */
     channelStreams(params: YoutubeChannelStreamsParams): Promise<ApiEnvelope>;
-    /** YouTube Hashtag Search — Videos from youtube.com/hashtag/{name} — nested channel{}, viewCountIsApproximate. Not keyword search. (~20 credits (1/result)) */
+    /** YouTube Hashtag Search — Videos from youtube.com/hashtag/{name} — nested channel{}, viewCountIsApproximate. Not keyword search. (~10 credits (1/result)) */
     hashtagSearch(params: YoutubeHashtagSearchParams): Promise<ApiEnvelope>;
     /** YouTube Comment Replies — Replies under a top-level comment — parentReplyCount + cursor. Nested reply ids return 404. (2 credits) */
     commentReplies(params: YoutubeCommentRepliesParams): Promise<ApiEnvelope>;
@@ -262,7 +262,7 @@ export declare class YoutubeApi {
     videoSponsors(params: YoutubeVideoSponsorsParams): Promise<ApiEnvelope>;
 }
 export interface TiktokTranscriptParams {
-    /** Public TikTok video URL, e.g. https://tiktok.com/@user/video/ID. 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. */
+    /** Public TikTok video or photo-carousel URL, e.g. https://www.tiktok.com/@khaby.lame/video/7646812028874673439 or https://www.tiktok.com/@user/photo/ID (the url channel-posts returns for mediaType photo). 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. */
     url: string;
     /** Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect. */
     language?: string;
@@ -270,37 +270,37 @@ export interface TiktokTranscriptParams {
     cache?: boolean;
 }
 export interface TiktokSummarizeParams {
-    /** Public TikTok video URL, e.g. https://tiktok.com/@user/video/ID. 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. */
+    /** Public TikTok video or photo-carousel URL, e.g. https://www.tiktok.com/@khaby.lame/video/7646812028874673439 or https://www.tiktok.com/@user/photo/ID (the url channel-posts returns for mediaType photo). 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. */
     url: string;
     /** ISO code, e.g. "tr": pins the speech language and sets the summary output language. Defaults to auto-detect + English summary. */
     language?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokVideoDetailsParams {
-    /** Public TikTok video URL, e.g. https://tiktok.com/@user/video/ID. 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. */
+    /** Public TikTok video or photo-carousel URL, e.g. https://www.tiktok.com/@khaby.lame/video/7646812028874673439 or https://www.tiktok.com/@user/photo/ID (the url channel-posts returns for mediaType photo). 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokCommentsParams {
-    /** Public TikTok video URL, e.g. https://tiktok.com/@user/video/ID. 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. */
+    /** Public TikTok video or photo-carousel URL, e.g. https://www.tiktok.com/@khaby.lame/video/7646812028874673439 or https://www.tiktok.com/@user/photo/ID (the url channel-posts returns for mediaType photo). 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. */
     url: string;
     /** Max items to return (default 50, max 500). Flat 2 credits per call. */
     limit?: number;
     /** 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. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokChannelDetailsParams {
     /** 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. */
     url: string;
-    /** Set true to include TikTok's upstream user/statsV2 blob under raw (privacy ints, profileTab, …). Default false — curated fields only. */
+    /** Set true to include TikTok's upstream user/statsV2 blob under raw, plus createTimeUnix (unix twin of createTime). Default false — curated fields only. */
     raw?: boolean;
-    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. */
     cache?: boolean;
-    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. Envelope: cached + cachedAt. */
+    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. */
     cacheMaxAge?: string;
 }
 export interface TiktokProfileRegionParams {
@@ -308,8 +308,10 @@ export interface TiktokProfileRegionParams {
     url: string;
     /** Set true to include TikTok's upstream user/statsV2 blob under raw. Default false — curated fields only. */
     raw?: boolean;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** 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. */
     cache?: boolean;
+    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. */
+    cacheMaxAge?: string;
 }
 export interface TiktokAudienceDemographicsParams {
     /** 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. */
@@ -318,7 +320,7 @@ export interface TiktokAudienceDemographicsParams {
     videos?: number;
     /** Max countries in audienceLocations; remainder folds into other{count,percentage}. Omit for the full list (other is omitted when unused). */
     countriesLimit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokSearchSuggestionsParams {
@@ -330,21 +332,21 @@ export interface TiktokSearchSuggestionsParams {
     language?: string;
     /** Max items to return (default 20, max 100). Flat 2 credits per call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokChannelPostsParams {
     /** 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. */
     url: string;
-    /** How many of the creator's latest videos to return on this page (default 20, max 200). Newest first. Flat 2 credits per call. */
+    /** How many of the creator's latest videos to return on this page (default 20, max 200). Newest first. Flat 2 credits per successful call. */
     limit?: number;
     /** 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. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokCommentRepliesParams {
-    /** Public TikTok video URL, e.g. https://tiktok.com/@user/video/ID. 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. */
+    /** Public TikTok video or photo-carousel URL, e.g. https://www.tiktok.com/@khaby.lame/video/7646812028874673439 or https://www.tiktok.com/@user/photo/ID (the url channel-posts returns for mediaType photo). 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. */
     url: string;
     /** ID of the parent (top-level) comment to fetch replies for — from the comments endpoint. Legacy alias: comment_id. */
     commentId: string;
@@ -352,7 +354,7 @@ export interface TiktokCommentRepliesParams {
     limit?: number;
     /** Pagination cursor. Leave empty for the first page; then pass the nextCursor value from the previous response. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokUserFollowersParams {
@@ -362,7 +364,7 @@ export interface TiktokUserFollowersParams {
     limit?: number;
     /** Pagination cursor (TikTok minCursor). Leave empty for the first page; then pass nextCursor from the previous response. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokUserFollowingsParams {
@@ -372,17 +374,17 @@ export interface TiktokUserFollowingsParams {
     limit?: number;
     /** Pagination cursor (TikTok minCursor). Leave empty for the first page; then pass nextCursor from the previous response. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokMusicPostsParams {
     /** 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. */
     url: string;
-    /** Max items to return (default 20, max 200). Flat 2 credits per call. */
+    /** Most videos to return (default 20, 1–50; outside that range is a 400). TikTok serves this feed in short pages, so a call can return fewer than limit with a nextCursor to continue. Flat 2 credits per call. */
     limit?: number;
-    /** Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response. */
+    /** 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. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokTopSearchParams {
@@ -392,19 +394,19 @@ export interface TiktokTopSearchParams {
     limit?: number;
     /** Pagination cursor. Leave 0 for the first page; then pass nextCursor from the previous response. TikTok may return duplicates across pages. */
     cursor?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokSearchByHashtagParams {
-    /** Hashtag for the /tag/{name} challenge feed, with or without # (min 2). Not a keyword query. */
+    /** Single hashtag token for the /tag/{name} challenge feed, with or without # (min 2). Spaces are 400 — use /v1/tiktok/top-search for a keyword query. */
     q: string;
-    /** Max items to return (default 20, max 100). Billed per result. */
+    /** Max items to return (default 10, max 100). Billed per result. */
     limit?: number;
     /** 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. */
     cursor?: number;
-    /** Two-letter ISO 3166-1 country our request is sent from. Default US. Does not filter results by country. */
+    /** Two-letter ISO 3166-1 country code. Default US. Accepted for compatibility; does not filter results by country. */
     region?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokSearchUsersParams {
@@ -414,15 +416,13 @@ export interface TiktokSearchUsersParams {
     limit?: number;
     /** 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. */
     cursor?: string;
-    /** 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. */
-    fallback?: boolean;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokSongDetailsParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokTrendingFeedParams {
@@ -438,7 +438,7 @@ export interface TiktokTrendingFeedParams {
     page?: number;
     /** Max items to return (default 20, max 200). Flat 2 credits per call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokPopularHashtagsParams {
@@ -454,41 +454,23 @@ export interface TiktokPopularHashtagsParams {
     newOnBoard?: boolean;
     /** Optional Creative Center industry_id. */
     industryId?: string;
-    /** Optional niche seed for legacy co-occurrence + challenge/detail enrich. Omit, or pass trending, to use the Creative Center chart. A chart miss is 502 — trending is not treated as a niche seed. */
+    /** Optional niche seed for co-occurrence + challenge/detail enrich. Omit, or pass trending, to try the Creative Center chart (10s cap); a miss falls through to related tags for fyp (source=niche_fallback) and opens a chart circuit for that country/period/page/industry. Later calls with the same chart parameters skip the chart (chartStatus=skipped_circuit_open) until the cooldown expires. Any other value skips the chart. */
     query?: string;
     /** Max items to return (default 20, max 100). Flat 2 credits per call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
-    cache?: boolean;
-}
-export interface TiktokPopularSongsParams {
-    /** Two-letter ISO country. Default US. */
-    country?: string;
-    /** 7, 30, or 120 days (180→120). Default 7. */
-    period?: number;
-    /** Page number (default 1). */
-    page?: number;
-    /** popular | surging. Default popular. */
-    rankType?: string;
-    /** Only sounds newly on the Top 100. */
-    newOnBoard?: boolean;
-    /** Only Commercial Music Library–cleared sounds. */
-    commercialMusic?: boolean;
-    /** Max items to return (default 20, max 20). Flat 2 credits per call. */
-    limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokLiveParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokLiveInfoParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokPopularCreatorsParams {
@@ -498,13 +480,13 @@ export interface TiktokPopularCreatorsParams {
     sort?: string;
     /** Creative Center page (default 1). */
     page?: number;
-    /** Optional range on FYP/Apify fallthrough: 10k-100k, 100k-1m, 1m-10m, >10m. */
+    /** Optional range on the For You ranking: 10k-100k, 100k-1m, 1m-10m, >10m. */
     follower_count?: string;
     /** Max items to return (default 20, max 100). Flat 2 credits per call. */
     limit?: number;
-    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. */
     cache?: boolean;
-    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. Envelope: cached + cachedAt. */
+    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. */
     cacheMaxAge?: string;
 }
 export declare class TiktokApi {
@@ -526,7 +508,7 @@ export declare class TiktokApi {
     audienceDemographics(params: TiktokAudienceDemographicsParams): Promise<ApiEnvelope>;
     /** TikTok Search Suggestions — Get the autocomplete terms TikTok suggests in its search bar for a keyword — the real phrases people search, ranked, so you can find trending queries and long-tail keyword ideas. (2 credits) */
     searchSuggestions(params: TiktokSearchSuggestionsParams): Promise<ApiEnvelope>;
-    /** TikTok Channel Posts — Latest videos from a TikTok profile. May return a labelled 6h-stale snapshot (degraded + staleAgeMs) when the live list is blocked. Failures are 0 credits. (2 credits) */
+    /** TikTok Channel Posts — Latest videos from a TikTok profile, cursor-paginated, with isPinned, caption mention text and brand signals (promoCodes, brandMentions). Flat 2 credits; failures are 0 credits. (2 credits) */
     channelPosts(params: TiktokChannelPostsParams): Promise<ApiEnvelope>;
     /** TikTok Comment Replies — Replies under a TikTok comment — same authorId/authorSecUid/commentLanguage shape as comments. (2 credits) */
     commentReplies(params: TiktokCommentRepliesParams): Promise<ApiEnvelope>;
@@ -538,21 +520,19 @@ export declare class TiktokApi {
     musicPosts(params: TiktokMusicPostsParams): Promise<ApiEnvelope>;
     /** TikTok Top Search — TikTok Top/General search — videos and photo carousels when TikTok includes them, with contentType + images[]. (2 credits) */
     topSearch(params: TiktokTopSearchParams): Promise<ApiEnvelope>;
-    /** TikTok Search by Hashtag — Videos from TikTok's /tag/{name} challenge feed — not keyword or username search. Cursor + hasMore. (~14 credits (0.7/result)) */
+    /** TikTok Search by Hashtag — Videos from TikTok's /tag/{name} challenge feed — not keyword or username search. Cursor + hasMore. (~7 credits (0.7/result)) */
     searchByHashtag(params: TiktokSearchByHashtagParams): Promise<ApiEnvelope>;
-    /** TikTok Search Users — Search TikTok users — distinct creators only, id + secUid, per-counter isApproximate flags, cursor pagination. (1 credit) */
+    /** TikTok Search Users — Find TikTok creators by keyword — distinct authors ranking for the query, id + secUid, per-counter isApproximate flags, cursor pagination. (1 credit) */
     searchUsers(params: TiktokSearchUsersParams): Promise<ApiEnvelope>;
-    /** TikTok Song Details — TikTok sound metadata — usageCount, artists[{id,secUid,handle}], audio{bpm,loudness,beats}, commerce rights (1 credit native). (1 credit) */
+    /** TikTok Song Details — TikTok sound metadata — usageCount, artists[{id,secUid,handle}], audio{bpm,loudness,beats}, commerce rights (1 credit; 2 via the fallback path). (1 credit (2 via fallback path)) */
     songDetails(params: TiktokSongDetailsParams): Promise<ApiEnvelope>;
     /** TikTok Trending Feed — For You by default; pass orderBy/period/page for Creative Center popular videos (like/hot/comment/repost) with totalCount. Flat 2 credits. (2 credits) */
     trendingFeed(params?: TiktokTrendingFeedParams): Promise<ApiEnvelope>;
-    /** TikTok Popular Hashtags — TikTok Creative Center hashtag chart — real videoCount/totalPlays, plus rankDiff and trend[] on that path. Flat 2 credits. (2 credits) */
+    /** TikTok Popular Hashtags — Related TikTok hashtags — Creative Center chart when it answers (asOf = the chart's data date, stale when over 3 days old), otherwise a disclosed niche fallback. Flat 2 credits. (2 credits) */
     popularHashtags(params?: TiktokPopularHashtagsParams): Promise<ApiEnvelope>;
-    /** TikTok Popular Songs — Creative Center popular/surging sounds — rankDiff, trend[], commercialMusic. 110s deadline, 0 credits on 502. (2 credits) */
-    popularSongs(params?: TiktokPopularSongsParams): Promise<ApiEnvelope>;
-    /** TikTok Live — Is this TikTok creator live — isLive/status, creator.id/secUid, room, streamQualities with flv/hls/cmaf/dash. (1 credit) */
+    /** TikTok Live — Check whether a TikTok creator is live right now and get the stream URLs (CMAF/DASH + FLV, HLS when TikTok exposes it) — one GET with an @handle, 1 credit. (1 credit) */
     live(params: TiktokLiveParams): Promise<ApiEnvelope>;
-    /** TikTok Live Info — Identical to TikTok Live (isLive, creator.id/secUid, streamQualities hls/cmaf). (7 credits) */
+    /** TikTok Live Info — Identical to TikTok Live (isLive, creator.id/secUid, streamQualities hls/cmaf). (1 credit) */
     liveInfo(params: TiktokLiveInfoParams): Promise<ApiEnvelope>;
     /** TikTok Popular Creators — Creative Center creators + createTime / bioLinkRisk / ttSeller hydrate for partnership vetting. (2 credits) */
     popularCreators(params?: TiktokPopularCreatorsParams): Promise<ApiEnvelope>;
@@ -562,7 +542,7 @@ export interface InstagramTranscriptParams {
     url: string;
     /** Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect. */
     language?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface InstagramSummarizeParams {
@@ -570,39 +550,45 @@ export interface InstagramSummarizeParams {
     url: string;
     /** ISO code, e.g. "tr": pins the speech language and sets the summary output language. Defaults to auto-detect + English summary. */
     language?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface InstagramDetailsParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface InstagramCommentsParams {
     /** 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. */
     url: string;
-    /** Max items to return (default 50, max 500). Billed per result. */
+    /** Max items to return (default 10, max 500). Billed per result. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** 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). */
+    cursor?: string;
+    /** Comment order: popular (Instagram's ranking, the default when omitted) or recent (newest first). recent is served by one fetch path only, so it fails over less. The order is kept in nextCursor — pass the same sort on every page; a different one is 400. */
+    sort?: string;
+    /** Leave out comments shorter than this many characters (1–500; e.g. 3 drops single emojis). Billed on the comments returned. */
+    minLength?: number;
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface InstagramChannelDetailsParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. */
     cache?: boolean;
-    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. Envelope: cached + cachedAt. */
+    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. */
     cacheMaxAge?: string;
 }
 export interface InstagramChannelPostsParams {
     /** 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. */
     url: string;
-    /** Max items to return (default 20, max 200). Billed per result. */
+    /** Max items to return (default 10, max 200). Billed per result. */
     limit?: number;
     /** 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. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface InstagramChannelReelsParams {
@@ -610,29 +596,31 @@ export interface InstagramChannelReelsParams {
     url?: string;
     /** 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. */
     userId?: string;
-    /** Max items to return (default 20, max 200). Billed per result. */
+    /** Max items to return (default 10, max 200). Billed per result. */
     limit?: number;
     /** 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. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Only Reels published on or after this ISO date or datetime (e.g. 2026-10-01 or 2026-10-01T00:00:00Z; no offset means UTC). Pinned Reels older than since are left out without ending the list; once a page reaches an older non-pinned Reel, hasMore is false. Reels with no known date are left out. Billed on the returned Reels. */
+    since?: string;
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface InstagramReelsSearchParams {
-    /** Hashtag (without #) or keyword (min 2 characters). */
+    /** Hashtag without the # (min 2 characters). One token — spaces are 400 HASHTAG_HAS_SPACES. */
     q: string;
-    /** Max items to return (default 20, max 200). Flat 2 credits per call. */
+    /** Max items to return (default 20, max 50). Flat 2 credits per call. */
     limit?: number;
     /** last_24_hours | last_week | last_month | last_year (aliases: today, this_week, this_month, this_year). */
     datePosted?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface InstagramTrendingReelsParams {
     /** 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[]. */
     country?: string;
-    /** Max items to return (default 10, max 200). Flat 2 credits per call. */
+    /** Max items to return (default 10, max 50). Flat 2 credits per call. */
     limit?: number;
-    /** 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 (typically under 20s, hard-capped at 110s); the fresh result still refreshes the cache. */
+    /** 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. */
     cache?: boolean;
 }
 export interface InstagramTaggedPostsParams {
@@ -642,29 +630,29 @@ export interface InstagramTaggedPostsParams {
     limit?: number;
     /** Leave empty for the first page; then pass the nextCursor value returned in the previous response. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface InstagramReelsByAudioIdParams {
     /** Instagram audio/music ID or full audio URL, e.g. 27919946310946207. */
     audioId: string;
-    /** Max items to return (default 20, max 200). Billed per result. */
+    /** Max items to return (default 10, max 200). Billed per result. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface InstagramHashtagSearchParams {
-    /** Hashtag without the # (min 2 characters). */
+    /** Hashtag without the # (min 2 characters). One token — spaces are 400 HASHTAG_HAS_SPACES. */
     q: string;
-    /** Max items to return (default 20, max 200). Flat 2 credits per call. */
+    /** Max items to return (default 20, max 50). Flat 2 credits per call. */
     limit?: number;
     /** all (default) or reels — return only Reels/clips when set to reels. */
     mediaType?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface InstagramProfileSearchParams {
-    /** Account name, @handle, or profile URL to resolve (min 2 characters). Not a niche keyword search. */
+    /** Account name, @handle, or profile URL to resolve (min 2 characters). A leading _, accents (misión → mision), spaces and URL query strings (?igsh=…) are stripped. A q with no usable username characters is 400 BAD_REQUEST. Not a niche keyword search. */
     q: string;
     /** Serve from the 24h shared cache when available (0 credits on hit). Default true — set false to always fetch fresh. */
     cache?: boolean;
@@ -672,7 +660,7 @@ export interface InstagramProfileSearchParams {
 export interface InstagramEmbedParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface InstagramHighlightsParams {
@@ -680,21 +668,21 @@ export interface InstagramHighlightsParams {
     url?: string;
     /** 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. */
     userId?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface InstagramHighlightsDetailsParams {
     /** Highlight id from /v1/instagram/highlights (with or without highlight: prefix). */
     id: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface InstagramBasicProfileParams {
-    /** Instagram numeric user ID (e.g. 13460080). A profile URL, @handle, or username is also accepted and resolved automatically. */
+    /** 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. */
     userId: string;
-    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. */
     cache?: boolean;
-    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. Envelope: cached + cachedAt. */
+    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. */
     cacheMaxAge?: string;
 }
 export declare class InstagramApi {
@@ -704,27 +692,27 @@ export declare class InstagramApi {
     transcript(params: InstagramTranscriptParams): Promise<ApiEnvelope>;
     /** Instagram Summarizer — Get an AI summary of any Instagram Reel — a short paragraph plus key points, without watching the video. (4 credits) */
     summarize(params: InstagramSummarizeParams): Promise<ApiEnvelope>;
-    /** Instagram Post Details — Get an Instagram post, Reel or carousel — caption, likes, comments, views, media URLs, author, and per-slide children on carousels. (1 credit) */
+    /** Instagram Post & Reel Details — Get an Instagram post, Reel or carousel — caption, publish date, likes, comments, views, media URLs, author, per-slide children, and promo codes / disclosure words from the caption. (1 credit) */
     details(params: InstagramDetailsParams): Promise<ApiEnvelope>;
-    /** Instagram Post Comments — Get the comments on any Instagram post or Reel — text, author, avatar, likes, and timestamp for each comment. (~45 credits (0.9/result)) */
+    /** Instagram Post Comments — Session-paged Instagram comments — a logged-out 2-row preview of a larger thread is 503 SESSION_UNAVAILABLE at 0 credits. (~9 credits (0.9/result)) */
     comments(params: InstagramCommentsParams): Promise<ApiEnvelope>;
     /** Instagram Channel Details — Instagram profile stats — fixed key set (null fillers), fbid, bioLinks, isBusinessAccount, approx flags. (1 credit) */
     channelDetails(params: InstagramChannelDetailsParams): Promise<ApiEnvelope>;
-    /** Instagram Channel Posts — Latest posts from a public Instagram profile — carousel children[], mediaCount, user{} in one call. (~6 credits (0.3/result)) */
+    /** Instagram Channel Posts — Latest posts from a public Instagram profile — carousel children[], mediaCount, isPinned, caption promo codes, user{} in one call. (~3 credits (0.3/result)) */
     channelPosts(params: InstagramChannelPostsParams): Promise<ApiEnvelope>;
-    /** Instagram Channel Reels — Latest Reels from a public Instagram profile — pass userId to skip resolve; ceil(n×0.3) credits; nextCursor + hasMore. (~6 credits (0.3/result)) */
+    /** Instagram Channel Reels — Latest Reels from a public Instagram profile — isPinned, optional since date filter, pass userId to skip resolve; ceil(n×0.3) credits; nextCursor + hasMore. (~3 credits (0.3/result)) */
     channelReels(params?: InstagramChannelReelsParams): Promise<ApiEnvelope>;
-    /** Instagram Reels Search — Native Instagram Reels hashtag search — engagement.views + viewsSource, location, commercial flags. Flat 2 credits. (2 credits) */
+    /** Instagram Reels Search — Native tag feed first, slower fallback paths on a miss. Max 50. Flat 2 credits. (2 credits) */
     reelsSearch(params: InstagramReelsSearchParams): Promise<ApiEnvelope>;
-    /** Instagram Trending Reels — Cache-first trending Reels — flat 2 credits every call (4h TTL). (2 credits) */
+    /** Instagram Trending Reels — Cache-first trending Reels. Feed outage → labelled country hashtag-clips stand-in (listing field), never a silent swap. Max 50. Flat 2 credits. (2 credits) */
     trendingReels(params?: InstagramTrendingReelsParams): Promise<ApiEnvelope>;
     /** Instagram Tagged Posts — Posts that tag an Instagram account — author verified/avatar when available, staleFeed when Instagram only exposes an archive. (1 credit) */
     taggedPosts(params: InstagramTaggedPostsParams): Promise<ApiEnvelope>;
-    /** Instagram Reels By Audio ID — Is this Instagram sound trending? Reels that use it + isTrendingInClips / trendRank / rich music{}. (~28 credits (1.4/result)) */
+    /** Instagram Reels By Audio ID — Is this Instagram sound trending? Reels that use it + isTrendingInClips / trendRank / rich music{}. (~14 credits (1.4/result)) */
     reelsByAudioId(params: InstagramReelsByAudioIdParams): Promise<ApiEnvelope>;
-    /** Instagram Hashtag Search — Native Instagram hashtag Explore — Reels-heavy top surface with real likes, views, captions, and paid flags. Flat 2 credits. (2 credits) */
+    /** Instagram Hashtag Search — Hashtag Explore: native grid first, fallback path only on miss. Max 50. Flat 2 credits. (2 credits) */
     hashtagSearch(params: InstagramHashtagSearchParams): Promise<ApiEnvelope>;
-    /** Instagram Profile Search — Resolve a brand or @handle to one public Instagram profile — stable id, bio, links, and stats (not niche discovery). (1 credit) */
+    /** Instagram Profile Search — Resolve a brand or @handle to one public Instagram profile — or search accounts by free text (mode=search). (1 credit) */
     profileSearch(params: InstagramProfileSearchParams): Promise<ApiEnvelope>;
     /** Instagram Embed HTML — Classic Instagram embed snippet — blockquote.instagram-media + embed.js. Drop html into your page. (1 credit) */
     embed(params: InstagramEmbedParams): Promise<ApiEnvelope>;
@@ -738,29 +726,29 @@ export declare class InstagramApi {
 export interface FacebookDetailsParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface FacebookSummarizeParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface FacebookCommentsParams {
-    /** Facebook post or Reel URL. Omit when feedbackId is set. The URL platform must match this endpoint's platform. */
+    /** 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). */
     url?: string;
     /** Post feedback id from /v1/facebook/details (base64 feedback:POSTID). Prefer when you already have it — also accepts feedback_id. */
     feedbackId?: string;
     /** Max items to return (default 50, max 500). Flat 2 credits per call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface FacebookPageDetailsParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface FacebookProfilePostsParams {
@@ -768,7 +756,7 @@ export interface FacebookProfilePostsParams {
     url: string;
     /** 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. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface FacebookProfileReelsParams {
@@ -776,17 +764,17 @@ export interface FacebookProfileReelsParams {
     url: string;
     /** Max items to return (default 20, max 200). Flat 2 credits per call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface FacebookGroupPostsParams {
-    /** Public Facebook group URL, e.g. https://facebook.com/groups/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. */
+    /** 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. */
     url: string;
-    /** Max items to return (default 20, max 200). Flat 2 credits per call. */
+    /** Max posts to return (default 10, max 200; up to 80 per call — above that you get 80 with truncatedReason per-call-cap). Billed 1 credit per returned post, minimum 2. */
     limit?: number;
     /** TOP_POSTS | RECENT_ACTIVITY | CHRONOLOGICAL (default) | CHRONOLOGICAL_LISTINGS. Maps to Facebook sorting_setting. */
     sortBy?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface FacebookCommentRepliesParams {
@@ -796,7 +784,7 @@ export interface FacebookCommentRepliesParams {
     commentId: string;
     /** Max items to return (default 50, max 500). Flat 2 credits per call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface FacebookProfilePhotosParams {
@@ -804,13 +792,13 @@ export interface FacebookProfilePhotosParams {
     url: string;
     /** 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. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class FacebookApi {
     private readonly core;
     constructor(core: HttpCore);
-    /** Facebook Details — Facebook post or Reel — caption, engagement, author id, video{} playback, and music when Facebook exposes them. (2 credits) */
+    /** Facebook Post & Reel Details — Facebook post or Reel — caption, engagement, author id, video{} playback, and music when Facebook exposes them. (2 credits) */
     details(params: FacebookDetailsParams): Promise<ApiEnvelope>;
     /** Facebook Summarizer — Summarizer (4 credits) */
     summarize(params: FacebookSummarizeParams): Promise<ApiEnvelope>;
@@ -822,7 +810,7 @@ export declare class FacebookApi {
     profilePosts(params: FacebookProfilePostsParams): Promise<ApiEnvelope>;
     /** Facebook Profile Reels — Latest Facebook page Reels — views, likes, comments, shares; newest-first without archive padding. (2 credits) */
     profileReels(params: FacebookProfileReelsParams): Promise<ApiEnvelope>;
-    /** Facebook Group Posts — Public Facebook group posts — listingHits / hydrateFailures / hydrateSkipped, sortBy, and per-count *IsApproximate. (2 credits) */
+    /** Facebook Group Posts — Newest posts from a public Facebook group — caption, author, engagement, sortBy; 1 credit per post. (~10 credits (1/result)) */
     groupPosts(params: FacebookGroupPostsParams): Promise<ApiEnvelope>;
     /** Facebook Comment Replies — Comment Replies (2 credits) */
     commentReplies(params: FacebookCommentRepliesParams): Promise<ApiEnvelope>;
@@ -832,21 +820,21 @@ export declare class FacebookApi {
 export interface TwitterTweetDetailsParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TwitterTranscriptParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TwitterProfileParams {
     /** 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. */
     url: string;
-    /** Set true to use the 1-hour profile cache (0 credits on hit). Default false — always fetch fresh. Prefer cacheMaxAge for 1d–30d. Envelope includes cached + cachedAt on hits. */
+    /** Set true to use the 24-hour profile cache (0 credits on hit). Default false — always fetch fresh. Prefer cacheMaxAge for 1d–30d. */
     cache?: boolean;
-    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. Envelope: cached + cachedAt. */
+    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. */
     cacheMaxAge?: string;
 }
 export interface TwitterUserTweetsParams {
@@ -854,13 +842,15 @@ export interface TwitterUserTweetsParams {
     url: string;
     /** 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. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** nextCursor from a previous response (an offset into the embed window). Omit for the first page. */
+    cursor?: string;
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TwitterCommunityParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TwitterCommunityTweetsParams {
@@ -868,7 +858,7 @@ export interface TwitterCommunityTweetsParams {
     url: string;
     /** Max items to return (default 25, max 200). Flat 2 credits per call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class TwitterApi {
@@ -876,7 +866,7 @@ export declare class TwitterApi {
     constructor(core: HttpCore);
     /** Twitter/X Tweet Details — One tweet as JSON — text, author (followers), likes/replies/retweets/quotes, media, ISO publishedAt. (1 credit) */
     tweetDetails(params: TwitterTweetDetailsParams): Promise<ApiEnvelope>;
-    /** Twitter/X Transcript — Tweet text as a transcript — timingSource none (not Whisper). Flat 1 credit. (1 credit) */
+    /** Twitter/X Transcript — Tweet text as a transcript — timingSource none (not speech-to-text). Flat 1 credit. (1 credit) */
     transcript(params: TwitterTranscriptParams): Promise<ApiEnvelope>;
     /** Twitter/X Profile — X profile: verified + blue/legacy/identity, displayName, avatar/banner, tipjar→contact{}, expanded website. (1 credit) */
     profile(params: TwitterProfileParams): Promise<ApiEnvelope>;
@@ -898,13 +888,13 @@ export interface RedditSubredditPostsParams {
     timeframe?: string;
     /** Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface RedditPostDetailsParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface RedditPostCommentsParams {
@@ -914,7 +904,7 @@ export interface RedditPostCommentsParams {
     limit?: number;
     /** Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface RedditPostTranscriptParams {
@@ -922,7 +912,7 @@ export interface RedditPostTranscriptParams {
     url: string;
     /** Max items to return (default 50, max 200). Flat 2 credits per call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface RedditSearchParams {
@@ -936,13 +926,13 @@ export interface RedditSearchParams {
     limit?: number;
     /** Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface RedditSubredditDetailsParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface RedditSubredditSearchParams {
@@ -958,7 +948,7 @@ export interface RedditSubredditSearchParams {
     limit?: number;
     /** Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class RedditApi {
@@ -968,13 +958,13 @@ export declare class RedditApi {
     subredditPosts(params: RedditSubredditPostsParams): Promise<ApiEnvelope>;
     /** Reddit Post Details — Get a Reddit post — title, body, score, comments count, subreddit, and author as structured JSON. (1 credit) */
     postDetails(params: RedditPostDetailsParams): Promise<ApiEnvelope>;
-    /** Reddit Post Comments — Flat Reddit comment threads with depth/parentId, cursor pagination, and the parent post in one call. (2 credits) */
+    /** Reddit Post Comments — Flat Reddit comment threads with depth/parentId and the parent post in one call. (2 credits) */
     postComments(params: RedditPostCommentsParams): Promise<ApiEnvelope>;
     /** Reddit Post Transcript — Written post text — title, body and top comments. Not a speech transcript. Flat 2 credits. (2 credits) */
     postTranscript(params: RedditPostTranscriptParams): Promise<ApiEnvelope>;
     /** Reddit Search — Reddit site-wide post search — sort + timeframe + cursor, score/upvoteRatio, authorFullname. Flat 2 credits. (2 credits) */
     search(params: RedditSearchParams): Promise<ApiEnvelope>;
-    /** Reddit Subreddit Details — Subreddit card — id (t5_…), members, activeUsers, rules[], ISO createdAt, nsfw/type. Flat 1 credit. (1 credit) */
+    /** Reddit Subreddit Details — Subreddit card — id (t5_…), weekly visitors and contributions, rules[], ISO createdAt. Flat 1 credit. (1 credit) */
     subredditDetails(params: RedditSubredditDetailsParams): Promise<ApiEnvelope>;
     /** Reddit Subreddit Post Search — Search posts inside one subreddit — not subreddit discovery. Same sort/timeframe as site-wide Search. Flat 2 credits. (2 credits) */
     subredditSearch(params: RedditSubredditSearchParams): Promise<ApiEnvelope>;
@@ -982,21 +972,21 @@ export declare class RedditApi {
 export interface ThreadsProfileParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface ThreadsUserPostsParams {
     /** 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. */
     url: string;
-    /** Max items to return (default 20, max 100). Threads only exposes the last ~20–30 public posts on this surface — asking for 100 will not return 100. Flat 2 credits on the native path; Apify fallback ~0.7/post (min 2). */
+    /** 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 call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface ThreadsPostDetailsParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface ThreadsSearchParams {
@@ -1004,7 +994,9 @@ export interface ThreadsSearchParams {
     q: string;
     /** Max items to return (default 25, max 200). Flat 2 credits per call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** 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. */
+    orderBy?: string;
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface ThreadsSearchUsersParams {
@@ -1012,19 +1004,19 @@ export interface ThreadsSearchUsersParams {
     q: string;
     /** Max items to return (default 20, max 100). Flat 1 credit per call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class ThreadsApi {
     private readonly core;
     constructor(core: HttpCore);
-    /** Threads Profile — Threads profile — displayName, private/isPrivate, bioLinks (Meta verified), isThreadsOnlyUser, transparencyLabel, bioFragments, HD avatars (1 credit). (1 credit) */
+    /** Threads Profile — Threads profile — displayName, isPrivate, bioLinks (Meta verified), isThreadsOnlyUser, transparencyLabel, bioFragments, HD avatars (1 credit). (1 credit) */
     profile(params: ThreadsProfileParams): Promise<ApiEnvelope>;
-    /** Threads User Posts — Recent Threads posts — engagement{views,likes,replies,reposts,quotes}, threadId/isReply. Flat 2 credits. (2 credits) */
+    /** Threads User Posts — Recent Threads posts — engagement{views,likes,replies,reposts,quotes}, threadId/isReply. Flat 2 credits. source + timings. (2 credits) */
     userPosts(params: ThreadsUserPostsParams): Promise<ApiEnvelope>;
-    /** Threads Post Details — Threads post — engagement (views when exposed), comments[], relatedPosts[], threadId/isReply. Flat 1 credit. (1 credit) */
+    /** Threads Post Details — Threads post — engagement (views when exposed), comments[], suggestedPosts[], threadId/isReply. Flat 1 credit. (1 credit) */
     postDetails(params: ThreadsPostDetailsParams): Promise<ApiEnvelope>;
-    /** Threads Post Search — Threads keyword search — posts with engagement + media. Flat 2 credits. (2 credits) */
+    /** Threads Post Search — Threads keyword search — posts with engagement + media. orderBy relevant | post_dated | engagement. Flat 2 credits. (2 credits) */
     search(params: ThreadsSearchParams): Promise<ApiEnvelope>;
     /** Threads Search Users — Threads user discovery from keyword search — id, handle, avatar, verified. Flat 1 credit. (1 credit) */
     searchUsers(params: ThreadsSearchUsersParams): Promise<ApiEnvelope>;
@@ -1032,15 +1024,15 @@ export declare class ThreadsApi {
 export interface BlueskyProfileParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. */
     cache?: boolean;
-    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. Envelope: cached + cachedAt. */
+    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. */
     cacheMaxAge?: string;
 }
 export interface BlueskyUserPostsParams {
     /** 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. */
     url: string;
-    /** Max items to return (default 25, max 100). Billed per result. */
+    /** Max items to return (default 10, max 100). Billed per result. */
     limit?: number;
     /** 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). */
     cursor?: string;
@@ -1048,7 +1040,7 @@ export interface BlueskyUserPostsParams {
     filter?: string;
     /** When false, omit repost rows (reasonRepost). Default true — reposts are included and marked with isRepost / repostedBy / repostedAt. */
     includeReposts?: boolean;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface BlueskyPostDetailsParams {
@@ -1056,7 +1048,7 @@ export interface BlueskyPostDetailsParams {
     url: string;
     /** Reply nesting levels under the post (0 = post only with no replies[], default 1, max 6). Maps to Bluesky getPostThread depth. */
     depth?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class BlueskyApi {
@@ -1064,7 +1056,7 @@ export declare class BlueskyApi {
     constructor(core: HttpCore);
     /** Bluesky Profile — Bluesky profile — handle, did, bio, counts, banner, verification{}, labels[], and associated{} (1 credit). (1 credit) */
     profile(params: BlueskyProfileParams): Promise<ApiEnvelope>;
-    /** Bluesky User Posts — Author feed — posts and reposts (isRepost marked), quote/external/images embeds, opaque cursor. (~3 credits (0.1/result)) */
+    /** Bluesky User Posts — Author feed — posts and reposts (isRepost marked), quote/external/images embeds, opaque cursor. (~1 credits (0.1/result)) */
     userPosts(params: BlueskyUserPostsParams): Promise<ApiEnvelope>;
     /** Bluesky Post Details — Post thread via getPostThread — nested replies[], facet links/mentions/hashtags, rich author (1 credit). (1 credit) */
     postDetails(params: BlueskyPostDetailsParams): Promise<ApiEnvelope>;
@@ -1072,47 +1064,47 @@ export declare class BlueskyApi {
 export interface PinterestPinDetailsParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface PinterestUserPinsParams {
     /** 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. */
     url: string;
-    /** Max items to return (default 25, max 200). Billed per result. */
+    /** Max items to return (default 10, max 200). Billed per result. */
     limit?: number;
     /** 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). */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface PinterestSearchParams {
     /** Keywords or search query (min 2 characters). */
     q: string;
-    /** Max items to return (default 25, max 200). Billed per result. */
+    /** Max items to return (default 25, max 200). Flat 2 credits per call. */
     limit?: number;
-    /** 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). */
+    /** 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 search window (max 40). */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface PinterestBoardParams {
     /** 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. */
     url: string;
-    /** Max items to return (default 25, max 200). Billed per result. */
+    /** Max items to return (default 10, max 200). Billed per result. */
     limit?: number;
     /** 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). */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface PinterestUserBoardsParams {
     /** 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. */
     url: string;
-    /** Max items to return (default 25, max 200). Billed per result. */
+    /** Max items to return (default 10, max 200). Billed per result. */
     limit?: number;
     /** 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). */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class PinterestApi {
@@ -1120,81 +1112,81 @@ export declare class PinterestApi {
     constructor(core: HttpCore);
     /** Pinterest Pin Details — Get a Pinterest pin — title, description, link, board, origin creator, and engagement as structured JSON. (1 credit) */
     pinDetails(params: PinterestPinDetailsParams): Promise<ApiEnvelope>;
-    /** Pinterest User Pins — Pins from a Pinterest profile — offset cursor, pidgets window ~100. (~13 credits (0.5/result)) */
+    /** Pinterest User Pins — Pins from a Pinterest profile — offset cursor, pidgets window ~100. (~5 credits (0.5/result)) */
     userPins(params: PinterestUserPinsParams): Promise<ApiEnvelope>;
-    /** Pinterest Search — Keyword pin search — offset cursor, SERP window 40. (~13 credits (0.5/result)) */
+    /** Pinterest Search — Keyword pin search — offset cursor, search window 40, flat 2 credits. (2 credits) */
     search(params: PinterestSearchParams): Promise<ApiEnvelope>;
-    /** Pinterest Board — Pins on a Pinterest board — saves, imageOriginal, destinationUrl, top-level author. ~0.5 credits/pin. (~13 credits (0.5/result)) */
+    /** Pinterest Board — Pins on a Pinterest board — saves, imageOriginal, destinationUrl, top-level author. ~0.5 credits/pin. (~5 credits (0.5/result)) */
     board(params: PinterestBoardParams): Promise<ApiEnvelope>;
-    /** Pinterest User Boards — Boards on a Pinterest profile — pinCount, coverImage (474x), privacy, sections. Board followers when scoped. (~13 credits (0.5/result)) */
+    /** Pinterest User Boards — Boards on a Pinterest profile — pinCount, coverImage (474x), privacy, sections. Board followers when scoped. (~5 credits (0.5/result)) */
     userBoards(params: PinterestUserBoardsParams): Promise<ApiEnvelope>;
 }
 export interface LinkedinProfileParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface LinkedinCompanyParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface LinkedinPostDetailsParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface LinkedinPostTranscriptParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface LinkedinCompanyPostsParams {
     /** 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. */
     url: string;
-    /** Max items to return (default 20, max 100). Flat 1 credit per call. */
+    /** Max items to return (default 20, max 100). Only the ~10 posts the public page shows are available. Flat 1 credit. */
     limit?: number;
-    /** 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). */
+    /** Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 5). A null nextCursor means the end of the list. Only the recent posts LinkedIn shows logged-out visitors (about 10) are available. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface LinkedinSearchPostsParams {
     /** Search query or keywords (min 2 characters). */
     q: string;
-    /** relevance or date. Default relevance. */
+    /** relevance (default, search-engine rank — dates can span years) or date (found posts newest first). */
     sort?: string;
-    /** Max items to return (default 20, max 50). Billed per result. */
+    /** Max items to return (default 10, max 50). Billed per result. */
     limit?: number;
-    /** 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). */
+    /** Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 10). A null nextCursor means the end of the list (max 50 posts). */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class LinkedinApi {
     private readonly core;
     constructor(core: HttpCore);
-    /** LinkedIn Profile — LinkedIn person profile with experience[], education[], similarProfiles[] — masked guest text becomes restricted:true. (2 credits) */
+    /** LinkedIn Profile — Public LinkedIn person profile — what a logged-out visitor sees: name, headline, location, about. Flat 1 credit. (1 credit) */
     profile(params: LinkedinProfileParams): Promise<ApiEnvelope>;
-    /** LinkedIn Company — Company page for B2B intel — specialties, similarPages, employeeCount, founded, slogan, cover. Native 1 / enrich 2. (2 credits) */
+    /** LinkedIn Company — Company page for B2B intel — specialties, similarPages, employeeCount, founded, slogan, cover. Flat 2 credits. (2 credits) */
     company(params: LinkedinCompanyParams): Promise<ApiEnvelope>;
-    /** LinkedIn Post Details — Get a LinkedIn post — text, author, reactions, and comments count as structured JSON. (1 credit) */
+    /** LinkedIn Post Details — Get a LinkedIn post — text, author, reactions, and comments count as structured JSON. When LinkedIn hides the post behind its sign-in prompt the call fails with 502 at 0 credits. (1 credit) */
     postDetails(params: LinkedinPostDetailsParams): Promise<ApiEnvelope>;
     /** LinkedIn Post Transcript — LinkedIn post text as a transcript — paragraph segments, timingSource none. Flat 1 credit. (1 credit) */
     postTranscript(params: LinkedinPostTranscriptParams): Promise<ApiEnvelope>;
-    /** LinkedIn Company Posts — Company posts with engagement{likes,comments} — cursor pages up to 100. Flat 1 credit on the native path. (1 credit) */
+    /** LinkedIn Company Posts — The recent posts a company page shows logged-out visitors (about 10), with engagement{likes,comments}. Flat 1 credit. (1 credit) */
     companyPosts(params: LinkedinCompanyPostsParams): Promise<ApiEnvelope>;
-    /** LinkedIn Search Posts — Keyword search of public LinkedIn posts — offset cursor, ceiling 50. (~16 credits (0.8/result)) */
+    /** LinkedIn Search Posts — Keyword search of public LinkedIn posts — offset cursor, ceiling 50. (~8 credits (0.8/result)) */
     searchPosts(params: LinkedinSearchPostsParams): Promise<ApiEnvelope>;
 }
 export interface RumbleVideoDetailsParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface RumbleVideoTranscriptParams {
@@ -1202,23 +1194,23 @@ export interface RumbleVideoTranscriptParams {
     url: string;
     /** Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect. */
     language?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface RumbleChannelVideosParams {
-    /** 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. */
+    /** Rumble channel or user URL, e.g. https://rumble.com/c/name or https://rumble.com/user/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. */
     url: string;
-    /** Max items to return (default 20, max 200). Billed per result. */
+    /** Max items to return (default 10, max 200). Billed per result. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface RumbleSearchParams {
     /** Keywords or search query (min 2 characters). */
     q: string;
-    /** Max items to return (default 20, max 200). Billed per result. */
+    /** Max items to return (default 10, max 200). Billed per result. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface RumbleCommentsParams {
@@ -1226,7 +1218,7 @@ export interface RumbleCommentsParams {
     url: string;
     /** Max items to return (default 50, max 500). Flat 2 credits per call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class RumbleApi {
@@ -1236,9 +1228,9 @@ export declare class RumbleApi {
     videoDetails(params: RumbleVideoDetailsParams): Promise<ApiEnvelope>;
     /** Rumble Video Transcript — Rumble published captions as timed segments — parses the .vtt from video-details (not speech-to-text). (1 credit) */
     videoTranscript(params: RumbleVideoTranscriptParams): Promise<ApiEnvelope>;
-    /** Rumble Channel Videos — Rumble channel uploads — lean streams[{url,type}]; call video-details for rendition meta. (~12 credits (0.6/result)) */
+    /** Rumble Channel Videos — Rumble channel uploads — lean streams[{url,type}]; call video-details for rendition meta. (~6 credits (0.6/result)) */
     channelVideos(params: RumbleChannelVideosParams): Promise<ApiEnvelope>;
-    /** Rumble Search — Rumble keyword search — same video card shape as channel-videos (type, durationSeconds + durationText, UTC publishedAt). (~12 credits (0.6/result)) */
+    /** Rumble Search — Rumble keyword search — same video card shape as channel-videos (type, durationSeconds + durationText, UTC publishedAt). (~6 credits (0.6/result)) */
     search(params: RumbleSearchParams): Promise<ApiEnvelope>;
     /** Rumble Comments — Rumble top-level comments — publishedAt ISO-8601 UTC from title= on the comment time link. (2 credits) */
     comments(params: RumbleCommentsParams): Promise<ApiEnvelope>;
@@ -1250,25 +1242,25 @@ export interface TiktokShopSearchParams {
     region?: string;
     /** Max items to return (default 10, max 10). Flat 2 credits per call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokShopProductsParams {
-    /** TikTok Shop store URL, e.g. https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079. 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. */
+    /** 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. */
     url: string;
     /** 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. */
     region?: string;
-    /** Max items to return (default 20, max 200). Flat 2 credits per call. */
+    /** Max items to return (default 20, max 200). 2 credits when served natively (limit ≤ 30); above 30, or when the native page misses, the fallback path bills 2.8 credits per product returned, rounded up, minimum 2. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokShopProductDetailsParams {
-    /** TikTok Shop product URL, e.g. 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. */
+    /** 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. */
     url: string;
-    /** Two-letter market region for the secondary fetch path (default US). Primary SSR uses the product URL's market; empty/partial non-US results are often a TikTok exposure limit. */
+    /** 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. */
     region?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokShopProductReviewsParams {
@@ -1276,36 +1268,38 @@ export interface TiktokShopProductReviewsParams {
     url: string;
     /** Max items to return (default 20, max 200). Billed per result. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokShopUserShowcaseParams {
     /** TikTok username, @handle, or profile URL, e.g. jeffreestar or https://www.tiktok.com/@jeffreestar. */
     username: string;
-    /** Max items to return (default 20, max 200). Billed per result. */
+    /** Max items to return (default 10, max 200). Billed per result. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class TiktokShopApi {
     private readonly core;
     constructor(core: HttpCore);
-    /** TikTok Shop Search — TikTok Shop keyword search — priced products with sold, rating/reviews, typed discount, seller id. (2 credits) */
+    /** TikTok Shop Search — TikTok Shop keyword search — priced products with rating/reviews, typed discount, seller id. (2 credits) */
     search(params: TiktokShopSearchParams): Promise<ApiEnvelope>;
-    /** TikTok Shop Products — Store catalog with shopInfo (sold/followers/rating) + products priced with sold, rating, typed discount. (2 credits) */
+    /** TikTok Shop Products — Store catalog with shopInfo (sold/followers/rating) + products priced with sold, rating, typed discount. (2 credits (fallback: 2.8/product, min 2)) */
     products(params: TiktokShopProductsParams): Promise<ApiEnvelope>;
-    /** TikTok Shop Product Details — PDP — price/originalPrice/typed discount, images[], skus[] with per-variant stock + saleProps, seller id/url, categories (2 credits). (2 credits) */
+    /** TikTok Shop Product Details — PDP — price (sku_min when guest min is *), sold vs stock, seller id/url, images[]. Unresolved URL is 404 at 0 credits. (2 credits) */
     productDetails(params: TiktokShopProductDetailsParams): Promise<ApiEnvelope>;
     /** TikTok Shop Product Reviews — TikTok Shop product reviews — star rating, text, SKU variant, verified purchase, country, and review photos. (~45 credits (2.25/result)) */
     productReviews(params: TiktokShopProductReviewsParams): Promise<ApiEnvelope>;
-    /** TikTok Shop User Showcase — Creator Shop showcase — affiliate shelf products with per-product sold, rating, typed discount, and seller name/url. (~45 credits (2.25/result)) */
+    /** TikTok Shop User Showcase — Creator Shop showcase — affiliate shelf products with per-product sold, rating, typed discount, and seller name/url. (~23 credits (2.25/result)) */
     userShowcase(params: TiktokShopUserShowcaseParams): Promise<ApiEnvelope>;
 }
 export interface FacebookMarketplaceSearchParams {
     /** Product or keyword to search Facebook Marketplace for. */
     q: string;
-    /** Search-origin city or place name, e.g. 'Austin, TX' (query echo — not each listing's city). */
-    location: string;
+    /** 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. */
+    searchLocation: string;
+    /** Alias of searchLocation. Prefer searchLocation. Either one is required. */
+    location?: string;
     /** How many listings to return (1–200). Flat 2 credits when details=false; details=true billed as 2 + 2 per listing. */
     limit?: number;
     /** Minimum price in local currency units. */
@@ -1314,7 +1308,7 @@ export interface FacebookMarketplaceSearchParams {
     maxPrice?: number;
     /** suggested | distance | creation_time | price_ascend | price_descend. */
     sortBy?: string;
-    /** 1 (24h), 7, or 30. */
+    /** Facebook calendar-day recency: 1 = since the start of yesterday (not a rolling 24 hours), 7, or 30. */
     daysSinceListed?: string;
     /** new, like_new, good, fair (comma-separated ok). */
     condition?: string;
@@ -1326,11 +1320,11 @@ export interface FacebookMarketplaceSearchParams {
     radiusMiles?: number;
     /** Top-level category slug, e.g. electronics. */
     category?: string;
-    /** Opaque pagination cursor from a previous nextCursor. */
+    /** Opaque pagination cursor from a previous nextCursor. A cursor this endpoint did not issue is 400 INVALID_CURSOR. */
     cursor?: string;
-    /** 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. */
+    /** When true, adds description/condition/coordinates/full photo gallery/seller/distanceMiles — billed as 2 + 2 credits per enriched listing (listings the 90s deadline did not reach ship as search cards with truncatedReason=enrich_deadline and are not billed the extra 2). Default false → flat 2 credits; cover photo is still in image. */
     details?: boolean;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface FacebookMarketplaceLocationSearchParams {
@@ -1338,13 +1332,13 @@ export interface FacebookMarketplaceLocationSearchParams {
     q: string;
     /** Max items to return (default 10, max 50). Flat 2 credits per call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface FacebookMarketplaceItemParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class FacebookMarketplaceApi {
@@ -1370,13 +1364,13 @@ export interface FacebookEventSearchParams {
     upcoming?: boolean;
     /** 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). */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface FacebookEventDetailsParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface FacebookProfileEventsParams {
@@ -1384,7 +1378,7 @@ export interface FacebookProfileEventsParams {
     url: string;
     /** 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). */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class FacebookEventsApi {
@@ -1400,7 +1394,7 @@ export declare class FacebookEventsApi {
 export interface FacebookAdLibrarySearchParams {
     /** Keyword, brand, or advertiser to search Meta Ad Library (min 2 characters). */
     q: string;
-    /** Two-letter ISO country code (e.g. US, GB, DE). Default US. */
+    /** Two-letter ISO country code (e.g. US, GB, DE), or ALL for every country (Meta's own value). Default US. For inactive ads prefer ALL: a single-country search can list far fewer inactive ads than ALL. Other 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. */
     country?: string;
     /** Max items to return (default 20, max 200). Flat 2 credits per call. */
     limit?: number;
@@ -1416,47 +1410,57 @@ export interface FacebookAdLibrarySearchParams {
     search_type?: string;
     /** Meta sort mode: total_impressions or relevancy_monthly_grouped. */
     sort_by?: string;
-    /** Only ads with delivery start on/after this date (YYYY-MM-DD). */
+    /** Only ads shown (delivered) on or after this date (YYYY-MM-DD). Delivery-date window, not a start-date filter: an ad that started earlier but was still running in the range is included. */
     start_date?: string;
-    /** Only ads with delivery start on/before this date (YYYY-MM-DD). */
+    /** Only ads shown (delivered) on or before this date (YYYY-MM-DD). */
     end_date?: string;
     /** Pagination cursor from a previous nextCursor. Pages through the current Meta HTML result batch. */
     cursor?: string;
     /** When true, omit cards/images/videos typed arrays (media[] stays). Captapi payloads are already lean vs Meta nested snapshots. */
     trim?: boolean;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface FacebookAdLibraryCompanyAdsParams {
     /** 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. */
     url: string;
-    /** Two-letter ISO country code. Default US. */
+    /** Two-letter ISO country code, or ALL for every country (Meta's own value). Default US. For inactive ads prefer ALL: a single-country search can list far fewer inactive ads than ALL. Other non-ISO codes are a definitive 400 INVALID_COUNTRY. */
     country?: string;
     /** Max items to return (default 20, max 200). Flat 2 credits per call on the native path; the extended fallback bills per returned ad. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Ad delivery status: ACTIVE (default), INACTIVE, or ALL. Use ACTIVE for "what are they running now?". */
+    status?: string;
+    /** Meta sort mode: total_impressions or relevancy_monthly_grouped. Omit for Meta's default ranking (top ads by impressions first). */
+    sort_by?: string;
+    /** Only ads shown (delivered) on or after this date (YYYY-MM-DD). Delivery-date window, not a start-date filter: an ad that started earlier but was still running in the range is included. */
+    start_date?: string;
+    /** Only ads shown (delivered) on or before this date (YYYY-MM-DD). */
+    end_date?: string;
+    /** Pagination cursor from a previous nextCursor. Pages through the current Meta HTML result batch. */
+    cursor?: string;
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface FacebookAdLibrarySearchCompaniesParams {
     /** Company or brand name to search for (min 2 characters). Name-matched — off-brand pages are dropped. */
     q: string;
-    /** Two-letter ISO country code. Default US. */
+    /** Two-letter ISO country code. Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY. */
     country?: string;
     /** Max items to return (default 20, max 200). Flat 2 credits per call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface FacebookAdLibraryAdDetailsParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface FacebookAdLibraryAdTranscriptParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class FacebookAdLibraryApi {
@@ -1464,33 +1468,33 @@ export declare class FacebookAdLibraryApi {
     constructor(core: HttpCore);
     /** Facebook Ad Library Search — Search Meta Ad Library by keyword — active/inactive, media type, date range, platforms, cursor, and spend/impressions when Meta publishes them. (2 credits) */
     search(params: FacebookAdLibrarySearchParams): Promise<ApiEnvelope>;
-    /** Facebook Company Ads — Company Ads (2 credits) */
+    /** Facebook Company Ads — Ads for one Meta page — active by default, Meta's top-by-impressions order, sort_by and date window, same envelope as /facebook/search. (2 credits) */
     companyAds(params: FacebookAdLibraryCompanyAdsParams): Promise<ApiEnvelope>;
     /** Facebook Ad Library Search Companies — Find Meta Ad Library pages by brand — name-matched, pageId for company-ads (not profileId). (2 credits) */
     searchCompanies(params: FacebookAdLibrarySearchCompaniesParams): Promise<ApiEnvelope>;
-    /** Facebook Ad Details — One Meta ad by ID — same creative as search, plus delivery breakdowns when Meta publishes them. Flat 2 credits. (2 credits) */
+    /** Facebook Ad Details — One Meta ad by ID — same creative as search, plus EU transparency data for EU-delivered ads. Flat 2 credits. (2 credits) */
     adDetails(params: FacebookAdLibraryAdDetailsParams): Promise<ApiEnvelope>;
-    /** Facebook Ad Copy — Written creative copy from a Meta ad — headline, body, CTA, landing URL. Not a speech transcript. (2 credits) */
+    /** Facebook Ad Transcript — Spoken transcript of a Meta video ad with timed segments — written copy as fallback. (2 credits) */
     adTranscript(params: FacebookAdLibraryAdTranscriptParams): Promise<ApiEnvelope>;
 }
 export interface TiktokAdLibrarySearchParams {
     /** Keyword or advertiser to search TikTok Commercial Content Library (min 2 characters). */
     q: string;
-    /** Two-letter ISO country code (e.g. GB, DE, FR). Default GB (EU DSA library; US often empty). */
+    /** 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. */
     country?: string;
-    /** Keyword token mode: "any" (default, OR whole-word) or "all" (AND). hair ≠ wheelchair. Empty results are free. */
+    /** 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. */
     match?: string;
-    /** Max items to return (default 20, max 200). Flat 2 credits per call. */
+    /** Max items to return (default 20, max 200). Does not change the price: 2 credits native, 5 via the fallback path, 0 when empty. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokAdLibraryTopAdsParams {
-    /** Optional keyword that filters the one ~20-row leaderboard page — not a library search. Case-insensitive whole-word match on title/brandName/industry/objective (hair ≠ wheelchair). 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. */
+    /** 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. */
     q?: string;
-    /** Keyword token mode: "any" (default, OR) or "all" (AND). Zero literal hits → empty ads[] (never an unfiltered soft list). */
+    /** 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). */
     match?: string;
-    /** Two-letter ISO country code. Default US. */
+    /** 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). */
     country?: string;
     /** Lookback window in days: 7, 30, or 180. Default 30. */
     period?: number;
@@ -1500,27 +1504,27 @@ export interface TiktokAdLibraryTopAdsParams {
     industry?: string;
     /** Optional campaign objective (e.g. Traffic, Conversion, Reach). */
     objective?: string;
-    /** Optional format filter: spark or non_spark. */
+    /** 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. */
     adFormat?: string;
-    /** 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). */
+    /** 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 the native path; the fallback path ~1 credit per returned ad (min 2). */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TiktokAdLibraryAdDetailsParams {
-    /** TikTok Ad Library 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. */
+    /** 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. */
     url: string;
-    /** Two-letter ISO country code. Default GB. */
+    /** Two-letter ISO country code. Default GB. Only EU/EEA + UK + CH are covered by TikTok's library; other codes return 400 UNSUPPORTED_REGION. */
     country?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class TiktokAdLibraryApi {
     private readonly core;
     constructor(core: HttpCore);
-    /** TikTok Ad Library Search — Search TikTok Commercial Content Library — relevance-filtered, uniform null schema (2 credits). (2 credits) */
+    /** TikTok Ad Library Search — Search TikTok Commercial Content Library — relevance-filtered, uniform null schema (2 credits native, 5 via fallback). (2 credits (5 via fallback path)) */
     search(params: TiktokAdLibrarySearchParams): Promise<ApiEnvelope>;
-    /** TikTok Creative Center Top Ads — TikTok Creative Center Top Ads — one ~20-row leaderboard page, not a library search (flat 2 / ~1 Apify). (2 credits) */
+    /** TikTok Creative Center Top Ads — TikTok Creative Center Top Ads — one ~20-row leaderboard page, not a library search (flat 2; ~1/ad on the fallback path). (2 credits) */
     topAds(params?: TiktokAdLibraryTopAdsParams): Promise<ApiEnvelope>;
     /** TikTok Ad Details — One TikTok Commercial Content Library ad by ID — calendar-day dates, always 2 credits. (2 credits) */
     adDetails(params: TiktokAdLibraryAdDetailsParams): Promise<ApiEnvelope>;
@@ -1528,7 +1532,7 @@ export declare class TiktokAdLibraryApi {
 export interface GoogleAdLibraryCompanyAdsParams {
     /** Advertiser name, domain (e.g. nike.com), or Google advertiser ID (AR…). Prefer AR… from advertiser-search. */
     advertiser: string;
-    /** Two-letter ISO country / region code (soft filter). Default US. Alias: region. */
+    /** Two-letter ISO country / region code (soft filter). Default US. Alias: region. Non-ISO codes are a definitive 400 INVALID_COUNTRY. */
     country?: string;
     /** Alias for country. */
     region?: string;
@@ -1544,25 +1548,25 @@ export interface GoogleAdLibraryCompanyAdsParams {
     topic?: string;
     /** Max items to return (default 20, max 200). Flat 2 credits when results are returned; 0 credits when totalReturned is 0. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface GoogleAdLibraryAdDetailsParams {
-    /** Google Ads Transparency URL containing AR... advertiser and CR... creative IDs. */
+    /** 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. */
     creative_id: string;
-    /** Two-letter ISO country code. Default US. */
+    /** Two-letter ISO country code. Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY. */
     country?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface GoogleAdLibraryAdvertiserSearchParams {
     /** Brand, domain, or advertiser name (min 2 characters). Expanded + ranked so US prefers Inc. over SRL. */
     q: string;
-    /** Two-letter ISO country code used for ranking (e.g. US). Default US. */
+    /** Two-letter ISO country code used for ranking (e.g. US). Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY. */
     country?: string;
     /** Max items to return (default 10, max 50). Flat 1 credit when results are returned; 0 credits when totalReturned is 0. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class GoogleAdLibraryApi {
@@ -1580,13 +1584,13 @@ export interface LinkedinAdLibrarySearchAdsParams {
     q?: string;
     /** Alias of q — advertiser / account owner name. */
     company?: string;
-    /** Optional keyword filter on ad creative copy. */
+    /** 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). */
     keyword?: string;
     /** LinkedIn numeric company id for exact advertiser match. */
     companyId?: string;
-    /** Single ISO country code. Default US. Ignored when countries is set. */
+    /** 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. */
     country?: string;
-    /** Comma-separated ISO country codes (e.g. US,CA,MX). */
+    /** Comma-separated ISO country codes (e.g. US,CA,MX). Each code is validated — non-ISO codes are a 400 INVALID_COUNTRY. */
     countries?: string;
     /** Custom range start YYYY-MM-DD (use with endDate). */
     startDate?: string;
@@ -1596,21 +1600,21 @@ export interface LinkedinAdLibrarySearchAdsParams {
     cursor?: string;
     /** Alias of cursor. */
     paginationToken?: string;
-    /** Max items to return (default 20, max 200). 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. */
+    /** 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. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface LinkedinAdLibraryAdDetailsParams {
-    /** LinkedIn Ad Library 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. */
+    /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class LinkedinAdLibraryApi {
     private readonly core;
     constructor(core: HttpCore);
-    /** LinkedIn Ad Library Search — LinkedIn publishes run dates, impressions and targeting only on a subset of creatives. Search is the SERP card; source is native|extended. (2 credits) */
+    /** LinkedIn Ad Library Search — LinkedIn publishes run dates, impressions and targeting only on a subset of creatives. Search is the SERP card; source is native. (2 credits) */
     searchAds(params?: LinkedinAdLibrarySearchAdsParams): Promise<ApiEnvelope>;
     /** LinkedIn Ad Details — One LinkedIn Ad Library ad by ID. LinkedIn withholds Ran-from / impressions / targeting on most creatives — those keys are omitted, not 404. (2 credits) */
     adDetails(params: LinkedinAdLibraryAdDetailsParams): Promise<ApiEnvelope>;
@@ -1620,23 +1624,23 @@ export interface AmazonShopPageParams {
     url: string;
     /** Amazon marketplace code. Default US. */
     marketplace?: string;
-    /** Max products to include (default 20, max 200; 0 = seller metadata only). Billed per storefront page — 1 credit per ~16 products. */
+    /** Max products to include (default 20, max 200; 0 = seller metadata only). Billed per 16-product storefront page: ceil(limit / 16) credits, minimum 1 — the default 20 costs 2. */
     limit?: number;
     /** Pagination cursor from nextCursor (page or page:offset). Leave empty for the first page. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class AmazonShopApi {
     private readonly core;
     constructor(core: HttpCore);
-    /** Amazon Seller Storefront — Third-party seller storefronts (/sp?seller= / /s?me=) — ASIN + canonical /dp URLs, price, badges. Not influencer /shop/{handle}. (1 credit) */
+    /** Amazon Seller Storefront — Third-party seller storefronts (/sp?seller= / /s?me=) — ASIN + canonical /dp URLs, price, badges. Not influencer /shop/{handle}. (1 credit per 16 products (default limit 20 = 2)) */
     page(params: AmazonShopPageParams): Promise<ApiEnvelope>;
 }
 export interface GithubUserParams {
     /** GitHub username or profile URL, e.g. getify or https://github.com/getify. */
     username: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface GithubRepositoriesParams {
@@ -1648,11 +1652,11 @@ export interface GithubRepositoriesParams {
     direction?: string;
     /** owner (default) | member | all — affiliation filter. Echoed as data.type. */
     type?: string;
-    /** Max items to return (default 30, max 100). Billed per result. */
+    /** Max items to return (default 10, max 100). Billed per result. */
     limit?: number;
     /** Opaque cursor from a previous nextCursor (GitHub Link page=). Not a bare page number. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface GithubPullRequestsParams {
@@ -1660,21 +1664,21 @@ export interface GithubPullRequestsParams {
     repo: string;
     /** open (API default), closed, or all. Echoed as data.state. Docs example uses closed so mergedAt is visible. */
     state?: string;
-    /** Max items to return (default 30, max 100). Billed per result. */
+    /** Max items to return (default 10, max 100). Billed per result. */
     limit?: number;
     /** Opaque cursor from a previous nextCursor (GitHub Link page=). Not a bare page number. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface GithubActivityParams {
     /** GitHub username or profile URL, e.g. getify. */
     username: string;
-    /** Max items to return (default 30, max 90). Billed per result. */
+    /** Max items to return (default 10, max 90). Billed per result. */
     limit?: number;
     /** Opaque cursor from a previous nextCursor. Pagination stops after GitHub's 90-event public activity ceiling. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface GithubFollowersParams {
@@ -1684,7 +1688,7 @@ export interface GithubFollowersParams {
     limit?: number;
     /** Opaque cursor from a previous nextCursor (GitHub Link page=). Not a bare page number. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface GithubFollowingParams {
@@ -1694,19 +1698,19 @@ export interface GithubFollowingParams {
     limit?: number;
     /** Opaque cursor from a previous nextCursor (GitHub Link page=). Not a bare page number. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface GithubContributionsParams {
     /** GitHub username or profile URL, e.g. getify or https://github.com/getify. */
     username: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface GithubRepositoryParams {
     /** Repository URL or owner/name, e.g. torvalds/linux or https://github.com/torvalds/linux. */
     repo: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface GithubTrendingRepositoriesParams {
@@ -1716,7 +1720,7 @@ export interface GithubTrendingRepositoriesParams {
     language?: string;
     /** Max items to return (default 25, max 100). Flat 2 credits per call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface GithubTrendingDevelopersParams {
@@ -1726,7 +1730,7 @@ export interface GithubTrendingDevelopersParams {
     language?: string;
     /** Max items to return (default 25, max 100). Flat 2 credits per call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class GithubApi {
@@ -1734,11 +1738,11 @@ export declare class GithubApi {
     constructor(core: HttpCore);
     /** GitHub User — GitHub public profile — login, type User|Organization, email when public, followers (1 credit). (1 credit) */
     user(params: GithubUserParams): Promise<ApiEnvelope>;
-    /** GitHub Repositories — List a user's repos with sort/direction/type — opaque Link cursor (~0.4/repo). (~12 credits (0.4/result)) */
+    /** GitHub Repositories — List a user's repos with sort/direction/type — opaque Link cursor (~0.4/repo). (~4 credits (0.4/result)) */
     repositories(params: GithubRepositoriesParams): Promise<ApiEnvelope>;
-    /** GitHub Pull Requests — List repo PRs — draft, labels, author{}, head/base, opaque Link cursor (state echoed). (~12 credits (0.4/result)) */
+    /** GitHub Pull Requests — List repo PRs — draft, labels, author{}, head/base, opaque Link cursor (state echoed). (~4 credits (0.4/result)) */
     pullRequests(params: GithubPullRequestsParams): Promise<ApiEnvelope>;
-    /** GitHub Activity — Public events with typed payload (Push commits/ref, PR/issue action) — 90-event ceiling. (~12 credits (0.4/result)) */
+    /** GitHub Activity — Public events with typed payload (Push commits/ref, PR/issue action) — 90-event ceiling. (~4 credits (0.4/result)) */
     activity(params: GithubActivityParams): Promise<ApiEnvelope>;
     /** GitHub Followers — Follower cards {id, login, type, url, avatar} — ~0.1/row; large accounts are expensive to page fully. (~3 credits (0.1/result)) */
     followers(params: GithubFollowersParams): Promise<ApiEnvelope>;
@@ -1756,9 +1760,9 @@ export declare class GithubApi {
 export interface TwitchProfileParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. */
     cache?: boolean;
-    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. Envelope: cached + cachedAt. */
+    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. */
     cacheMaxAge?: string;
 }
 export interface TwitchUserVideosParams {
@@ -1772,7 +1776,7 @@ export interface TwitchUserVideosParams {
     sortBy?: string;
     /** 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). */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TwitchUserScheduleParams {
@@ -1780,15 +1784,15 @@ export interface TwitchUserScheduleParams {
     url: string;
     /** Max schedule segments to return (default 50, max 100). Flat 1 credit per call. */
     limit?: number;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TwitchClipParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. */
     cache?: boolean;
-    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. Envelope: cached + cachedAt. */
+    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. */
     cacheMaxAge?: string;
 }
 export declare class TwitchApi {
@@ -1808,7 +1812,7 @@ export interface SpotifyArtistParams {
     url: string;
     /** 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). */
     raw?: boolean;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface SpotifyTrackParams {
@@ -1816,7 +1820,7 @@ export interface SpotifyTrackParams {
     url: string;
     /** Include the upstream GraphQL payload as data.raw. Default false — getTrack embeds bulky artist discography. */
     raw?: boolean;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface SpotifyAlbumParams {
@@ -1824,7 +1828,7 @@ export interface SpotifyAlbumParams {
     url: string;
     /** Include the upstream GraphQL payload as data.raw. Default false — omit unless you need fields not in the normalized shape. */
     raw?: boolean;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface SpotifySearchParams {
@@ -1834,15 +1838,15 @@ export interface SpotifySearchParams {
     type?: string;
     /** Max items to return (default 20, max 50). Flat 2 credits per call. */
     limit?: number;
-    /** Include per-result upstream payload as results[].raw. Default false. Pathfinder GraphQL vs Apify scraper shapes differ — see FAQ. */
+    /** Include per-result upstream payload as results[].raw. Default false. Pathfinder GraphQL vs fallback-path shapes differ — see FAQ. */
     raw?: boolean;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface SpotifyPodcastParams {
     /** Spotify show/podcast URL, URI, or ID (e.g. https://open.spotify.com/show/…). Not an artist URL. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface SpotifyPodcastEpisodesParams {
@@ -1854,7 +1858,7 @@ export interface SpotifyPodcastEpisodesParams {
     cursor?: string;
     /** Include slimmed per-episode upstream payload as episodes[].raw. Default false. visualIdentity / playedState / podcastV2 are never included. */
     raw?: boolean;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class SpotifyApi {
@@ -1876,9 +1880,9 @@ export declare class SpotifyApi {
 export interface SoundcloudArtistParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. */
     cache?: boolean;
-    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. Envelope: cached + cachedAt. */
+    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. */
     cacheMaxAge?: string;
 }
 export interface SoundcloudArtistTracksParams {
@@ -1888,15 +1892,15 @@ export interface SoundcloudArtistTracksParams {
     limit?: number;
     /** Opaque pagination cursor from the previous nextCursor. Leave empty for the first page. Do not edit or invent values. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface SoundcloudTrackParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. */
     cache?: boolean;
-    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. Envelope: cached + cachedAt. */
+    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. */
     cacheMaxAge?: string;
 }
 export declare class SoundcloudApi {
@@ -1912,9 +1916,9 @@ export declare class SoundcloudApi {
 export interface LinktreePageParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. */
     cache?: boolean;
-    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. Envelope: cached + cachedAt. */
+    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. */
     cacheMaxAge?: string;
 }
 export declare class LinktreeApi {
@@ -1926,41 +1930,41 @@ export declare class LinktreeApi {
 export interface SnapchatUserProfileParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class SnapchatApi {
     private readonly core;
     constructor(core: HttpCore);
-    /** Snapchat User Profile — Snapchat profile — unwrapped highlight ids, mediaType image/video, category labels, Spotlight boosts (1 credit). (1 credit) */
+    /** Snapchat User Profile — Snapchat profile — stable identity card, millisecond timestamps, mediaType image/video (1 credit). (1 credit) */
     userProfile(params: SnapchatUserProfileParams): Promise<ApiEnvelope>;
 }
 export interface TruthSocialProfileParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TruthSocialUserPostsParams {
     /** 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. */
     url: string;
-    /** Max posts to return (default 20, max 80). Capped at 80 because Truth Social's statuses page is ~40 items — use nextCursor for more pages. Flat 2 credits per call. Response `source` is native or extended. */
+    /** 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. */
     limit?: number;
     /** Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface TruthSocialPostParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class TruthSocialApi {
     private readonly core;
     constructor(core: HttpCore);
-    /** Truth Social Profile — Prominent public Truth Social profiles — isPrivate/bot/group, fields[], avatar/banner. Flat 1 credit. (1 credit) */
+    /** Truth Social Profile — Prominent public Truth Social profiles — isPrivate/bot/group, CP-F counts, avatar/banner. Flat 1 credit. (1 credit) */
     profile(params: TruthSocialProfileParams): Promise<ApiEnvelope>;
     /** Truth Social User Posts — Recent Truths — same post mapper as /post (links, card, reblog/quote, mentions). 2 credits. (2 credits) */
     userPosts(params: TruthSocialUserPostsParams): Promise<ApiEnvelope>;
@@ -1968,19 +1972,19 @@ export declare class TruthSocialApi {
     post(params: TruthSocialPostParams): Promise<ApiEnvelope>;
 }
 export interface KickClipParams {
-    /** Kick clip URL for one enriched clip (e.g. https://kick.com/{channel}/clips/clip_…), or channel URL/@username for recent clips[]. 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. */
+    /** 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. */
     url: string;
-    /** 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. */
+    /** Channel mode only — max recent clips to return (default 20, max 100). Ignored when url is a clip. Flat 1 credit. No cursor — one response holds up to limit clips. */
     limit?: number;
-    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. */
     cache?: boolean;
-    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. Envelope: cached + cachedAt. */
+    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. */
     cacheMaxAge?: string;
 }
 export declare class KickApi {
     private readonly core;
     constructor(core: HttpCore);
-    /** Kick Clip — Get a Kick clip — creator vs channel, HLS playback, VOD deep-link, views, and duration as structured JSON. (1 credit) */
+    /** Kick Clip — Get a Kick clip, or a channel's recent clips — 7d clip cache. Flat 1 credit. (1 credit) */
     clip(params: KickClipParams): Promise<ApiEnvelope>;
 }
 export interface AccountBalanceParams {
@@ -2024,29 +2028,29 @@ export declare class AccountApi {
 export interface AnalyticsPostParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface AnalyticsCompareParams {
     /** 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. */
     urls: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface VideoTranscriptParams {
     /** Video or audio file (multipart form field — use -F file=@path, not a query string). Max 200MB / 60 minutes. */
     file: string;
-    /** ISO-639-1 Whisper language hint, e.g. "en" or "tr". Omit to auto-detect. */
+    /** ISO-639-1 language hint, e.g. "en" or "tr". Omit to auto-detect. */
     language?: string;
-    /** When true, translate speech to English (Whisper translations API). Default false. */
+    /** When true, translate speech to English. Default false. */
     translate?: boolean;
-    /** segment (default) or word — word-level timings when Whisper exposes them. */
+    /** segment (default) or word — word-level timings when the transcription model exposes them. */
     timestampGranularity?: string;
 }
 export interface VideoSummarizeParams {
     /** Video or audio file (multipart form field — use -F file=@path, not a query string). Max 200MB / 60 minutes. */
     file: string;
-    /** ISO-639-1 Whisper language hint, e.g. "en" or "tr". Omit to auto-detect. */
+    /** ISO-639-1 language hint, e.g. "en" or "tr". Omit to auto-detect. */
     language?: string;
     /** When true, translate speech to English before summarizing. Default false. */
     translate?: boolean;
@@ -2060,31 +2064,31 @@ export declare class UtilitiesApi {
     analyticsPost(params: AnalyticsPostParams): Promise<ApiEnvelope>;
     /** Compare Analytics — Compare unified metrics across up to 10 URLs — each row is the analytics/post object (1 credit/resolved URL). (1 credit/url) */
     analyticsCompare(params: AnalyticsCompareParams): Promise<ApiEnvelope>;
-    /** Video File Transcript — Whisper transcription of an uploaded file — 1 credit/min; noSpeech=true and 0 credits when there is no speech. (1 credit/min) */
+    /** Video File Transcript — AI transcription of an uploaded file — 1 credit/min; noSpeech=true and 0 credits when there is no speech. (1 credit/min) */
     videoTranscript(params: VideoTranscriptParams): Promise<ApiEnvelope>;
-    /** Video File Summarizer — Whisper + AI summary of an uploaded file — transcript included; 1 credit/min + 1. (1 credit/min +1) */
+    /** Video File Summarizer — AI transcription + summary of an uploaded file — transcript included; 1 credit/min + 1. (1 credit/min +1) */
     videoSummarize(params: VideoSummarizeParams): Promise<ApiEnvelope>;
 }
 export interface KwaiProfileParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface KwaiUserPostsParams {
     /** 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. */
     url: string;
-    /** Max posts to return (1–200). Default 20. ~1 credit per post returned (min 2). */
+    /** Max posts to return (1–200). Default 10. ~1 credit per post returned (min 2). */
     limit?: number;
     /** Opaque pagination cursor from the previous nextCursor. Pages within posts from one profile fetch. */
     cursor?: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export interface KwaiPostParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
     cache?: boolean;
 }
 export declare class KwaiApi {
@@ -2092,7 +2096,7 @@ export declare class KwaiApi {
     constructor(core: HttpCore);
     /** Kwai Profile — Fetch Kwai profile — display name, bio, counts, and verification as structured JSON. (1 credit) */
     profile(params: KwaiProfileParams): Promise<ApiEnvelope>;
-    /** Kwai User Posts — Kwai profile posts — caption ("" when none), engagement, mp4 + transcript (~1 credit/post). (~20 credits (1/result)) */
+    /** Kwai User Posts — Kwai profile posts — caption ("" when none), engagement, mp4 + transcript (~1 credit/post). (~10 credits (1/result)) */
     userPosts(params: KwaiUserPostsParams): Promise<ApiEnvelope>;
     /** Kwai Post — Single Kwai video — caption ("" when none), hashtags[], author, mp4 (2 credits). (2 credits) */
     post(params: KwaiPostParams): Promise<ApiEnvelope>;
@@ -2100,9 +2104,9 @@ export declare class KwaiApi {
 export interface KomiPageParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. */
     cache?: boolean;
-    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. Envelope: cached + cachedAt. */
+    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. */
     cacheMaxAge?: string;
 }
 export declare class KomiApi {
@@ -2114,9 +2118,9 @@ export declare class KomiApi {
 export interface PillarPageParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. */
     cache?: boolean;
-    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. Envelope: cached + cachedAt. */
+    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. */
     cacheMaxAge?: string;
 }
 export declare class PillarApi {
@@ -2128,9 +2132,9 @@ export declare class PillarApi {
 export interface LinkbioPageParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. */
     cache?: boolean;
-    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. Envelope: cached + cachedAt. */
+    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. */
     cacheMaxAge?: string;
 }
 export declare class LinkbioApi {
@@ -2142,9 +2146,9 @@ export declare class LinkbioApi {
 export interface LinkmeProfileParams {
     /** 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. */
     url: string;
-    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. Envelope includes cached + cachedAt on hits. */
+    /** Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. */
     cache?: boolean;
-    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. Envelope: cached + cachedAt. */
+    /** Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. */
     cacheMaxAge?: string;
 }
 export declare class LinkmeApi {
@@ -2153,6 +2157,38 @@ export declare class LinkmeApi {
     /** Linkme Profile — Linkme profile → bio, profileVisitCount, featured links, webLinks, email/infoLinks, stripeStatus. Flat 1 credit. (1 credit) */
     profile(params: LinkmeProfileParams): Promise<ApiEnvelope>;
 }
+export interface GoogleMapsBusinessSearchParams {
+    /** Keyword, for example plumber or coffee. Min 2 characters. */
+    q: string;
+    /** Place name: City, Country or City, Region, Country — for example Austin, TX, Istanbul, Turkey, Paris, France, or a country such as Germany. Case, accents, US state codes, and country aliases (USA, UK, Turkey) are handled. A city name shared by several places (Paris) returns 400 with suggestions. When set, the locationCode parameter is ignored. */
+    location?: string;
+    /** Numeric place code, used only when location is omitted. Default 2840 (United States). */
+    locationCode?: number;
+    /** Language code, for example en. Default en. */
+    language?: string;
+    /** Max businesses to return (default 20, max 100). Not a page cursor — there is no next page. Flat 2 credits per call; zero businesses is 0 credits. */
+    limit?: number;
+    /** Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. */
+    cache?: boolean;
+}
+export declare class GoogleMapsApi {
+    private readonly core;
+    constructor(core: HttpCore);
+    /** Google Maps Business Search — Local businesses from a Maps search — name, address, phone, website, rating, hours, place id. Flat 2 credits. No emails. (2 credits) */
+    businessSearch(params: GoogleMapsBusinessSearchParams): Promise<ApiEnvelope>;
+}
+export interface WebsiteContactsParams {
+    /** Business website or bare domain, for example https://atxfamilydental.com or atxfamilydental.com (https:// is added). Social profile URLs are not accepted here. */
+    url: string;
+    /** Set true to use the 24h cache (0 credits on hit). Default false. */
+    cache?: boolean;
+}
+export declare class WebsiteApi {
+    private readonly core;
+    constructor(core: HttpCore);
+    /** Website Contacts — Business website → role emails, E.164 phones, social profiles. 1 credit when something is found, 0 when not. (1 credit) */
+    contacts(params: WebsiteContactsParams): Promise<ApiEnvelope>;
+}
 /** Captapi API client. Get your key at https://captapi.com/dashboard/api-keys */
 export declare class Captapi {
     readonly youtube: YoutubeApi;
@@ -2189,5 +2225,7 @@ export declare class Captapi {
     readonly pillar: PillarApi;
     readonly linkbio: LinkbioApi;
     readonly linkme: LinkmeApi;
+    readonly googleMaps: GoogleMapsApi;
+    readonly website: WebsiteApi;
     constructor(options?: CaptapiOptions);
 }