scavio 0.21.1 → 0.23.0

package/dist/index.d.cts

@@ -489,6 +489,23 @@ interface RedditPopularOptions {
     cursor?: string;
     [key: string]: unknown;
 }
+type RedditCommentSearchSort = "RELEVANCE" | "HOT" | "TOP" | "NEW";
+interface RedditSearchCommentsOptions {
+    /** Search query (1-500 characters). */
+    query: string;
+    /** Sort order (server default 'RELEVANCE'). */
+    sort?: RedditCommentSearchSort;
+    /** Pagination cursor from a prior response. */
+    cursor?: string;
+    [key: string]: unknown;
+}
+interface RedditSearchSubredditsOptions {
+    /** Search query (1-500 characters). */
+    query: string;
+    /** Pagination cursor from a prior response. */
+    cursor?: string;
+    [key: string]: unknown;
+}
 declare class RedditNamespace {
     private client;
     constructor(client: Scavio);
@@ -509,6 +526,17 @@ declare class RedditNamespace {
     userComments(options: RedditUserFeedOptions): Promise<Record<string, unknown>>;
     popular(options?: RedditPopularOptions): Promise<Record<string, unknown>>;
     trending(): Promise<Record<string, unknown>>;
+    /**
+     * Search Reddit comments by keyword. Each result carries the comment text,
+     * author, score and date, plus the post and subreddit it was left on.
+     * Costs 1 credit.
+     */
+    searchComments(options: RedditSearchCommentsOptions): Promise<Record<string, unknown>>;
+    /**
+     * Find subreddits by keyword, with subscriber counts, descriptions and NSFW
+     * flags. Costs 1 credit.
+     */
+    searchSubreddits(options: RedditSearchSubredditsOptions): Promise<Record<string, unknown>>;
 }
 
 interface TikTokProfileOptions {
@@ -534,6 +562,15 @@ interface TikTokVideoOptions {
     video_id: string;
     [key: string]: unknown;
 }
+interface TikTokVideoTranscriptOptions {
+    /** TikTok video id. Pass this or `url`. */
+    video_id?: string;
+    /** A TikTok video URL or share link (alternative to video_id, max 2000 characters). */
+    url?: string;
+    /** Preferred transcript language as a 2-letter code; defaults to the original spoken language. */
+    language?: string;
+    [key: string]: unknown;
+}
 interface TikTokVideoCommentsOptions {
     /** TikTok video id. */
     video_id: string;
@@ -614,12 +651,90 @@ interface TikTokUserFollowingsOptions {
     min_time?: number;
     [key: string]: unknown;
 }
+interface TikTokTrendingVideosOptions {
+    /** Requested videos (1-15, server default 15). About 6 come back per call whatever is set. */
+    count?: number;
+    [key: string]: unknown;
+}
+interface TikTokSearchSuggestionsOptions {
+    /** Seed keyword (1-500 characters). */
+    keyword: string;
+    [key: string]: unknown;
+}
+interface TikTokMusicOptions {
+    /** The sound's numeric id, as a string. */
+    music_id: string;
+    [key: string]: unknown;
+}
+interface TikTokMusicVideosOptions {
+    /** The sound's numeric id, as a string. */
+    music_id: string;
+    /** Pagination cursor (default '0'). */
+    cursor?: string;
+    /** Videos per page (1-30). Ignored upstream; pages hold about 14. */
+    count?: number;
+    [key: string]: unknown;
+}
+interface TikTokSearchMusicOptions {
+    /** Search keyword (1-500 characters). */
+    keyword: string;
+    /** Pagination offset: the previous response's cursor (default '0'). */
+    cursor?: string;
+    /** Sounds per page (1-20). */
+    count?: number;
+    [key: string]: unknown;
+}
+interface TikTokMusicChartOptions {
+    /** 'top' = Top 50 (server default), 'viral' = Viral 50. */
+    chart?: "top" | "viral";
+    /** Pagination cursor (default '0'). */
+    cursor?: string;
+    /** Sounds per page (1-50). */
+    count?: number;
+    [key: string]: unknown;
+}
+interface TikTokUserSimilarOptions {
+    /** TikTok sec_user_id. */
+    sec_user_id: string;
+    /** next_page_token from a prior response. */
+    page_token?: string;
+    [key: string]: unknown;
+}
+interface TikTokUserPlaylistsOptions {
+    /** TikTok sec_user_id. */
+    sec_user_id: string;
+    /** Pagination cursor (default '0'). */
+    cursor?: string;
+    /** Playlists per page (1-30). */
+    count?: number;
+    [key: string]: unknown;
+}
+interface TikTokPlaylistVideosOptions {
+    /** The playlist's numeric id (mixId from userPlaylists), as a string. */
+    playlist_id: string;
+    /** Pagination cursor (default '0'). */
+    cursor?: string;
+    /** Videos per page (1-30). */
+    count?: number;
+    [key: string]: unknown;
+}
+interface TikTokUsernameOptions {
+    /** TikTok username, with or without the @. */
+    username: string;
+    [key: string]: unknown;
+}
 declare class TikTokNamespace {
     private client;
     constructor(client: Scavio);
     profile(options: TikTokProfileOptions): Promise<Record<string, unknown>>;
     userPosts(options: TikTokUserPostsOptions): Promise<Record<string, unknown>>;
     video(options: TikTokVideoOptions): Promise<Record<string, unknown>>;
+    /**
+     * Spoken-word transcript of a TikTok video, as timestamped segments and
+     * full text. Pass `video_id` or `url`. Videos with no spoken captions
+     * (music, dance, muted clips) return `available: false`. 1 credit.
+     */
+    videoTranscript(options: TikTokVideoTranscriptOptions): Promise<Record<string, unknown>>;
     videoComments(options: TikTokVideoCommentsOptions): Promise<Record<string, unknown>>;
     commentReplies(options: TikTokCommentRepliesOptions): Promise<Record<string, unknown>>;
     searchVideos(options: TikTokSearchVideosOptions): Promise<Record<string, unknown>>;
@@ -628,6 +743,83 @@ declare class TikTokNamespace {
     hashtagVideos(options: TikTokHashtagVideosOptions): Promise<Record<string, unknown>>;
     userFollowers(options: TikTokUserFollowersOptions): Promise<Record<string, unknown>>;
     userFollowings(options: TikTokUserFollowingsOptions): Promise<Record<string, unknown>>;
+    /**
+     * Search terms trending on TikTok now (about 90 per call, US-weighted, no
+     * region filter). Costs 1 credit.
+     */
+    trendingSearches(): Promise<Record<string, unknown>>;
+    /**
+     * A sample of videos trending on TikTok now, with author, stats, sound and
+     * hashtags. Each call returns about 6 videos whatever `count` is set to;
+     * call again for a fresh sample. No region filter. Costs 1 credit.
+     * Returns TikTok's raw payload: large numeric ids can lose precision as JSON
+     * numbers, so use the string forms (`id_str`, `sec_uid`).
+     */
+    trendingVideos(options?: TikTokTrendingVideosOptions): Promise<Record<string, unknown>>;
+    /**
+     * TikTok search autocomplete suggestions for a keyword. Long-tail keywords
+     * can return none, which is still a billed answer. Costs 1 credit.
+     */
+    searchSuggestions(options: TikTokSearchSuggestionsOptions): Promise<Record<string, unknown>>;
+    /**
+     * A TikTok sound by id: title, artist, album, duration, how many videos use
+     * it, original vs commercial, play URL, cover, and chart rank when charting.
+     * Costs 1 credit.
+     * Returns TikTok's raw payload: large numeric ids can lose precision as JSON
+     * numbers, so use the string forms (`id_str`, `sec_uid`).
+     */
+    music(options: TikTokMusicOptions): Promise<Record<string, unknown>>;
+    /**
+     * Videos that use a TikTok sound, about 14 per page (`count` is ignored
+     * upstream). Costs 1 credit.
+     * Returns TikTok's raw payload: large numeric ids can lose precision as JSON
+     * numbers, so use the string forms (`id_str`, `sec_uid`).
+     */
+    musicVideos(options: TikTokMusicVideosOptions): Promise<Record<string, unknown>>;
+    /**
+     * Search TikTok sounds by keyword: id, title, artist, duration, usage count
+     * and play URL. Costs 1 credit.
+     * Returns TikTok's raw payload: large numeric ids can lose precision as JSON
+     * numbers, so use the string forms (`id_str`, `sec_uid`).
+     */
+    searchMusic(options: TikTokSearchMusicOptions): Promise<Record<string, unknown>>;
+    /**
+     * TikTok's Top 50 or Viral 50 sound chart, with each sound's details and
+     * trend. One global chart, no region filter. Costs 1 credit.
+     * Returns TikTok's raw payload: large numeric ids can lose precision as JSON
+     * numbers, so use the string forms (`id_str`, `sec_uid`).
+     */
+    musicChart(options?: TikTokMusicChartOptions): Promise<Record<string, unknown>>;
+    /**
+     * Creators similar to a TikTok user (about 30 per page), with follower,
+     * following, video and like counts, bio and verification. Costs 1 credit.
+     * Returns TikTok's raw payload: large numeric ids can lose precision as JSON
+     * numbers, so use the string forms (`id_str`, `sec_uid`).
+     */
+    userSimilar(options: TikTokUserSimilarOptions): Promise<Record<string, unknown>>;
+    /**
+     * A TikTok user's playlists (series): id, name, video count and cover.
+     * Accounts without playlists return an empty list. Costs 1 credit.
+     */
+    userPlaylists(options: TikTokUserPlaylistsOptions): Promise<Record<string, unknown>>;
+    /**
+     * Videos in a TikTok playlist, with pagination. Costs 1 credit.
+     * Returns TikTok's raw payload: large numeric ids can lose precision as JSON
+     * numbers, so use the string forms (`id_str`, `sec_uid`).
+     */
+    playlistVideos(options: TikTokPlaylistVideosOptions): Promise<Record<string, unknown>>;
+    /**
+     * Whether a TikTok user is live now: the user, live room status (2 = live,
+     * 4 = not live), title, start time and viewer counts. An unknown username is
+     * a billed 404. Costs 1 credit.
+     */
+    userLive(options: TikTokUsernameOptions): Promise<Record<string, unknown>>;
+    /**
+     * The region a TikTok account is registered in (ISO country code, not the
+     * creator's nationality), plus its user id and sec_user_id. An unknown
+     * username is a 404 and is not billed. Costs 1 credit.
+     */
+    userRegion(options: TikTokUsernameOptions): Promise<Record<string, unknown>>;
 }
 
 /** Marketplace regions served by suggestions, product, reviews, and shop products. */
@@ -1269,6 +1461,18 @@ interface YouTubeStreamsOptions {
     video_id: string;
     [key: string]: unknown;
 }
+interface YouTubeCommunityPostOptions {
+    /** Community post id or post URL. */
+    post_id: string;
+    [key: string]: unknown;
+}
+interface YouTubeCommunityPostCommentsOptions {
+    /** Community post id or post URL. */
+    post_id: string;
+    /** next_cursor from a prior page, or comments_cursor from communityPost. */
+    cursor?: string;
+    [key: string]: unknown;
+}
 declare class YouTubeNamespace {
     private client;
     constructor(client: Scavio);
@@ -1280,6 +1484,7 @@ declare class YouTubeNamespace {
     metadata(options: YouTubeMetadataOptions): Promise<Record<string, unknown>>;
     comments(options: YouTubeCommentsOptions): Promise<Record<string, unknown>>;
     commentReplies(options: YouTubeCommentRepliesOptions): Promise<Record<string, unknown>>;
+    /** Transcript / captions for a YouTube video. Costs 5 credits. */
     transcript(options: YouTubeTranscriptOptions): Promise<Record<string, unknown>>;
     related(options: YouTubeRelatedOptions): Promise<Record<string, unknown>>;
     channelSearch(options: YouTubeChannelSearchOptions): Promise<Record<string, unknown>>;
@@ -1289,6 +1494,17 @@ declare class YouTubeNamespace {
     channelCommunity(options: YouTubeChannelCommunityOptions): Promise<Record<string, unknown>>;
     channelResolve(options: YouTubeChannelResolveOptions): Promise<Record<string, unknown>>;
     streams(options: YouTubeStreamsOptions): Promise<Record<string, unknown>>;
+    /**
+     * A single YouTube community post: text, author, likes, comment count,
+     * attached images, and a comments_cursor for communityPostComments.
+     * Costs 1 credit.
+     */
+    communityPost(options: YouTubeCommunityPostOptions): Promise<Record<string, unknown>>;
+    /**
+     * Comments on a YouTube community post, with likes, reply counts and
+     * pagination. Costs 1 credit.
+     */
+    communityPostComments(options: YouTubeCommunityPostCommentsOptions): Promise<Record<string, unknown>>;
 }
 
 interface XSearchOptions {
@@ -1338,6 +1554,27 @@ interface XTrendingOptions {
     country?: string;
     [key: string]: unknown;
 }
+interface XSearchCommunitiesOptions {
+    /** Search query (1-500 characters). */
+    keyword: string;
+    /** Pagination cursor from a prior response. */
+    cursor?: string;
+    [key: string]: unknown;
+}
+interface XCommunityOptions {
+    /** Numeric X Community id, as a string. */
+    community_id: string;
+    [key: string]: unknown;
+}
+interface XCommunityTweetsOptions {
+    /** Numeric X Community id, as a string. */
+    community_id: string;
+    /** Ordering (server default: the community's own). */
+    ranking?: "Relevance" | "Recency";
+    /** Pagination cursor from a prior response. */
+    cursor?: string;
+    [key: string]: unknown;
+}
 declare class XNamespace {
     private client;
     constructor(client: Scavio);
@@ -1352,6 +1589,21 @@ declare class XNamespace {
     userFollowers(options: XUserFeedOptions): Promise<Record<string, unknown>>;
     userFollowings(options: XUserFeedOptions): Promise<Record<string, unknown>>;
     trending(options?: XTrendingOptions): Promise<Record<string, unknown>>;
+    /**
+     * Find X Communities by keyword, with member counts, topic and NSFW flag.
+     * Costs 1 credit.
+     */
+    searchCommunities(options: XSearchCommunitiesOptions): Promise<Record<string, unknown>>;
+    /**
+     * An X Community: name, description, creation date, member count, topic and
+     * rules. Costs 1 credit.
+     */
+    community(options: XCommunityOptions): Promise<Record<string, unknown>>;
+    /**
+     * Posts in an X Community, by relevance or recency, with pagination.
+     * Costs 1 credit.
+     */
+    communityTweets(options: XCommunityTweetsOptions): Promise<Record<string, unknown>>;
 }
 
 /** A member reference: a vanity handle, or a full profile URL. */
@@ -5084,6 +5336,273 @@ declare class MercadoLibreNamespace {
     bestSellers(options: MercadoLibreBestSellersOptions): Promise<Record<string, unknown>>;
 }
 
+/** Fetch tier, as on Extract: standard, renders JavaScript, hardest pages. */
+type ExtractMode = "normal" | "advanced" | "ultra";
+/** Return format for each page, as on Extract. */
+type ExtractFormat = "html" | "markdown" | "text";
+/** How a map or crawl uses the site's sitemaps. */
+type ExtractSitemapMode = "include" | "only" | "skip";
+interface ExtractMapOptions {
+    /** The site to map. A bare host is upgraded to https. 1-2048 characters. */
+    url: string;
+    /** Only return URLs containing every word of this text (case-insensitive, max 200). */
+    search?: string;
+    /**
+     * Maximum links to return, 1-5,000. Default 1,000 (or your plan's limit if
+     * lower). Plan limits: Free 500, PAYG 1,000, paid plans 5,000.
+     */
+    limit?: number;
+    /**
+     * "include" (default) combines the site's sitemaps with the links on the
+     * start page; "only" uses sitemaps alone; "skip" uses page links alone.
+     */
+    sitemap?: ExtractSitemapMode;
+    /** Also return URLs on subdomains. Default false (www and the bare domain count as one site). */
+    include_subdomains?: boolean;
+    /** Path globs to keep (max 20). `*` matches within a segment, `**` across segments. */
+    include_paths?: string[];
+    /** Path globs to drop (max 20). */
+    exclude_paths?: string[];
+    /** Treat URLs that differ only by query string as one URL. Default true. */
+    ignore_query_parameters?: boolean;
+    /** Fetch tier. Default "normal" (1 credit). */
+    mode?: ExtractMode;
+    [key: string]: unknown;
+}
+interface ExtractCrawlOptions {
+    /** Where the crawl starts. Only pages on the same site are crawled. */
+    url: string;
+    /**
+     * Maximum pages to fetch, 1-10,000. Default 100. Plan limits: Free 10,
+     * PAYG 100, Project 500, Bootstrap 2,000, Startup 5,000, Growth 10,000.
+     */
+    max_pages?: number;
+    /** Links away from the start page to follow, 0-10 (default 3). 0 fetches only the start page. */
+    max_depth?: number;
+    /** Path globs to crawl (max 20), e.g. ["/blog/**"]. */
+    include_paths?: string[];
+    /** Path globs to skip (max 20). */
+    exclude_paths?: string[];
+    /** Also crawl subdomains of the site. Default false. */
+    allow_subdomains?: boolean;
+    /** Treat URLs that differ only by query string as one page. Default true. */
+    ignore_query_parameters?: boolean;
+    /**
+     * "include" (default) also starts from the site's sitemap; "skip" follows
+     * links only; "only" fetches sitemap pages without following links.
+     */
+    sitemap?: ExtractSitemapMode;
+    /** Return format for each page. Default "markdown". */
+    format?: ExtractFormat;
+    /** Fetch tier, the price per successful page: normal 1, advanced 1, ultra 2. */
+    mode?: ExtractMode;
+    /**
+     * https URL that receives a signed POST when the job completes, fails or is
+     * cancelled. The signing secret comes back once, as `webhook_secret`.
+     * Verify deliveries with `verifyWebhook`.
+     */
+    webhook_url?: string;
+    [key: string]: unknown;
+}
+interface ExtractBatchOptions {
+    /**
+     * The pages to extract (duplicates removed). Plan limits: Free 10, PAYG 50,
+     * Project 100, Bootstrap 500, Startup and Growth 1,000.
+     */
+    urls: string[];
+    /** Return format for each page. Default "markdown". */
+    format?: ExtractFormat;
+    /** Fetch tier, the price per successful page: normal 1, advanced 1, ultra 2. */
+    mode?: ExtractMode;
+    /** https URL that receives a signed POST when the job finishes. See `ExtractCrawlOptions.webhook_url`. */
+    webhook_url?: string;
+    [key: string]: unknown;
+}
+/** Client-side options for starting a crawl or batch job. */
+interface ExtractJobRequestOptions {
+    /**
+     * Sent as the `Idempotency-Key` header. Repeating the POST with the same
+     * key within 24 hours returns the original job instead of starting a new
+     * one, so the SDK's automatic retries can never start a second job.
+     */
+    idempotencyKey?: string;
+    /**
+     * Poll until the job finishes and return every result in one response
+     * (all pages of the status endpoint, `next_cursor: null`). Default false:
+     * return the 202 job handle immediately.
+     */
+    wait?: boolean;
+    /** With `wait`: milliseconds between status polls. Default 2,000. */
+    pollInterval?: number;
+    /**
+     * With `wait`: give up after this many milliseconds and throw
+     * `ScavioJobTimeoutError` (the job keeps running; its id is on the error).
+     * Default 600,000 (10 minutes).
+     */
+    waitTimeout?: number;
+}
+interface ExtractJobStatusQuery {
+    /** `next_cursor` from the previous response. */
+    cursor?: string;
+    /** Results per response, 1-100 (default 25). Responses are also cut at about 5 MB of content. */
+    limit?: number;
+    /** Only results with this status. */
+    status?: "succeeded" | "failed" | "skipped";
+    /** Set false to page through results without their content. Default true. */
+    include_content?: boolean;
+}
+interface ExtractMapLink {
+    url: string;
+    source: "sitemap" | "page";
+    lastmod?: string;
+}
+interface ExtractMapResponse {
+    data: {
+        url: string;
+        links: ExtractMapLink[];
+        total_found: number;
+        returned: number;
+        truncated: boolean;
+        sitemaps_read: number;
+    };
+    response_time: number;
+    credits_used: number;
+    credits_remaining: number;
+}
+interface ExtractJobCreatedResponse {
+    data: {
+        id: string;
+        type: "crawl" | "batch";
+        status: string;
+        url: string | null;
+        max_pages: number;
+        max_depth: number;
+        format: string;
+        mode: string;
+        credits_per_page: number;
+        status_url: string;
+        urls_count?: number;
+        invalid_urls?: {
+            url: string;
+            error: string;
+        }[];
+        webhook_url?: string;
+        /** Returned once, on creation. Keep it to verify webhook deliveries. */
+        webhook_secret?: string;
+    };
+    credits_used: number;
+}
+type ExtractJobState = "queued" | "running" | "completed" | "failed" | "cancelled";
+interface ExtractJobSummary {
+    id: string;
+    type: string;
+    status: ExtractJobState;
+    /** Why a completed job stopped early: max_pages, insufficient_credits, time_limit, storage_limit, or cancelled. */
+    stopped_reason: string | null;
+    error: string | null;
+    url: string | null;
+    format: string;
+    mode: string;
+    pages: {
+        discovered: number;
+        queued: number;
+        succeeded: number;
+        failed: number;
+        skipped: number;
+    };
+    credits_used: number;
+    created_at: string | null;
+    started_at: string | null;
+    completed_at: string | null;
+    /** Results are deleted after this time (3 days after the job finishes). */
+    expires_at: string | null;
+    webhook: {
+        status: string | null;
+        attempts: number;
+    } | null;
+    status_url: string;
+}
+interface ExtractJobResult {
+    url: string;
+    depth: number;
+    status: "succeeded" | "failed" | "skipped";
+    status_code: number | null;
+    content?: string | null;
+    content_length: number | null;
+    truncated: boolean;
+    error: string | null;
+    skip_reason: string | null;
+    credits: number;
+}
+interface ExtractJobStatusResponse {
+    data: ExtractJobSummary & {
+        results: ExtractJobResult[];
+        next_cursor: string | null;
+    };
+}
+interface ExtractJobSummaryResponse {
+    data: ExtractJobSummary;
+}
+type WaitOptions = ExtractJobRequestOptions & {
+    wait: true;
+};
+type NoWaitOptions = ExtractJobRequestOptions & {
+    wait?: false;
+};
+/**
+ * The website operations of Extract: map a site's URLs, crawl a site, and
+ * extract a list of URLs in one job. Reached as `scavio.extract.map(...)`,
+ * `scavio.extract.crawl(...)` and so on; `scavio.extract({ url })` itself
+ * still reads a single page.
+ *
+ * Map is synchronous (1 credit). Crawl and batch are jobs: they return 202
+ * with an id, and you poll the status method (free) for results, or pass
+ * `{ wait: true }`. Jobs bill per SUCCESSFUL page at Extract's price for the
+ * tier (normal 1, advanced 1, ultra 2); failed and skipped pages are free.
+ */
+declare class ExtractNamespace {
+    private readonly client;
+    constructor(client: Scavio);
+    /**
+     * List a site's page URLs, gathered from its sitemaps and its start page,
+     * deduplicated, filtered by path and limited. Pages disallowed by the
+     * site's robots.txt are left out. 1 credit on the normal tier.
+     */
+    map(options: ExtractMapOptions): Promise<ExtractMapResponse>;
+    /**
+     * Start a crawl from one URL: same-site pages are discovered breadth-first
+     * (URLs under the start path first) within your depth, page and path
+     * limits, each returned like Extract. robots.txt is always obeyed. Returns
+     * the 202 job handle, or every result when `wait` is true.
+     */
+    crawl(options: ExtractCrawlOptions, request: WaitOptions): Promise<ExtractJobStatusResponse>;
+    crawl(options: ExtractCrawlOptions, request?: NoWaitOptions): Promise<ExtractJobCreatedResponse>;
+    crawl(options: ExtractCrawlOptions, request?: ExtractJobRequestOptions): Promise<ExtractJobCreatedResponse | ExtractJobStatusResponse>;
+    /** A crawl's progress and its page results, paged by cursor. Free. */
+    crawlStatus(id: string, query?: ExtractJobStatusQuery): Promise<ExtractJobStatusResponse>;
+    /**
+     * Stop a queued or running crawl. No further pages are fetched or billed;
+     * results so far stay available. A finished crawl answers 409. Free.
+     */
+    cancelCrawl(id: string): Promise<ExtractJobSummaryResponse>;
+    /**
+     * Extract a list of URLs in one job, each returned like Extract. Invalid
+     * URLs come back in `invalid_urls` and are never billed. Returns the 202
+     * job handle, or every result (in input order) when `wait` is true.
+     */
+    batch(options: ExtractBatchOptions, request: WaitOptions): Promise<ExtractJobStatusResponse>;
+    batch(options: ExtractBatchOptions, request?: NoWaitOptions): Promise<ExtractJobCreatedResponse>;
+    batch(options: ExtractBatchOptions, request?: ExtractJobRequestOptions): Promise<ExtractJobCreatedResponse | ExtractJobStatusResponse>;
+    /** A batch's progress and its page results in input order, paged by cursor. Free. */
+    batchStatus(id: string, query?: ExtractJobStatusQuery): Promise<ExtractJobStatusResponse>;
+    /** Stop a queued or running batch. A finished batch answers 409. Free. */
+    cancelBatch(id: string): Promise<ExtractJobSummaryResponse>;
+    private start;
+    private status;
+    private cancel;
+    private waitFor;
+}
+
 /**
  * Default client-side rate limit, safe on every plan including free.
  */
@@ -5128,14 +5647,56 @@ interface ExtractOptions {
     /**
      * Fetch tier, and THE PRICE-BEARING PARAM (default "normal").
      *
-     * - "normal": plain datacenter fetch - 1 credit.
-     * - "advanced": headless browser render, for JS-built pages - 1 credit.
-     * - "ultra": residential proxy, for hard bot walls - 2 credits.
+     * - "normal": the standard fetch - 1 credit.
+     * - "advanced": renders JavaScript, for JS-built pages - 1 credit.
+     * - "ultra": the hardest pages and bot walls - 2 credits.
      */
     mode?: "normal" | "advanced" | "ultra";
     [key: string]: unknown;
 }
-declare class Scavio {
+/**
+ * `scavio.extract`: call it to read one page, or use its methods for the
+ * website operations - `scavio.extract.map()`, `.crawl()`, `.crawlStatus()`,
+ * `.cancelCrawl()`, `.batch()`, `.batchStatus()`, `.cancelBatch()`.
+ */
+interface Extract extends ExtractNamespace {
+    (options: ExtractOptions): Promise<Record<string, unknown>>;
+}
+/**
+ * Holds the single-page Extract call. TypeScript cannot declare a method and
+ * a property of the same name on one class, so the implementation lives here
+ * and `Scavio` narrows `extract` to the callable `Extract` namespace, which
+ * delegates to this method when called.
+ */
+declare abstract class ScavioCore {
+    /** @internal */
+    abstract _post(path: string, body: object, headers?: Record<string, string>): Promise<Record<string, unknown>>;
+    /**
+     * Read ANY web page and get it back as readability Markdown (the default),
+     * plain text, or raw HTML. Returns `{ url, format, mode, content,
+     * content_length }`.
+     *
+     * Extract is a core endpoint, not a platform: `scavio.extract({ url })`
+     * reads one page, and `scavio.extract.map()` / `.crawl()` / `.batch()` work
+     * on whole sites and URL lists.
+     *
+     * Credits are a function of `mode`, not a flat per-call constant:
+     * "normal" costs 1, "advanced" costs 1, "ultra" costs 2. Billing happens
+     * only on a successful extraction - a dead link, bot wall or timeout costs
+     * nothing.
+     *
+     * Start on "normal". Move to "advanced" when the page builds its content in
+     * the browser, and to "ultra" only when a bot wall blocks the other two.
+     *
+     * @example
+     * const page = await scavio.extract({ url: "https://example.com/pricing" });
+     * console.log(page.content);
+     */
+    extract(options: ExtractOptions): Promise<Record<string, unknown>>;
+}
+declare class Scavio extends ScavioCore {
+    /** Read one page (call it), or map / crawl / batch-extract (its methods). */
+    readonly extract: Extract;
     readonly google: GoogleNamespace;
     readonly amazon: AmazonNamespace;
     readonly walmart: WalmartNamespace;
@@ -5179,34 +5740,35 @@ declare class Scavio {
     private readonly rateLimiter;
     constructor(config?: ScavioConfig);
     /** @internal */
-    _post(path: string, body: object): Promise<Record<string, unknown>>;
+    _post(path: string, body: object, headers?: Record<string, string>): Promise<Record<string, unknown>>;
+    /** @internal */
+    _get(path: string, query?: Record<string, string | number | boolean | undefined>): Promise<Record<string, unknown>>;
     /** @internal */
-    _get(path: string): Promise<Record<string, unknown>>;
+    _delete(path: string): Promise<Record<string, unknown>>;
     search(options: GoogleSearchOptions): Promise<Record<string, unknown>>;
-    /**
-     * Read ANY web page and get it back as readability Markdown (the default),
-     * plain text, or raw HTML. Returns `{ url, format, mode, content,
-     * content_length }`.
-     *
-     * This is a core endpoint, not a platform, so it lives on the client itself:
-     * `scavio.extract({ url })`, never `scavio.extract.extract()`.
-     *
-     * Credits are a function of `mode`, not a flat per-call constant:
-     * "normal" costs 1, "advanced" costs 1, "ultra" costs 2. Billing happens
-     * only on a successful extraction - a dead link, bot wall or timeout costs
-     * nothing.
-     *
-     * Start on "normal". Move to "advanced" when the page builds its content in
-     * the browser, and to "ultra" only when a bot wall blocks the other two.
-     *
-     * @example
-     * const page = await scavio.extract({ url: "https://example.com/pricing" });
-     * console.log(page.content);
-     */
-    extract(options: ExtractOptions): Promise<Record<string, unknown>>;
     getUsage(): Promise<Record<string, unknown>>;
 }
 
+/**
+ * Verify a crawl or batch completion webhook from Scavio.
+ *
+ * Each delivery carries `Scavio-Signature: t=<unix>,v1=<hex>`, where v1 is
+ * HMAC-SHA256 of `"<t>.<raw body>"` keyed with the job's `webhook_secret`
+ * (returned once, when the job is created). Pass the RAW request body - the
+ * exact bytes received, before any JSON parsing - or the signature will not
+ * match.
+ *
+ * Uses Web Crypto, so it runs on Node 18+, Deno, Bun and edge runtimes; it is
+ * async for that reason. Returns false (never throws) for a missing,
+ * malformed, tampered or stale signature.
+ *
+ * @param secret The job's `webhook_secret` (`whsec_...`).
+ * @param header The `Scavio-Signature` header value.
+ * @param body The raw request body, as a string or bytes.
+ * @param toleranceSec Maximum age of the signature in seconds (default 300).
+ */
+declare function verifyWebhook(secret: string, header: string | null | undefined, body: string | Uint8Array, toleranceSec?: number): Promise<boolean>;
+
 declare class ScavioError extends Error {
     constructor(message: string);
 }
@@ -5257,5 +5819,16 @@ declare class ScavioAPIError extends ScavioError {
     readonly responseBody?: Record<string, unknown>;
     constructor(statusCode: number, message: string, responseBody?: Record<string, unknown>);
 }
+/**
+ * A crawl or batch started with `{ wait: true }` did not finish within
+ * `waitTimeout`. The job is still running: poll it with `jobId`, or cancel it.
+ */
+declare class ScavioJobTimeoutError extends ScavioError {
+    readonly jobType: "crawl" | "batch";
+    readonly jobId: string;
+    readonly statusUrl: string;
+    readonly lastStatus: string;
+    constructor(jobType: "crawl" | "batch", jobId: string, statusUrl: string, lastStatus: string);
+}
 
-export { type AirbnbListingOptions, AirbnbNamespace, type AirbnbReviewsOptions, type AirbnbSearchOptions, AmazonNamespace, type AmazonOffersOptions, type AmazonProductOptions, type AmazonSearchOptions, type AppStoreAppOptions, AppStoreNamespace, type AppStoreReviewsOptions, type AppStoreSearchOptions, BadRequestError, type BookingHotelOptions, BookingNamespace, type BookingReviewsOptions, type BookingSearchOptions, CapterraNamespace, type CapterraProductOptions, type CapterraReviewsOptions, type CapterraSearchOptions, type CompaniesHouseCompanyOptions, type CompaniesHouseFilingHistoryOptions, CompaniesHouseNamespace, type CompaniesHouseOfficersOptions, type CompaniesHouseSearchOptions, type CostcoAutocompleteOptions, type CostcoAvailabilityOptions, type CostcoCategoriesOptions, type CostcoCategoryOptions, type CostcoClearanceOptions, type CostcoCountry, type CostcoCouponsOptions, type CostcoDealType, type CostcoDealsOptions, type CostcoGasOptions, type CostcoListingFilters, type CostcoNaCountry, CostcoNamespace, type CostcoPriceCode, type CostcoPricesOptions, type CostcoProductOptions, type CostcoReviewsOptions, type CostcoSearchOptions, type CostcoSortBy, type CostcoWarehousesOptions, DEFAULT_MAX_REQUESTS_PER_SECOND, EbayNamespace, type EbayProductOptions, type EbaySearchOptions, type EbaySellerOptions, type ExtractOptions, G2Namespace, type G2ProductOptions, type G2ReviewsOptions, type G2SearchOptions, type GlassdoorCompaniesOptions, type GlassdoorCompanyOptions, GlassdoorNamespace, type GlassdoorReviewsOptions, type GlassdoorSalariesOptions, type GoogleAdsAdvertisersOptions, type GoogleAdsCreativeOptions, GoogleAdsNamespace, type GoogleAdsSearchOptions, type GoogleAiModeOptions, type GoogleFlightsOptions, type GoogleHotelsDetailOptions, type GoogleHotelsOptions, type GoogleMapsPlaceOptions, type GoogleMapsReviewsOptions, type GoogleMapsSearchOptions, GoogleNamespace, type GoogleNewsOptions, type GooglePlayAppOptions, GooglePlayNamespace, type GooglePlayReviewsOptions, type GooglePlaySearchOptions, type GoogleSearchOptions, type GoogleShoppingOptions, type GoogleShoppingProductOptions, type GoogleShoppingStoresOptions, type GoogleTrendingOptions, type GoogleTrendsOptions, HomeDepotNamespace, type HomeDepotProductOptions, type HomeDepotReviewsOptions, type HomeDepotSearchOptions, type IndeedCompanyOptions, type IndeedCompanyReviewsOptions, type IndeedJobOptions, IndeedNamespace, type IndeedSearchOptions, type InstagramCommentRepliesOptions, type InstagramFollowOptions, InstagramNamespace, type InstagramPostCommentsOptions, type InstagramPostOptions, type InstagramProfileOptions, type InstagramSearchOptions, type InstagramStoriesOptions, type InstagramUserFeedOptions, InsufficientCreditsError, InvalidAPIKeyError, type KuaishouCommentRepliesOptions, KuaishouNamespace, type KuaishouProfileOptions, type KuaishouSearchLiveOptions, type KuaishouSearchOptions, type KuaishouSearchUsersOptions, type KuaishouSearchVideosOptions, type KuaishouTagFeedOptions, type KuaishouTrendingOptions, type KuaishouUserLiveOptions, type KuaishouUserPostsOptions, type KuaishouUserResolveOptions, type KuaishouVideoCommentsOptions, type KuaishouVideoOptions, type KuaishouVideosBatchOptions, type LinkedInCompanyOptions, type LinkedInCompanyPostsOptions, type LinkedInCompanyPostsRequest, type LinkedInCompanyRefOptions, type LinkedInJobOptions, LinkedInNamespace, type LinkedInPersonContactOptions, type LinkedInPersonOptions, type LinkedInPersonPostsOptions, type LinkedInPersonPostsRequest, type LinkedInPersonRefOptions, type LinkedInPostCommentsOptions, type LinkedInPostOptions, type LinkedInSearchJobsOptions, type LinkedInSearchPeopleOptions, type LinkedInSearchPostsOptions, MAX_REQUESTS_PER_SECOND, type MercadoLibreBestSellersCountry, type MercadoLibreBestSellersOptions, type MercadoLibreCondition, type MercadoLibreCountry, type MercadoLibreDiscount, MercadoLibreNamespace, type MercadoLibreProductOptions, type MercadoLibreQuestionsOptions, type MercadoLibreReviewsOptions, type MercadoLibreSearchOptions, type MercadoLibreSort, type MetaAdsAdOptions, type MetaAdsAdvertiserOptions, MetaAdsNamespace, type MetaAdsSearchOptions, MissingAPIKeyError, NotFoundError, RateLimitError, type RealtorAgentOptions, type RealtorAgentsOptions, type RealtorListingStatus, type RealtorLocationsOptions, type RealtorMarketOptions, RealtorNamespace, type RealtorPropertyOptions, type RealtorPropertyType, type RealtorSearchOptions, type RealtorSort, type RedditCommentRepliesOptions, type RedditFeedSort, RedditNamespace, type RedditPopularOptions, type RedditPostCommentsOptions, type RedditPostOptions, type RedditSearchOptions, type RedditSearchSuggestionsOptions, type RedditSort, type RedditSubredditOptions, type RedditSubredditPostsOptions, type RedditUserFeedOptions, type RedditUserOptions, type RedfinMarketOptions, RedfinNamespace, type RedfinPropertyOptions, type RedfinSearchOptions, type RightmoveAgentOptions, type RightmoveAgentsOptions, type RightmoveExclude, type RightmoveFurnishing, type RightmoveLetType, type RightmoveListingStatus, type RightmoveLocationsOptions, type RightmoveMustHave, RightmoveNamespace, type RightmovePropertyOptions, type RightmovePropertyType, type RightmoveRadius, type RightmoveSearchOptions, type RightmoveSoldOptions, type RightmoveSoldPropertyOptions, type RightmoveSoldPropertyType, type RightmoveSoldSort, type RightmoveSort, type RightmoveTenure, type SECCompanyOptions, type SECConceptOptions, type SECFactsOptions, type SECFilingsOptions, type SECLookupOptions, SECNamespace, type SECSearchOptions, Scavio, ScavioAPIError, type ScavioConfig, ScavioConnectionError, ScavioError, ScavioTimeoutError, type TargetCategoryOptions, TargetNamespace, type TargetProductOptions, type TargetReviewsOptions, type TargetSearchOptions, ThreadsNamespace, type ThreadsPostCommentsOptions, type ThreadsPostOptions, type ThreadsProfileOptions, type ThreadsSearchUsersOptions, type ThreadsUserPostsOptions, type ThreadsUserRepliesOptions, type TikTokCommentRepliesOptions, type TikTokHashtagOptions, type TikTokHashtagVideosOptions, TikTokNamespace, type TikTokProfileOptions, type TikTokSearchUsersOptions, type TikTokSearchVideosOptions, type TikTokShopCategoryProductsOptions, type TikTokShopListingRegion, TikTokShopNamespace, type TikTokShopProductOptions, type TikTokShopProductReviewsOptions, type TikTokShopRegion, type TikTokShopResolveOptions, type TikTokShopReviewSort, type TikTokShopSearchOptions, type TikTokShopShopProductsOptions, type TikTokShopSuggestionsOptions, type TikTokUserFollowersOptions, type TikTokUserFollowingsOptions, type TikTokUserPostsOptions, type TikTokVideoCommentsOptions, type TikTokVideoOptions, type TripadvisorLocationOptions, type TripadvisorLocationsOptions, TripadvisorNamespace, type TripadvisorReviewsOptions, type TripadvisorSearchOptions, type TrustpilotBusinessAddress, type TrustpilotBusinessOptions, type TrustpilotCategoriesOptions, type TrustpilotCategoryOptions, type TrustpilotCategorySort, TrustpilotNamespace, type TrustpilotReviewOptions, type TrustpilotReviewsDateRange, type TrustpilotReviewsOptions, type TrustpilotReviewsSort, type TrustpilotSearchOptions, type TrustpilotStars, type WalmartCategoryOptions, WalmartNamespace, type WalmartOffersOptions, type WalmartProductOptions, type WalmartReviewsOptions, type WalmartSearchOptions, type WalmartSellerOptions, type WalmartSellerProductsOptions, type WalmartStore, type WalmartStoresData, type WalmartStoresOptions, type WalmartStoresResponse, XNamespace, type XSearchOptions, type XTrendingOptions, type XTweetCommentsOptions, type XTweetOptions, type XTweetRetweetersOptions, type XUserFeedOptions, type XUserOptions, type YelpBusinessOptions, YelpNamespace, type YelpReviewsOptions, type YelpSearchOptions, type YouTubeChannelCommunityOptions, type YouTubeChannelOptions, type YouTubeChannelResolveOptions, type YouTubeChannelSearchOptions, type YouTubeChannelShortsOptions, type YouTubeChannelVideosOptions, type YouTubeCommentRepliesOptions, type YouTubeCommentsOptions, type YouTubeMetadataOptions, YouTubeNamespace, type YouTubeRelatedOptions, type YouTubeSearchOptions, type YouTubeShortsOptions, type YouTubeStreamsOptions, type YouTubeSuggestionsOptions, type YouTubeTranscriptOptions, type YouTubeVideoOptions, type ZillowAgentReviewsOptions, ZillowNamespace, type ZillowPropertyOptions, type ZillowSearchOptions };
+export { type AirbnbListingOptions, AirbnbNamespace, type AirbnbReviewsOptions, type AirbnbSearchOptions, AmazonNamespace, type AmazonOffersOptions, type AmazonProductOptions, type AmazonSearchOptions, type AppStoreAppOptions, AppStoreNamespace, type AppStoreReviewsOptions, type AppStoreSearchOptions, BadRequestError, type BookingHotelOptions, BookingNamespace, type BookingReviewsOptions, type BookingSearchOptions, CapterraNamespace, type CapterraProductOptions, type CapterraReviewsOptions, type CapterraSearchOptions, type CompaniesHouseCompanyOptions, type CompaniesHouseFilingHistoryOptions, CompaniesHouseNamespace, type CompaniesHouseOfficersOptions, type CompaniesHouseSearchOptions, type CostcoAutocompleteOptions, type CostcoAvailabilityOptions, type CostcoCategoriesOptions, type CostcoCategoryOptions, type CostcoClearanceOptions, type CostcoCountry, type CostcoCouponsOptions, type CostcoDealType, type CostcoDealsOptions, type CostcoGasOptions, type CostcoListingFilters, type CostcoNaCountry, CostcoNamespace, type CostcoPriceCode, type CostcoPricesOptions, type CostcoProductOptions, type CostcoReviewsOptions, type CostcoSearchOptions, type CostcoSortBy, type CostcoWarehousesOptions, DEFAULT_MAX_REQUESTS_PER_SECOND, EbayNamespace, type EbayProductOptions, type EbaySearchOptions, type EbaySellerOptions, type Extract, type ExtractBatchOptions, type ExtractCrawlOptions, type ExtractFormat, type ExtractJobCreatedResponse, type ExtractJobRequestOptions, type ExtractJobResult, type ExtractJobState, type ExtractJobStatusQuery, type ExtractJobStatusResponse, type ExtractJobSummary, type ExtractJobSummaryResponse, type ExtractMapLink, type ExtractMapOptions, type ExtractMapResponse, type ExtractMode, ExtractNamespace, type ExtractOptions, type ExtractSitemapMode, G2Namespace, type G2ProductOptions, type G2ReviewsOptions, type G2SearchOptions, type GlassdoorCompaniesOptions, type GlassdoorCompanyOptions, GlassdoorNamespace, type GlassdoorReviewsOptions, type GlassdoorSalariesOptions, type GoogleAdsAdvertisersOptions, type GoogleAdsCreativeOptions, GoogleAdsNamespace, type GoogleAdsSearchOptions, type GoogleAiModeOptions, type GoogleFlightsOptions, type GoogleHotelsDetailOptions, type GoogleHotelsOptions, type GoogleMapsPlaceOptions, type GoogleMapsReviewsOptions, type GoogleMapsSearchOptions, GoogleNamespace, type GoogleNewsOptions, type GooglePlayAppOptions, GooglePlayNamespace, type GooglePlayReviewsOptions, type GooglePlaySearchOptions, type GoogleSearchOptions, type GoogleShoppingOptions, type GoogleShoppingProductOptions, type GoogleShoppingStoresOptions, type GoogleTrendingOptions, type GoogleTrendsOptions, HomeDepotNamespace, type HomeDepotProductOptions, type HomeDepotReviewsOptions, type HomeDepotSearchOptions, type IndeedCompanyOptions, type IndeedCompanyReviewsOptions, type IndeedJobOptions, IndeedNamespace, type IndeedSearchOptions, type InstagramCommentRepliesOptions, type InstagramFollowOptions, InstagramNamespace, type InstagramPostCommentsOptions, type InstagramPostOptions, type InstagramProfileOptions, type InstagramSearchOptions, type InstagramStoriesOptions, type InstagramUserFeedOptions, InsufficientCreditsError, InvalidAPIKeyError, type KuaishouCommentRepliesOptions, KuaishouNamespace, type KuaishouProfileOptions, type KuaishouSearchLiveOptions, type KuaishouSearchOptions, type KuaishouSearchUsersOptions, type KuaishouSearchVideosOptions, type KuaishouTagFeedOptions, type KuaishouTrendingOptions, type KuaishouUserLiveOptions, type KuaishouUserPostsOptions, type KuaishouUserResolveOptions, type KuaishouVideoCommentsOptions, type KuaishouVideoOptions, type KuaishouVideosBatchOptions, type LinkedInCompanyOptions, type LinkedInCompanyPostsOptions, type LinkedInCompanyPostsRequest, type LinkedInCompanyRefOptions, type LinkedInJobOptions, LinkedInNamespace, type LinkedInPersonContactOptions, type LinkedInPersonOptions, type LinkedInPersonPostsOptions, type LinkedInPersonPostsRequest, type LinkedInPersonRefOptions, type LinkedInPostCommentsOptions, type LinkedInPostOptions, type LinkedInSearchJobsOptions, type LinkedInSearchPeopleOptions, type LinkedInSearchPostsOptions, MAX_REQUESTS_PER_SECOND, type MercadoLibreBestSellersCountry, type MercadoLibreBestSellersOptions, type MercadoLibreCondition, type MercadoLibreCountry, type MercadoLibreDiscount, MercadoLibreNamespace, type MercadoLibreProductOptions, type MercadoLibreQuestionsOptions, type MercadoLibreReviewsOptions, type MercadoLibreSearchOptions, type MercadoLibreSort, type MetaAdsAdOptions, type MetaAdsAdvertiserOptions, MetaAdsNamespace, type MetaAdsSearchOptions, MissingAPIKeyError, NotFoundError, RateLimitError, type RealtorAgentOptions, type RealtorAgentsOptions, type RealtorListingStatus, type RealtorLocationsOptions, type RealtorMarketOptions, RealtorNamespace, type RealtorPropertyOptions, type RealtorPropertyType, type RealtorSearchOptions, type RealtorSort, type RedditCommentRepliesOptions, type RedditCommentSearchSort, type RedditFeedSort, RedditNamespace, type RedditPopularOptions, type RedditPostCommentsOptions, type RedditPostOptions, type RedditSearchCommentsOptions, type RedditSearchOptions, type RedditSearchSubredditsOptions, type RedditSearchSuggestionsOptions, type RedditSort, type RedditSubredditOptions, type RedditSubredditPostsOptions, type RedditUserFeedOptions, type RedditUserOptions, type RedfinMarketOptions, RedfinNamespace, type RedfinPropertyOptions, type RedfinSearchOptions, type RightmoveAgentOptions, type RightmoveAgentsOptions, type RightmoveExclude, type RightmoveFurnishing, type RightmoveLetType, type RightmoveListingStatus, type RightmoveLocationsOptions, type RightmoveMustHave, RightmoveNamespace, type RightmovePropertyOptions, type RightmovePropertyType, type RightmoveRadius, type RightmoveSearchOptions, type RightmoveSoldOptions, type RightmoveSoldPropertyOptions, type RightmoveSoldPropertyType, type RightmoveSoldSort, type RightmoveSort, type RightmoveTenure, type SECCompanyOptions, type SECConceptOptions, type SECFactsOptions, type SECFilingsOptions, type SECLookupOptions, SECNamespace, type SECSearchOptions, Scavio, ScavioAPIError, type ScavioConfig, ScavioConnectionError, ScavioError, ScavioJobTimeoutError, ScavioTimeoutError, type TargetCategoryOptions, TargetNamespace, type TargetProductOptions, type TargetReviewsOptions, type TargetSearchOptions, ThreadsNamespace, type ThreadsPostCommentsOptions, type ThreadsPostOptions, type ThreadsProfileOptions, type ThreadsSearchUsersOptions, type ThreadsUserPostsOptions, type ThreadsUserRepliesOptions, type TikTokCommentRepliesOptions, type TikTokHashtagOptions, type TikTokHashtagVideosOptions, type TikTokMusicChartOptions, type TikTokMusicOptions, type TikTokMusicVideosOptions, TikTokNamespace, type TikTokPlaylistVideosOptions, type TikTokProfileOptions, type TikTokSearchMusicOptions, type TikTokSearchSuggestionsOptions, type TikTokSearchUsersOptions, type TikTokSearchVideosOptions, type TikTokShopCategoryProductsOptions, type TikTokShopListingRegion, TikTokShopNamespace, type TikTokShopProductOptions, type TikTokShopProductReviewsOptions, type TikTokShopRegion, type TikTokShopResolveOptions, type TikTokShopReviewSort, type TikTokShopSearchOptions, type TikTokShopShopProductsOptions, type TikTokShopSuggestionsOptions, type TikTokTrendingVideosOptions, type TikTokUserFollowersOptions, type TikTokUserFollowingsOptions, type TikTokUserPlaylistsOptions, type TikTokUserPostsOptions, type TikTokUserSimilarOptions, type TikTokUsernameOptions, type TikTokVideoCommentsOptions, type TikTokVideoOptions, type TikTokVideoTranscriptOptions, type TripadvisorLocationOptions, type TripadvisorLocationsOptions, TripadvisorNamespace, type TripadvisorReviewsOptions, type TripadvisorSearchOptions, type TrustpilotBusinessAddress, type TrustpilotBusinessOptions, type TrustpilotCategoriesOptions, type TrustpilotCategoryOptions, type TrustpilotCategorySort, TrustpilotNamespace, type TrustpilotReviewOptions, type TrustpilotReviewsDateRange, type TrustpilotReviewsOptions, type TrustpilotReviewsSort, type TrustpilotSearchOptions, type TrustpilotStars, type WalmartCategoryOptions, WalmartNamespace, type WalmartOffersOptions, type WalmartProductOptions, type WalmartReviewsOptions, type WalmartSearchOptions, type WalmartSellerOptions, type WalmartSellerProductsOptions, type WalmartStore, type WalmartStoresData, type WalmartStoresOptions, type WalmartStoresResponse, type XCommunityOptions, type XCommunityTweetsOptions, XNamespace, type XSearchCommunitiesOptions, type XSearchOptions, type XTrendingOptions, type XTweetCommentsOptions, type XTweetOptions, type XTweetRetweetersOptions, type XUserFeedOptions, type XUserOptions, type YelpBusinessOptions, YelpNamespace, type YelpReviewsOptions, type YelpSearchOptions, type YouTubeChannelCommunityOptions, type YouTubeChannelOptions, type YouTubeChannelResolveOptions, type YouTubeChannelSearchOptions, type YouTubeChannelShortsOptions, type YouTubeChannelVideosOptions, type YouTubeCommentRepliesOptions, type YouTubeCommentsOptions, type YouTubeCommunityPostCommentsOptions, type YouTubeCommunityPostOptions, type YouTubeMetadataOptions, YouTubeNamespace, type YouTubeRelatedOptions, type YouTubeSearchOptions, type YouTubeShortsOptions, type YouTubeStreamsOptions, type YouTubeSuggestionsOptions, type YouTubeTranscriptOptions, type YouTubeVideoOptions, type ZillowAgentReviewsOptions, ZillowNamespace, type ZillowPropertyOptions, type ZillowSearchOptions, verifyWebhook };