scavio 0.14.0 → 0.15.0

package/dist/index.d.ts

@@ -890,46 +890,146 @@ declare class InstagramNamespace {
 interface WalmartSearchOptions {
     /** Product search query (1-500 characters). */
     query: string;
-    /** Walmart domain. */
-    domain?: string;
-    /** Device to emulate. */
-    device?: "desktop" | "mobile" | "tablet";
-    /** Result sort order. */
-    sort_by?: "best_match" | "price_low" | "price_high" | "best_seller";
-    /** Starting page (1-indexed). */
+    /**
+     * Walmart storefront. Price-bearing: "com" and "ca" cost 1 credit,
+     * "com.mx" costs 2. Defaults to "com".
+     */
+    domain?: "com" | "ca" | "com.mx";
+    /** Result page, 1-indexed. */
+    page?: number;
+    /** @deprecated Alias for `page`. Use `page`. */
     start_page?: number;
-    /** Minimum price filter (USD). */
+    /** Result sort order (default "best_match"). */
+    sort_by?: "best_match" | "price_low" | "price_high" | "best_seller" | "rating_high" | "new";
+    /** Minimum price filter. */
     min_price?: number;
-    /** Maximum price filter (USD). */
+    /** Maximum price filter. */
     max_price?: number;
-    /** Delivery speed filter. */
-    fulfillment_speed?: "today" | "tomorrow" | "2_days" | "anytime";
+    /**
+     * Delivery speed filter. "2_days" is deliberately unsupported (it leaks
+     * 3-4 day items) and there is no "anytime" - omit the param instead.
+     */
+    fulfillment_speed?: "today" | "tomorrow";
     /** Fulfillment type filter. */
     fulfillment_type?: "in_store";
-    /** ZIP code for localized results. */
-    delivery_zip?: string;
-    /** Store id for in-store availability. */
-    store_id?: string;
     [key: string]: unknown;
 }
 interface WalmartProductOptions {
-    /** Walmart product id. */
+    /** Walmart item id (usItemId), e.g. "13544111159". */
     product_id: string;
-    /** Walmart domain. */
-    domain?: string;
-    /** Device to emulate. */
-    device?: "desktop" | "mobile" | "tablet";
-    /** ZIP code for localized pricing. */
-    delivery_zip?: string;
-    /** Store id for in-store availability. */
-    store_id?: string;
+    [key: string]: unknown;
+}
+interface WalmartReviewsOptions {
+    /** Walmart item id (usItemId). */
+    product_id: string;
+    /** Result page, 1-indexed. 10 reviews per page. */
+    page?: number;
+    /** Review sort order. */
+    sort?: "relevancy" | "submission-desc" | "submission-asc" | "rating-desc" | "rating-asc" | "helpful-desc";
+    [key: string]: unknown;
+}
+interface WalmartCategoryOptions {
+    /**
+     * Category id: either a leaf id ("1095191") or a full underscore path
+     * ("3944_133251_1095191").
+     */
+    category_id: string;
+    /**
+     * Walmart storefront. Price-bearing: "com" and "ca" cost 1 credit,
+     * "com.mx" costs 2. Defaults to "com".
+     */
+    domain?: "com" | "ca" | "com.mx";
+    /** Result page, 1-indexed. */
+    page?: number;
+    /** Trims the returned list after fetching. Does NOT reduce the credit cost. */
+    limit?: number;
+    /** Result sort order (default "best_match"). */
+    sort_by?: "best_match" | "price_low" | "price_high" | "best_seller" | "rating_high" | "new";
+    /** Minimum price filter. */
+    min_price?: number;
+    /** Maximum price filter. */
+    max_price?: number;
+    /**
+     * Delivery speed filter. "2_days" is deliberately unsupported (it leaks
+     * 3-4 day items) and there is no "anytime" - omit the param instead.
+     */
+    fulfillment_speed?: "today" | "tomorrow";
+    [key: string]: unknown;
+}
+interface WalmartOffersOptions {
+    /** Walmart item id (usItemId). */
+    product_id: string;
+    [key: string]: unknown;
+}
+interface WalmartSellerOptions {
+    /**
+     * NUMERIC catalog seller id, the `seller_catalog_id` field returned by
+     * product/offers. The GUID form of seller_id returns 404.
+     */
+    seller_id: string;
+    [key: string]: unknown;
+}
+interface WalmartSellerProductsOptions {
+    /**
+     * NUMERIC catalog seller id (`seller_catalog_id`). The GUID form returns 404.
+     */
+    seller_id: string;
     [key: string]: unknown;
 }
 declare class WalmartNamespace {
     private client;
     constructor(client: Scavio);
+    /**
+     * Structured Walmart search results: `products[]`, `products_count` and the
+     * resolved `location`. Page through with `page` (1-indexed).
+     *
+     * Costs 1 credit for `domain` "com" or "ca", 2 credits for "com.mx".
+     */
     search(options: WalmartSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * Full product detail: price, rating, images, specifications, availability
+     * and seller.
+     *
+     * Costs 1 credit. Walmart.ca product pages are not fetchable, so this is
+     * walmart.com only.
+     */
     product(options: WalmartProductOptions): Promise<Record<string, unknown>>;
+    /**
+     * Customer reviews with ratings, text, author, date and the rating
+     * breakdown. 10 reviews per page; advance with `page`.
+     *
+     * Costs 1 credit.
+     */
+    reviews(options: WalmartReviewsOptions): Promise<Record<string, unknown>>;
+    /**
+     * Products within a category, in the same product shape as `search()`.
+     * Page through with `page`; `limit` only trims the response.
+     *
+     * Costs 1 credit for `domain` "com" or "ca", 2 credits for "com.mx".
+     */
+    category(options: WalmartCategoryOptions): Promise<Record<string, unknown>>;
+    /**
+     * Seller offer for a product: price, seller, condition and buy-box flag.
+     * Returns the BUY-BOX SELLER ONLY, not the full offer list.
+     *
+     * Costs 1 credit.
+     */
+    offers(options: WalmartOffersOptions): Promise<Record<string, unknown>>;
+    /**
+     * Marketplace seller storefront: name, rating, review count, Pro Seller
+     * badge and business details.
+     *
+     * Costs 1 credit. `seller_id` must be the numeric catalog seller id.
+     */
+    seller(options: WalmartSellerOptions): Promise<Record<string, unknown>>;
+    /**
+     * A seller's catalog. Roughly the first 40 items are server-rendered and
+     * that is all this returns - there is no pagination. `total_count` reports
+     * the seller's real catalog size, which is usually far larger.
+     *
+     * Costs 1 credit. `seller_id` must be the numeric catalog seller id.
+     */
+    sellerProducts(options: WalmartSellerProductsOptions): Promise<Record<string, unknown>>;
 }
 
 interface YouTubeSearchOptions {
@@ -1298,71 +1398,2805 @@ declare class LinkedInNamespace {
     searchPosts(options: LinkedInSearchPostsOptions): Promise<Record<string, unknown>>;
 }
 
-interface ScavioConfig {
-    apiKey?: string;
-    baseUrl?: string;
-    timeout?: number;
-    maxRequestsPerSecond?: number;
+/** A user reference: the cheap numeric id, or the handle at double the cost. */
+interface ThreadsProfileOptions {
     /**
-     * Additional retry attempts after the first request on transient failures
-     * (HTTP 429/500/502/503/504 and network/timeout errors). Defaults to 2.
-     * Set to 0 to disable retries.
+     * Numeric user id, e.g. "63625256886". The cheap path: 2 credits.
      */
-    maxRetries?: number;
+    user_id?: string;
+    /**
+     * Handle without the leading @ (1-60 characters). Costs 2 extra credits
+     * because the id has to be resolved upstream first - prefer `user_id`.
+     */
+    username?: string;
+    [key: string]: unknown;
 }
-declare class Scavio {
-    readonly google: GoogleNamespace;
-    readonly amazon: AmazonNamespace;
-    readonly walmart: WalmartNamespace;
-    readonly youtube: YouTubeNamespace;
-    readonly reddit: RedditNamespace;
-    readonly tiktok: TikTokNamespace;
-    readonly tiktokShop: TikTokShopNamespace;
-    readonly instagram: InstagramNamespace;
-    readonly x: XNamespace;
-    readonly linkedin: LinkedInNamespace;
-    private readonly apiKey;
-    private readonly baseUrl;
-    private readonly timeout;
-    private readonly maxRetries;
-    private readonly rateLimiter;
-    constructor(config?: ScavioConfig);
-    /** @internal */
-    _post(path: string, body: object): Promise<Record<string, unknown>>;
-    /** @internal */
-    _get(path: string): Promise<Record<string, unknown>>;
-    search(options: GoogleSearchOptions): Promise<Record<string, unknown>>;
-    getUsage(): Promise<Record<string, unknown>>;
+interface ThreadsUserPostsOptions extends ThreadsProfileOptions {
+    /** Opaque cursor from a previous response's next_cursor. */
+    cursor?: string;
+}
+interface ThreadsUserRepliesOptions extends ThreadsProfileOptions {
+    /** Opaque cursor from a previous response's next_cursor. */
+    cursor?: string;
+}
+/** A post reference: the post id, or its threads.net URL. */
+interface ThreadsPostOptions {
+    /** Post id. */
+    post_id?: string;
+    /** Full threads.net post URL, as an alternative to post_id. */
+    url?: string;
+    [key: string]: unknown;
+}
+interface ThreadsPostCommentsOptions {
+    /** Post id. This endpoint takes the id only - no URL, no username. */
+    post_id: string;
+    /** Opaque cursor from a previous response's next_cursor. */
+    cursor?: string;
+    [key: string]: unknown;
+}
+interface ThreadsSearchUsersOptions {
+    /** Name or handle to search for (1-200 characters). */
+    query: string;
+    [key: string]: unknown;
+}
+declare class ThreadsNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Profile details for a Threads user. Pass `user_id` or `username`;
+     * sending neither returns 422 and no match returns 404.
+     *
+     * Costs 2 credits by `user_id`, 4 credits by `username`.
+     */
+    profile(options: ThreadsProfileOptions): Promise<Record<string, unknown>>;
+    /**
+     * A user's Threads posts. Advance with the previous response's
+     * `next_cursor`. Pass `user_id` or `username`.
+     *
+     * Costs 2 credits by `user_id`, 4 credits by `username` - and that surcharge
+     * applies to every page, so resolve the id once before paging.
+     */
+    userPosts(options: ThreadsUserPostsOptions): Promise<Record<string, unknown>>;
+    /**
+     * A user's replies. Advance with the previous response's `next_cursor`.
+     * Pass `user_id` or `username`.
+     *
+     * Costs 2 credits by `user_id`, 4 credits by `username` - and that surcharge
+     * applies to every page, so resolve the id once before paging.
+     */
+    userReplies(options: ThreadsUserRepliesOptions): Promise<Record<string, unknown>>;
+    /**
+     * A single post, addressed by `post_id` or by its threads.net `url`.
+     * Sending neither returns 422.
+     *
+     * Costs 2 credits.
+     */
+    post(options: ThreadsPostOptions): Promise<Record<string, unknown>>;
+    /**
+     * Replies to a post. Advance with the previous response's `next_cursor`.
+     *
+     * Costs 2 credits - this endpoint is never username-keyed, so there is no
+     * handle surcharge.
+     */
+    postComments(options: ThreadsPostCommentsOptions): Promise<Record<string, unknown>>;
+    /**
+     * Threads profiles matching a name or handle. This is people search, and it
+     * is the only search Threads exposes - there is no content/post search.
+     * Use it to turn a handle into the `user_id` every other method prefers.
+     *
+     * Costs 2 credits. Single response, no pagination.
+     */
+    searchUsers(options: ThreadsSearchUsersOptions): Promise<Record<string, unknown>>;
 }
 
-declare class ScavioError extends Error {
-    constructor(message: string);
+interface KuaishouProfileOptions {
+    /** Kuaishou numeric user id, e.g. "5518803932". */
+    user_id: string;
+    [key: string]: unknown;
 }
-declare class MissingAPIKeyError extends ScavioError {
-    constructor();
+interface KuaishouUserPostsOptions {
+    /** Kuaishou numeric user id. */
+    user_id: string;
+    /** Opaque cursor from a previous response's next_cursor. */
+    cursor?: string;
+    [key: string]: unknown;
 }
-/** The request could not reach the API (DNS, connection reset, TLS, ...). */
-declare class ScavioConnectionError extends ScavioError {
-    constructor(message?: string);
+interface KuaishouUserLiveOptions {
+    /** Kuaishou numeric user id. */
+    user_id: string;
+    [key: string]: unknown;
 }
-/** The request did not complete within the configured timeout. */
-declare class ScavioTimeoutError extends ScavioError {
-    constructor(message?: string);
+interface KuaishouUserResolveOptions {
+    /**
+     * A kuaishou.com or v.kuaishou.com link, e.g.
+     * "https://v.kuaishou.com/KcdKDwFp". Kwai international (kwai.com) links
+     * are not supported.
+     */
+    share_link: string;
+    [key: string]: unknown;
 }
-declare class InvalidAPIKeyError extends ScavioError {
-    readonly statusCode = 401;
-    readonly responseBody?: Record<string, unknown>;
-    constructor(message?: string, responseBody?: Record<string, unknown>);
+/** A video reference: the photo id, or a Kuaishou URL. One of the two. */
+interface KuaishouVideoOptions {
+    /** Photo (video) id, e.g. "3xtdqvdnqd3psuc". */
+    photo_id?: string;
+    /** A kuaishou.com or v.kuaishou.com video URL, as an alternative to photo_id. */
+    url?: string;
+    [key: string]: unknown;
 }
-declare class InsufficientCreditsError extends ScavioError {
-    readonly statusCode = 402;
-    readonly responseBody?: Record<string, unknown>;
-    constructor(message?: string, responseBody?: Record<string, unknown>);
+interface KuaishouVideoCommentsOptions {
+    /** Photo (video) id. This endpoint takes the id only - no URL. */
+    photo_id: string;
+    /** Opaque cursor from a previous response's next_cursor. */
+    cursor?: string;
+    [key: string]: unknown;
 }
-declare class BadRequestError extends ScavioError {
-    readonly statusCode = 400;
-    readonly responseBody?: Record<string, unknown>;
-    constructor(message?: string, responseBody?: Record<string, unknown>);
+interface KuaishouCommentRepliesOptions {
+    /** Photo (video) id the root comment sits on. */
+    photo_id: string;
+    /** Id of the root comment whose replies you want. */
+    root_comment_id: string;
+    /** Opaque cursor from a previous response's next_cursor. */
+    cursor?: string;
+    /** Replies per page, 1-50. */
+    count?: number;
+    [key: string]: unknown;
+}
+interface KuaishouVideosBatchOptions {
+    /** Photo (video) ids, 1-20 per call. More than 20 is rejected. */
+    photo_ids: string[];
+    [key: string]: unknown;
+}
+interface KuaishouSearchOptions {
+    /** Search keyword (1-200 characters). */
+    keyword: string;
+    /** Opaque cursor from a previous response's next_cursor. */
+    cursor?: string;
+    [key: string]: unknown;
+}
+interface KuaishouSearchVideosOptions {
+    /** Search keyword (1-200 characters). */
+    keyword: string;
+    /** Opaque cursor from a previous response's next_cursor. */
+    cursor?: string;
+    [key: string]: unknown;
+}
+interface KuaishouSearchUsersOptions {
+    /** Search keyword (1-200 characters). */
+    keyword: string;
+    /** Opaque cursor from a previous response's next_cursor. */
+    cursor?: string;
+    [key: string]: unknown;
+}
+interface KuaishouSearchLiveOptions {
+    /** Search keyword (1-200 characters). */
+    keyword: string;
+    /** Opaque cursor from a previous response's next_cursor. */
+    cursor?: string;
+    [key: string]: unknown;
+}
+interface KuaishouTagFeedOptions {
+    /** Hashtag text, without the leading # (1-200 characters). */
+    tag: string;
+    /** Opaque cursor from a previous response's next_cursor. */
+    cursor?: string;
+    [key: string]: unknown;
+}
+interface KuaishouTrendingOptions {
+    /** Which leaderboard to read (default "hot"). */
+    board?: "hot" | "live" | "shopping" | "brand" | "music";
+    [key: string]: unknown;
+}
+declare class KuaishouNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Profile details for a Kuaishou user, addressed by numeric `user_id`.
+     *
+     * Costs 10 credits - the dearest single-object call on the platform. If you
+     * only have a share link, resolve it with `userResolve()` (1 credit) first.
+     */
+    profile(options: KuaishouProfileOptions): Promise<Record<string, unknown>>;
+    /**
+     * A user's top posts. Advance with the previous response's `next_cursor`.
+     *
+     * Costs 1 credit per page.
+     */
+    userPosts(options: KuaishouUserPostsOptions): Promise<Record<string, unknown>>;
+    /**
+     * A user's current live-stream status.
+     *
+     * Costs 1 credit.
+     */
+    userLive(options: KuaishouUserLiveOptions): Promise<Record<string, unknown>>;
+    /**
+     * Turns a Kuaishou share link into a `user_id` you can feed to the other
+     * user endpoints. kuaishou.com and v.kuaishou.com links only - kwai.com is
+     * not supported.
+     *
+     * Costs 1 credit.
+     */
+    userResolve(options: KuaishouUserResolveOptions): Promise<Record<string, unknown>>;
+    /**
+     * A single video, addressed by `photo_id` or by its Kuaishou `url`.
+     * Sending neither returns 422.
+     *
+     * Costs 2 credits.
+     */
+    video(options: KuaishouVideoOptions): Promise<Record<string, unknown>>;
+    /**
+     * Comments on a video. Advance with the previous response's `next_cursor`.
+     *
+     * Costs 1 credit per page.
+     */
+    videoComments(options: KuaishouVideoCommentsOptions): Promise<Record<string, unknown>>;
+    /**
+     * Replies under a root comment. Advance with the previous response's
+     * `next_cursor`; `count` (1-50) sizes the page.
+     *
+     * Costs 1 credit per page.
+     */
+    commentReplies(options: KuaishouCommentRepliesOptions): Promise<Record<string, unknown>>;
+    /**
+     * Several videos in one call, up to 20 photo ids (a hard cap - a longer
+     * `photo_ids` array is rejected).
+     *
+     * Costs 40 credits per call, flat, whether you send 1 id or 20 - so batch
+     * to the cap. For a single video `video()` costs 2.
+     */
+    videosBatch(options: KuaishouVideosBatchOptions): Promise<Record<string, unknown>>;
+    /**
+     * Mixed-result search across Kuaishou. Advance with the previous response's
+     * `next_cursor`.
+     *
+     * Costs 10 credits per page.
+     */
+    search(options: KuaishouSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * Video search results. Advance with the previous response's `next_cursor`.
+     *
+     * Costs 10 credits per page.
+     */
+    searchVideos(options: KuaishouSearchVideosOptions): Promise<Record<string, unknown>>;
+    /**
+     * User search results. Advance with the previous response's `next_cursor`.
+     *
+     * Costs 10 credits per page.
+     */
+    searchUsers(options: KuaishouSearchUsersOptions): Promise<Record<string, unknown>>;
+    /**
+     * Live-stream search results. Advance with the previous response's
+     * `next_cursor`.
+     *
+     * Costs 10 credits per page.
+     */
+    searchLive(options: KuaishouSearchLiveOptions): Promise<Record<string, unknown>>;
+    /**
+     * Posts under a hashtag. Advance with the previous response's `next_cursor`.
+     *
+     * Costs 1 credit per page - the cheap way to pull volume, versus 10 for
+     * `search()`.
+     */
+    tagFeed(options: KuaishouTagFeedOptions): Promise<Record<string, unknown>>;
+    /**
+     * Leaderboards: hot, live, shopping, brand or music. Defaults to "hot".
+     *
+     * Costs 1 credit.
+     */
+    trending(options?: KuaishouTrendingOptions): Promise<Record<string, unknown>>;
+}
+
+interface EbaySearchOptions {
+    /**
+     * Search keywords (1-500 characters). Optional, but either `query` or
+     * `seller` must be present or the request is rejected.
+     */
+    query?: string;
+    /**
+     * Scope results to one seller's username. Usable with NO `query` to page
+     * that seller's whole catalogue - this, not seller(), is how you enumerate
+     * inventory.
+     */
+    seller?: string;
+    /** Result page, 1-indexed. */
+    page?: number;
+    /** Result sort order (default "best_match"). */
+    sort_by?: "best_match" | "ending_soonest" | "newly_listed" | "price_low" | "price_high";
+    /** Minimum price filter. */
+    min_price?: number;
+    /** Maximum price filter. */
+    max_price?: number;
+    /**
+     * Item condition. "refurbished" is eBay's parent condition, not one of its
+     * three graded tiers.
+     */
+    condition?: "new" | "open_box" | "refurbished" | "used" | "for_parts";
+    /** Listing format filter. */
+    buying_format?: "auction" | "buy_it_now" | "best_offer";
+    /** Free-shipping listings only. */
+    free_shipping?: boolean;
+    /**
+     * Search completed listings that SOLD rather than live inventory.
+     * `total_results` is null on this view - eBay publishes no headline count.
+     */
+    sold?: boolean;
+    /**
+     * eBay category id. Must be numeric: an unrecognised id is not an error,
+     * it silently returns the UNFILTERED set under a 200.
+     */
+    category_id?: string;
+    /**
+     * Results per page. eBay accepts only 60, 120 or 240 and silently falls
+     * back to 60 for anything else. Defaults to 60.
+     */
+    per_page?: 60 | 120 | 240;
+    [key: string]: unknown;
+}
+interface EbayProductOptions {
+    /**
+     * eBay item number, or a full ebay.com/itm/... URL. Tracking params on a
+     * pasted URL are discarded.
+     */
+    item_id: string;
+    [key: string]: unknown;
+}
+interface EbaySellerOptions {
+    /** eBay username as it appears in ebay.com/usr/<name>. */
+    seller: string;
+    [key: string]: unknown;
+}
+declare class EbayNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Structured eBay listing results: price, condition, bids, shipping, seller,
+     * feedback, plus `count` and `total_results`.
+     *
+     * Either `query` or `seller` is required. Set `sold: true` to search
+     * completed listings that actually sold - on that view `total_results` is
+     * always null because eBay publishes no headline count for it.
+     *
+     * Paged with `page`; `per_page` accepts only 60, 120 or 240 and silently
+     * falls back to 60 for any other value.
+     *
+     * Costs 1 credit.
+     */
+    search(options: EbaySearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * One eBay listing in full: price, condition, images, item specifics,
+     * shipping, returns, auction state and seller.
+     *
+     * Costs 1 credit. Single response, no pagination.
+     */
+    product(options: EbayProductOptions): Promise<Record<string, unknown>>;
+    /**
+     * A seller's profile card: store name, feedback score and percentage, items
+     * sold, followers, location and categories.
+     *
+     * PROFILE ONLY - it cannot list what the seller is selling. For inventory,
+     * call search({ seller }) with no query and page through it.
+     *
+     * Costs 1 credit. Single response, no pagination.
+     */
+    seller(options: EbaySellerOptions): Promise<Record<string, unknown>>;
+}
+
+interface TargetSearchOptions {
+    /** Search keywords (1-500 characters). */
+    keyword: string;
+    /** Result page, 1-indexed. */
+    page?: number;
+    /** Results per page, 1-28 (default 24). Target rejects anything above 28. */
+    count?: number;
+    /** Result sort order (default "relevance"). */
+    sort?: "relevance" | "featured" | "price_low" | "price_high" | "rating_high" | "best_seller" | "newest";
+    /** Numeric Target store id used for pricing and availability (default "3991"). */
+    store_id?: string;
+    [key: string]: unknown;
+}
+interface TargetCategoryOptions {
+    /** Category id: the segment after `N-` in a target.com /c/ URL. */
+    category_id: string;
+    /** Result page, 1-indexed. */
+    page?: number;
+    /** Results per page, 1-28 (default 24). Target rejects anything above 28. */
+    count?: number;
+    /** Result sort order (default "relevance"). */
+    sort?: "relevance" | "featured" | "price_low" | "price_high" | "rating_high" | "best_seller" | "newest";
+    /** Numeric Target store id used for pricing and availability (default "3991"). */
+    store_id?: string;
+    [key: string]: unknown;
+}
+interface TargetProductOptions {
+    /**
+     * Target TCIN. A child tcin is answered by its variation parent, with the
+     * child itself present in `variants`.
+     */
+    tcin: string;
+    /** Numeric Target store id used for pricing and availability (default "3991"). */
+    store_id?: string;
+    [key: string]: unknown;
+}
+interface TargetReviewsOptions {
+    /** Target TCIN. */
+    tcin: string;
+    /**
+     * TRIMS the returned bodies only. Target publishes 8 reviews anonymously
+     * and offers no paging, so this cannot reach a 9th review.
+     */
+    limit?: number;
+    /** Numeric Target store id used for pricing and availability (default "3991"). */
+    store_id?: string;
+    [key: string]: unknown;
+}
+declare class TargetNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Search Target.com: prices, ratings, badges and promotions.
+     *
+     * Paged with `page` + `count` (1-28, default 24). `seller_id` and
+     * `seller_name` are null on first-party rows, which means "sold by Target".
+     *
+     * Costs 1 credit. Typically ~9s - it runs through a headless browser.
+     */
+    search(options: TargetSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * Products in a Target category: the same shape as search() plus the
+     * category breadcrumb.
+     *
+     * Paged with `page` + `count` (1-28, default 24).
+     *
+     * Costs 1 credit. The slowest endpoint here at ~37s - set a generous client
+     * timeout before calling it.
+     */
+    category(options: TargetCategoryOptions): Promise<Record<string, unknown>>;
+    /**
+     * Target product details by TCIN: price, rating, images, specifications,
+     * variants, return policy and fulfillment.
+     *
+     * `store_id` is a real request param here - the price and availability you
+     * get back are the store you asked for.
+     *
+     * Costs 1 credit. Typically ~4s. Single response, no pagination.
+     */
+    product(options: TargetProductOptions): Promise<Record<string, unknown>>;
+    /**
+     * Target reviews with the rating breakdown, per-attribute averages and
+     * guest photos.
+     *
+     * Returns 8 review BODIES MAXIMUM regardless of the product's review_count.
+     * `limit` only trims that set; there is no page or offset param, so the
+     * aggregate distribution is the full-population signal here, not the bodies.
+     *
+     * Costs 1 credit. Typically ~40s.
+     */
+    reviews(options: TargetReviewsOptions): Promise<Record<string, unknown>>;
+}
+
+interface HomeDepotSearchOptions {
+    /** Search keywords (1-500 characters). */
+    query: string;
+    /** Result page, 1-indexed. Page size is fixed at 12 products. */
+    page?: number;
+    /**
+     * Result sort order (default "best_match"). Closed set - an unrecognised
+     * value is not ignored, it produces an empty billed page.
+     */
+    sort_by?: "best_match" | "top_sellers" | "top_rated" | "price_low" | "price_high";
+    /** Minimum price filter. */
+    min_price?: number;
+    /** Maximum price filter. */
+    max_price?: number;
+    [key: string]: unknown;
+}
+interface HomeDepotProductOptions {
+    /**
+     * Home Depot item id, or a full homedepot.com/p/... URL. Tracking params on
+     * a pasted URL are discarded.
+     */
+    item_id: string;
+    [key: string]: unknown;
+}
+interface HomeDepotReviewsOptions {
+    /** Home Depot item id. */
+    item_id: string;
+    /**
+     * Result page, 1-indexed. 30 reviews per page. `total_pages` is the last
+     * page that exists - asking past it returns 404.
+     */
+    page?: number;
+    [key: string]: unknown;
+}
+declare class HomeDepotNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Search Home Depot: price and promotions, brand and model, ratings,
+     * badges, and per-store pickup/delivery.
+     *
+     * Page size is FIXED at 12 products and cannot be raised - page through
+     * with `page` to read further.
+     *
+     * Costs 2 credits.
+     */
+    search(options: HomeDepotSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * Full item detail: pricing and promotions, images and videos, the spec
+     * table, dimensions, bullets, documents and return policy.
+     *
+     * Carries only a 10-review PREVIEW - reviews() is the paginated surface.
+     * An unknown item id comes back as 404.
+     *
+     * Costs 2 credits. Single response, no pagination.
+     */
+    product(options: HomeDepotProductOptions): Promise<Record<string, unknown>>;
+    /**
+     * One page of full review bodies with the rating distribution,
+     * per-attribute ratings, photos and seller responses.
+     *
+     * 30 reviews per page. `total_pages` is the last page that exists; a page
+     * beyond it is a 404, not an empty result.
+     *
+     * Costs 2 credits.
+     */
+    reviews(options: HomeDepotReviewsOptions): Promise<Record<string, unknown>>;
+}
+
+interface ZillowSearchOptions {
+    /**
+     * Region to search: a Zillow slug, a human form ("Austin, TX"), a ZIP, or a
+     * pasted Zillow search URL. A bare ZIP works only on its own - combined
+     * with any filter or sort, Zillow geolocates instead and answers about a
+     * different city, so use the city name there.
+     */
+    location: string;
+    /** Which market to read (default "for_sale"). */
+    listing_status?: "for_sale" | "for_rent" | "sold";
+    /** Result page, 1-indexed. */
+    page?: number;
+    /**
+     * Result sort order. Sorts that rank against a signed-in profile
+     * (saved / featured / personalised) are deliberately absent - these
+     * requests are never signed in.
+     */
+    sort?: "relevance" | "recommended" | "newest" | "price_low" | "price_high" | "payment_low" | "payment_high" | "beds" | "baths" | "sqft" | "lot_size" | "zestimate_low" | "zestimate_high" | "recent_change";
+    /**
+     * Minimum price. On listing_status "for_rent" this is MONTHLY RENT, not
+     * sale price.
+     */
+    min_price?: number;
+    /**
+     * Maximum price. On listing_status "for_rent" this is MONTHLY RENT, not
+     * sale price.
+     */
+    max_price?: number;
+    /** Minimum bedrooms. */
+    beds_min?: number;
+    /** Maximum bedrooms. */
+    beds_max?: number;
+    /** Minimum bathrooms. Half-baths allowed (1.5). */
+    baths_min?: number;
+    /** Maximum bathrooms. Half-baths allowed (1.5). */
+    baths_max?: number;
+    /** Minimum living area in square feet. */
+    sqft_min?: number;
+    /** Maximum living area in square feet. */
+    sqft_max?: number;
+    /** Minimum lot size in square feet. */
+    lot_size_min?: number;
+    /** Maximum lot size in square feet. */
+    lot_size_max?: number;
+    /** Earliest year built. */
+    year_built_min?: number;
+    /** Latest year built. */
+    year_built_max?: number;
+    /** Maximum monthly HOA fee. */
+    max_hoa?: number;
+    /** Property type filter. */
+    home_type?: "houses" | "townhomes" | "multi_family" | "condos" | "apartments" | "manufactured" | "lots_land";
+    /**
+     * Listed within: days as "1" | "7" | "14" | "30" | "90", or months as
+     * "6m" | "12m" | "24m" | "36m". Closed enum - an unrecognised value is not
+     * an error, it silently returns the UNFILTERED set under a 200.
+     */
+    days_on_zillow?: "1" | "7" | "14" | "30" | "90" | "6m" | "12m" | "24m" | "36m";
+    /** Keyword filter applied to the listing text (1-200 characters). */
+    keywords?: string;
+    /** Pool only. */
+    has_pool?: boolean;
+    /** Garage only. */
+    has_garage?: boolean;
+    /** Air conditioning only. */
+    has_air_conditioning?: boolean;
+    /** Waterfront only. */
+    is_waterfront?: boolean;
+    /** Basement only. */
+    has_basement?: boolean;
+    /** New construction only. */
+    is_new_construction?: boolean;
+    /** Listings with an open house scheduled. */
+    has_open_house?: boolean;
+    /** Price-reduced listings only. */
+    price_reduced?: boolean;
+    /** Listings with a 3D tour. */
+    is_3d_tour?: boolean;
+    [key: string]: unknown;
+}
+interface ZillowPropertyOptions {
+    /**
+     * A zpid, a /homedetails/ URL, or a zillow.com/apartments/ building URL.
+     * Rental buildings have no caller-visible zpid - search() returns
+     * coordinates in that slot - so pass the /apartments/ URL for those.
+     */
+    zpid: string;
+    [key: string]: unknown;
+}
+interface ZillowAgentReviewsOptions {
+    /**
+     * The agent's zillow.com/profile/<name>/ screen name, or a full profile
+     * URL. Screen names may contain spaces.
+     */
+    screen_name: string;
+    [key: string]: unknown;
+}
+declare class ZillowNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Listings in a region: price, beds, baths, living area, Zestimate,
+     * coordinates, images and days on market.
+     *
+     * Paged with `page`. A bare ZIP works alone but not alongside a filter or a
+     * sort - use the city name when filtering. On listing_status "for_rent",
+     * min_price / max_price are MONTHLY RENT. A region Zillow cannot resolve is
+     * a 404, not an empty list.
+     *
+     * Costs 1 credit.
+     */
+    search(options: ZillowSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * Full listing detail: price and price history, Zestimate, tax history,
+     * description, RESO facts, rooms, schools, open houses, photos and
+     * attribution. Rental buildings return floor plans, amenities and unit
+     * counts instead.
+     *
+     * Costs 1 credit. Single response, no pagination.
+     */
+    property(options: ZillowPropertyOptions): Promise<Record<string, unknown>>;
+    /**
+     * An AGENT's profile and reviews: rating, review count, bodies with
+     * sub-ratings, specialties, languages, licenses, service areas and sales
+     * counts.
+     *
+     * This addresses an agent by screen name, NOT a property. Zillow
+     * server-renders the first five reviews only: `count` is what came back,
+     * `total_review_count` is what the agent actually has, and there is no way
+     * to page to the rest.
+     *
+     * Costs 1 credit.
+     */
+    agentReviews(options: ZillowAgentReviewsOptions): Promise<Record<string, unknown>>;
+}
+
+interface RedfinSearchOptions {
+    /**
+     * A redfin.com region URL (/city/, /neighborhood/, /county/, /zipcode/) or
+     * a bare 5-digit ZIP, up to 500 characters. CITY NAMES ARE NOT ACCEPTED.
+     * Required unless `region_id` AND `region_type` are both given.
+     */
+    location?: string;
+    /**
+     * Redfin's internal region id. NOT a ZIP code - a ZIP here resolves to a
+     * different city instead of failing. Must be paired with `region_type`.
+     */
+    region_id?: number;
+    /**
+     * What `region_id` refers to: 1 neighborhood, 2 ZIP, 5 county, 6 city.
+     * Must be paired with `region_id`.
+     */
+    region_type?: 1 | 2 | 5 | 6;
+    /** Which market to read (default "for_sale"). */
+    listing_status?: "for_sale" | "sold" | "for_rent";
+    /**
+     * Sold-listing lookback in days (default 90). REJECTED unless
+     * `listing_status` is "sold" - it only widens whatever listing_status
+     * already chose.
+     */
+    sold_within_days?: number;
+    /** Result page, 1-indexed. */
+    page?: number;
+    /** Listings per page, 1-350 (default 100). */
+    limit?: number;
+    /** Result sort order (default "recommended"). */
+    sort?: "recommended" | "price_low" | "price_high" | "newest" | "oldest" | "sqft_low" | "sqft_high" | "price_per_sqft_low" | "price_per_sqft_high";
+    /**
+     * Minimum price. On `listing_status: "for_rent"` this is MONTHLY RENT, not
+     * sale price.
+     */
+    min_price?: number;
+    /**
+     * Maximum price. On `listing_status: "for_rent"` this is MONTHLY RENT, not
+     * sale price.
+     */
+    max_price?: number;
+    /** Minimum bedrooms. Whole numbers only. */
+    beds_min?: number;
+    /** Maximum bedrooms. Whole numbers only. */
+    beds_max?: number;
+    /**
+     * Minimum bathrooms. WHOLE baths only - a fractional value such as 1.5 is
+     * rejected, not rounded.
+     */
+    baths_min?: number;
+    /** Minimum living area in square feet. Whole numbers only. */
+    sqft_min?: number;
+    /** Maximum living area in square feet. Whole numbers only. */
+    sqft_max?: number;
+    /** Minimum lot size in square feet. Whole numbers only. */
+    lot_size_min?: number;
+    /** Earliest year built. */
+    year_built_min?: number;
+    /** Latest year built. */
+    year_built_max?: number;
+    /** Maximum monthly HOA fee. */
+    max_hoa?: number;
+    /**
+     * Property class. Redfin's uipt code 7 is deliberately absent - its meaning
+     * could not be confirmed and a guess would silently search a different
+     * class.
+     */
+    property_type?: "house" | "condo" | "townhouse" | "multi_family" | "land" | "other" | "co_op";
+    /** Listings with a pool only. */
+    has_pool?: boolean;
+    /**
+     * Maximum days on market. Cannot be combined with `min_days_on_market` -
+     * Redfin expresses both through ONE param, so the transport would send the
+     * max and drop the min.
+     */
+    max_days_on_market?: number;
+    /**
+     * Minimum days on market. Cannot be combined with `max_days_on_market`.
+     */
+    min_days_on_market?: number;
+    [key: string]: unknown;
+}
+interface RedfinPropertyOptions {
+    /**
+     * A Redfin property id, or any redfin.com listing URL carrying one (up to
+     * 500 characters).
+     */
+    property_id: string;
+    [key: string]: unknown;
+}
+interface RedfinMarketOptions {
+    /**
+     * A redfin.com region URL (/city/, /neighborhood/, /county/, /zipcode/) or
+     * a bare 5-digit ZIP, up to 500 characters. CITY NAMES ARE NOT ACCEPTED.
+     * Required unless `region_id` AND `region_type` are both given.
+     */
+    location?: string;
+    /**
+     * Redfin's internal region id. NOT a ZIP code. Must be paired with
+     * `region_type`.
+     */
+    region_id?: number;
+    /**
+     * What `region_id` refers to: 1 neighborhood, 2 ZIP, 5 county, 6 city.
+     * Must be paired with `region_id`.
+     */
+    region_type?: 1 | 2 | 5 | 6;
+    [key: string]: unknown;
+}
+declare class RedfinNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Redfin listings: price, price per sqft, beds, baths, living area, lot
+     * size, year built, coordinates, listing remarks and full photo galleries.
+     *
+     * Pass `location` (a redfin.com region URL or a bare ZIP - city NAMES are
+     * not accepted) or `region_id` AND `region_type` together. Paged with
+     * `page` + `limit`, up to 350 listings per page.
+     *
+     * `days_on_market` comes back NULL on every row: Redfin's mainHouseInfo has
+     * no `dom` key. Fractional numeric filters are rejected, not rounded.
+     * `sold_within_days` requires `listing_status: "sold"`, and
+     * `max_days_on_market` / `min_days_on_market` cannot be combined.
+     *
+     * Costs 1 credit.
+     */
+    search(options: RedfinSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * One Redfin listing in full: price, Redfin Estimate and rental estimate,
+     * complete MLS fact sheet, price and tax history, listing agents, open
+     * houses, schools, climate risk, walkability and location scores, sun
+     * exposure, monthly weather, permits, zoning, comparable sales and photos.
+     *
+     * Reads the property PAGE, whose inlined request cache replaces the ~40
+     * upstream calls that page made - which is why it is the same price as
+     * search().
+     *
+     * Costs 1 credit. Single response, no pagination.
+     */
+    property(options: RedfinPropertyOptions): Promise<Record<string, unknown>>;
+    /**
+     * Housing-market stats for a region: median list and sale price, price per
+     * sqft, sale-to-list ratio, average offers and days on market, YoY
+     * movement, Redfin's 0-100 compete score, live inventory by property type,
+     * median price and active listings per bedroom count, plus Redfin agent
+     * presence and aggregate rating.
+     *
+     * Pass `location` (city NAMES are not accepted) or `region_id` AND
+     * `region_type` together.
+     *
+     * Costs 1 credit. Single response, no pagination.
+     */
+    market(options: RedfinMarketOptions): Promise<Record<string, unknown>>;
+}
+
+interface BookingSearchOptions {
+    /**
+     * Free-text destination, 1-200 characters ("Paris", "Lisbon, Portugal").
+     * Either `destination` or `dest_id` is required.
+     */
+    destination?: string;
+    /**
+     * Numeric Booking destination id. Either `destination` or `dest_id` is
+     * required.
+     */
+    dest_id?: string;
+    /**
+     * What `dest_id` refers to. Rejected without `dest_id` - Booking silently
+     * ignores it on its own.
+     */
+    dest_type?: "city" | "region" | "country" | "district" | "landmark" | "airport" | "hotel";
+    /** Result page, 1-indexed. 25 properties per page. */
+    page?: number;
+    /** Result sort order (default "popularity"). */
+    sort_by?: "popularity" | "price_low" | "price_high" | "stars_high" | "stars_low" | "stars_and_price" | "distance" | "review_score";
+    /** Minimum price PER NIGHT, in `currency`. Must be <= `max_price`. */
+    min_price?: number;
+    /** Maximum price PER NIGHT, in `currency`. */
+    max_price?: number;
+    /** Star ratings to keep, 1-5 each, up to 5 values. OR'd together. */
+    stars?: number[];
+    /**
+     * Minimum guest review score. A CLOSED set - Booking silently drops an
+     * arbitrary threshold, so only "6", "7", "8" and "9" are accepted.
+     */
+    min_review_score?: "6" | "7" | "8" | "9";
+    /**
+     * Accommodation type by name, or a raw numeric Booking accommodation-type
+     * id.
+     */
+    property_type?: "apartments" | "hostels" | "hotels" | "motels" | "resorts" | "bed_and_breakfasts" | "villas" | "campgrounds" | "vacation_homes" | "lodges" | "homestays" | number;
+    /** Free-cancellation rates only. */
+    free_cancellation?: boolean;
+    /** No-prepayment rates only. */
+    no_prepayment?: boolean;
+    /** Breakfast-included rates only. */
+    breakfast_included?: boolean;
+    /**
+     * Check-in date, YYYY-MM-DD. Must be sent together with `checkout` and
+     * before it.
+     */
+    checkin?: string;
+    /** Check-out date, YYYY-MM-DD. Must be sent together with `checkin`. */
+    checkout?: string;
+    /** Adults in the party (default 2). */
+    adults?: number;
+    /** Child AGES, 0-17 each, up to 10 values. Ages, not a count. */
+    children_ages?: number[];
+    /** Rooms to price (default 1). */
+    rooms?: number;
+    /**
+     * ISO 4217 currency, 3 letters (default "USD"). Leave it set - without a
+     * currency Booking prices off the proxy exit.
+     */
+    currency?: string;
+    [key: string]: unknown;
+}
+interface BookingHotelOptions {
+    /**
+     * booking.com property URL or the bare page slug, 1-500 characters. Query
+     * params are discarded. Chaining the `url` from a search row is cheapest -
+     * a bare slug with the wrong `country_code` is a BILLED 404.
+     */
+    hotel: string;
+    /** Two-letter country code (default "us"). Only consulted for a bare slug. */
+    country_code?: string;
+    /**
+     * Check-in date, YYYY-MM-DD. Must be sent together with `checkout` and
+     * before it. Omitting both prices a two-night window Booking chose.
+     */
+    checkin?: string;
+    /** Check-out date, YYYY-MM-DD. Must be sent together with `checkin`. */
+    checkout?: string;
+    /** Adults in the party (default 2). */
+    adults?: number;
+    /** Child AGES, 0-17 each, up to 10 values. Ages, not a count. */
+    children_ages?: number[];
+    /** Rooms to price (default 1). */
+    rooms?: number;
+    /** ISO 4217 currency, 3 letters (default "USD"). */
+    currency?: string;
+    [key: string]: unknown;
+}
+interface BookingReviewsOptions {
+    /**
+     * booking.com property URL or the bare page slug, 1-500 characters. Query
+     * params are discarded.
+     */
+    hotel: string;
+    /** Two-letter country code (default "us"). Only consulted for a bare slug. */
+    country_code?: string;
+    /**
+     * Check-in date, YYYY-MM-DD. Must be sent together with `checkout` and
+     * before it.
+     */
+    checkin?: string;
+    /** Check-out date, YYYY-MM-DD. Must be sent together with `checkin`. */
+    checkout?: string;
+    /** Adults in the party (default 2). */
+    adults?: number;
+    /** Child AGES, 0-17 each, up to 10 values. Ages, not a count. */
+    children_ages?: number[];
+    /** Rooms to price (default 1). */
+    rooms?: number;
+    /** ISO 4217 currency, 3 letters (default "USD"). */
+    currency?: string;
+    [key: string]: unknown;
+}
+declare class BookingNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Search Booking.com properties for a destination and stay: live nightly
+     * price, review score, star rating, location, room type and deal badges.
+     *
+     * Either `destination` or `dest_id` is required - without one the request
+     * would land on Booking's homepage, so it is rejected instead of billed.
+     * `dest_type` requires `dest_id`.
+     *
+     * Paged with `page`, 25 properties per page. `checkin` and `checkout` must
+     * be sent together or Booking prices a range of its own choosing.
+     *
+     * Each row carries a `url` - chain it into hotel() rather than rebuilding a
+     * slug, which risks a BILLED 404 on the wrong `country_code`.
+     *
+     * Costs 1 credit.
+     */
+    search(options: BookingSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * One Booking.com property in full: rooms and rate plans, facilities, house
+     * rules, check-in windows, policies, images, location and review scores -
+     * priced for the stay you ask for.
+     *
+     * Takes dates because Booking prices a STAY. Omit them and the response
+     * carries prices for a two-night window Booking picked; the response echoes
+     * whichever dates were used.
+     *
+     * Single response, no pagination.
+     *
+     * Costs 1 credit.
+     */
+    hotel(options: BookingHotelOptions): Promise<Record<string, unknown>>;
+    /**
+     * Booking.com guest reviews with the score breakdown by category and
+     * Booking's own praise/complaint summary.
+     *
+     * NO PAGE PARAM - do not invent one. `total_count` is the property's whole
+     * review history; `count` is what this response holds.
+     *
+     * Costs 1 credit.
+     */
+    reviews(options: BookingReviewsOptions): Promise<Record<string, unknown>>;
+}
+
+interface AirbnbSearchOptions {
+    /**
+     * City, region, ZIP, or a pasted airbnb.com/s/ URL, 1-200 characters. A
+     * location Airbnb cannot resolve is a 404, not an empty result.
+     */
+    location: string;
+    /**
+     * Check-in date, YYYY-MM-DD. Must be sent together with `check_out` and
+     * before it. Omitted, the transport defaults to +30 days and the response
+     * sets `dates_are_defaulted`.
+     */
+    check_in?: string;
+    /**
+     * Check-out date, YYYY-MM-DD. Must be sent together with `check_in`.
+     * Omitted, it defaults to `check_in` + 5 nights.
+     */
+    check_out?: string;
+    /** Adults in the party. */
+    adults?: number;
+    /** Children, ages 2-12. */
+    children?: number;
+    /** Infants. */
+    infants?: number;
+    /** Pets. */
+    pets?: number;
+    /**
+     * Minimum price for the WHOLE STAY, not per night. Must be <= `max_price`.
+     */
+    min_price?: number;
+    /** Maximum price for the WHOLE STAY, not per night. */
+    max_price?: number;
+    /** Room type. A closed set - an unrecognised value is rejected up front. */
+    room_type?: "entire_home" | "private_room" | "shared_room" | "hotel_room";
+    /** Minimum bedrooms. */
+    min_bedrooms?: number;
+    /** Minimum beds. */
+    min_beds?: number;
+    /** Minimum bathrooms. */
+    min_bathrooms?: number;
+    /** Superhost listings only. */
+    superhost?: boolean;
+    /** Instant Book listings only. */
+    instant_book?: boolean;
+    /** Guest Favourite listings only. */
+    guest_favorite?: boolean;
+    /** Free-cancellation listings only. */
+    free_cancellation?: boolean;
+    /**
+     * Comma-separated amenity filter, 1-200 characters. Either the named
+     * vocabulary - "wifi", "air_conditioning", "pool", "kitchen",
+     * "free_parking", "washer", "self_check_in", "tv" - or raw numeric Airbnb
+     * amenity ids. An unrecognised NAME is rejected before the scrape, because
+     * Airbnb would otherwise answer the UNFILTERED set under a 200.
+     */
+    amenities?: string;
+    /**
+     * ISO 4217 currency (default "USD"). Leave it set - without a currency
+     * Airbnb prices off the proxy exit.
+     */
+    currency?: string;
+    /**
+     * Result page, 1-indexed. 18 listings per page. Cannot be combined with
+     * `cursor`.
+     */
+    page?: number;
+    /**
+     * `next_cursor` from a previous response, 1-500 characters. Wins over
+     * `page`, so sending both is rejected.
+     */
+    cursor?: string;
+    [key: string]: unknown;
+}
+interface AirbnbListingOptions {
+    /**
+     * Airbnb listing id or a full /rooms/ URL, 1-500 characters. Query params
+     * are discarded - they carry someone else's dates.
+     */
+    listing_id: string;
+    /**
+     * Check-in date, YYYY-MM-DD. Must be sent together with `check_out` and
+     * before it. Dates do NOT produce a price here - the room page has none.
+     */
+    check_in?: string;
+    /** Check-out date, YYYY-MM-DD. Must be sent together with `check_in`. */
+    check_out?: string;
+    /** Adults in the party. */
+    adults?: number;
+    /** Children, ages 2-12. */
+    children?: number;
+    /** Infants. */
+    infants?: number;
+    /** Pets. */
+    pets?: number;
+    /** ISO 4217 currency (default "USD"). */
+    currency?: string;
+    [key: string]: unknown;
+}
+interface AirbnbReviewsOptions {
+    /** Airbnb listing id or a full /rooms/ URL, 1-500 characters. */
+    listing_id: string;
+    /** ISO 4217 currency (default "USD"). */
+    currency?: string;
+    /**
+     * Reviews per response, 1-50 (default 30). Send it explicitly - upstream
+     * falls back to a fixed 7 rows when no limit is given.
+     */
+    limit?: number;
+    /** Row offset into the review list (default 0). */
+    offset?: number;
+    [key: string]: unknown;
+}
+declare class AirbnbNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Search Airbnb stays: stay-total and per-night price with the full
+     * discount ledger, rating and review count, bedrooms/beds/baths,
+     * coordinates, badges, images and `dates_are_defaulted`.
+     *
+     * This is the ONLY endpoint that carries a price - listing() has no nightly
+     * rate field at all.
+     *
+     * Paged with `page` (18 listings per page) XOR `cursor`; `cursor` wins, so
+     * sending both is rejected. `min_price` / `max_price` are WHOLE-STAY totals,
+     * not per night.
+     *
+     * Pass `check_in` + `check_out` together whenever price matters: a dateless
+     * search defaults to +30 days / 5 nights and A/Bs both the window and the
+     * prices, which the response flags as `dates_are_defaulted`.
+     *
+     * Costs 1 credit.
+     */
+    search(options: AirbnbSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * One Airbnb listing in full: description, property and room type, capacity
+     * and room counts, the complete grouped amenity list (including the
+     * amenities the place does NOT have), host profile and stats, house rules
+     * with parsed check-in/out times, cancellation policy, sleeping
+     * arrangements, photo tour, every image, and the RATING BREAKDOWN - six
+     * category ratings, the five-bucket star distribution and Airbnb's
+     * AI-synthesised review tags.
+     *
+     * NO NIGHTLY PRICE. The room page carries no rate under any parameters,
+     * with or without dates. Prices come from search() only.
+     *
+     * Single response, no pagination.
+     *
+     * Costs 1 credit.
+     */
+    listing(options: AirbnbListingOptions): Promise<Record<string, unknown>>;
+    /**
+     * Airbnb review BODIES with per-review rating, date, and reviewer name,
+     * photo and location.
+     *
+     * Paged with `limit` (1-50, default 30) + `offset`. Send `limit`
+     * explicitly - upstream returns a fixed 7 rows when none is given.
+     *
+     * `count` is the listing's TOTAL review count; `returned` is how many rows
+     * this page holds. The rating breakdown is NOT here - it lives on
+     * listing().
+     *
+     * Costs 1 credit.
+     */
+    reviews(options: AirbnbReviewsOptions): Promise<Record<string, unknown>>;
+}
+
+interface TripadvisorLocationsOptions {
+    /** Place or business NAME to resolve, 1-120 characters. */
+    query: string;
+    /**
+     * How many matches to return, 1-20 (default 12). This only SIZES the
+     * response - it is not a page param.
+     */
+    limit?: number;
+    [key: string]: unknown;
+}
+interface TripadvisorSearchOptions {
+    /**
+     * Tripadvisor geo id. Accepts 30196, g30196, or a URL carrying one. Either
+     * `geo_id` or `url` is required.
+     */
+    geo_id?: string;
+    /** Which listing family to read (default "restaurants"). */
+    category?: "restaurants" | "hotels" | "attractions";
+    /**
+     * Result page, 1-indexed. 30 locations per page; a page beyond the last is
+     * a 404, not an empty result.
+     */
+    page?: number;
+    /**
+     * Full tripadvisor.com listing URL, 1-500 characters. The host is checked by
+     * the transport (subdomain-aware, covers country sites). Either `geo_id` or
+     * `url` is required.
+     */
+    url?: string;
+    [key: string]: unknown;
+}
+interface TripadvisorLocationOptions {
+    /**
+     * Tripadvisor location id. Accepts 1899234, d1899234, or a full _Review
+     * URL. Either `location_id` or `url` is required.
+     */
+    location_id?: string;
+    /**
+     * Tripadvisor geo id. Required by the transport when a bare d-id is sent -
+     * the pair comes straight off a locations() business row.
+     */
+    geo_id?: string;
+    /** Which listing family the location belongs to (default "restaurants"). */
+    category?: "restaurants" | "hotels" | "attractions";
+    /**
+     * Full tripadvisor.com listing URL, 1-500 characters. Either `location_id`
+     * or `url` is required.
+     */
+    url?: string;
+    [key: string]: unknown;
+}
+interface TripadvisorReviewsOptions {
+    /**
+     * Tripadvisor location id. Accepts 1899234, d1899234, or a full _Review
+     * URL. Either `location_id` or `url` is required.
+     */
+    location_id?: string;
+    /** Tripadvisor geo id for the location. */
+    geo_id?: string;
+    /**
+     * Which listing family the location belongs to (default "restaurants").
+     * Page size follows this, so it must match the location's own type on any
+     * page past the first.
+     */
+    category?: "restaurants" | "hotels" | "attractions";
+    /**
+     * Full tripadvisor.com listing URL, 1-500 characters. Either `location_id`
+     * or `url` is required.
+     */
+    url?: string;
+    /**
+     * Result page, 1-indexed. 15 per page for restaurants, 10 for hotels and
+     * attractions. Past the last page is a 404.
+     */
+    page?: number;
+    [key: string]: unknown;
+}
+declare class TripadvisorNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * START HERE. Resolve a place or business NAME to the Tripadvisor
+     * geo_id / location_id pairs every other endpoint needs.
+     *
+     * A GEO row answers `geo_id` for search(); a business row answers the
+     * `geo_id` + `location_id` pair location() and reviews() take. Those ids
+     * exist only inside Tripadvisor's own URLs, so this is the only entry point
+     * from a name.
+     *
+     * `limit` (1-20, default 12) sizes the response; there is no pagination.
+     *
+     * Costs 2 credits.
+     */
+    locations(options: TripadvisorLocationsOptions): Promise<Record<string, unknown>>;
+    /**
+     * Restaurants, hotels or attractions in a Tripadvisor geo, Tripadvisor-
+     * ranked: rating, review count, price band, address, coordinates, phone,
+     * hours and Travelers' Choice badge. Each row carries the location_id +
+     * geo_id pair the detail endpoints take.
+     *
+     * `geo_id` or `url` is required - get `geo_id` from locations().
+     *
+     * Paged with `page`, 30 locations per page. A page beyond the last is a
+     * 404, not an empty result.
+     *
+     * Costs 2 credits.
+     */
+    search(options: TripadvisorSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * One Tripadvisor location in full: rating, review histogram and per-aspect
+     * sub-ratings, city ranking, price band, cuisines, amenities, address,
+     * coordinates, contact, photos, and the FIRST PAGE OF REVIEWS.
+     *
+     * `location_id` or `url` is required, and the transport additionally
+     * requires a geo when a bare d-id is sent.
+     *
+     * Page 1 of the reviews is already here - call reviews() only to page PAST
+     * it. An unknown location id is a 404 (upstream answers a billed city
+     * listing that the transport restates).
+     *
+     * Costs 2 credits.
+     */
+    location(options: TripadvisorLocationOptions): Promise<Record<string, unknown>>;
+    /**
+     * A page of Tripadvisor reviews: rating, trip date and type, reviewer home
+     * town and contribution count, and any management response.
+     *
+     * `location_id` or `url` is required. Page size follows `category` - 15 per
+     * page for restaurants, 10 for hotels and attractions - so keep it matched
+     * to the location's own type on any page past the first.
+     *
+     * Consecutive pages can REPEAT one review at the boundary; de-duplicate on
+     * review_id when concatenating.
+     *
+     * Costs 2 credits.
+     */
+    reviews(options: TripadvisorReviewsOptions): Promise<Record<string, unknown>>;
+}
+
+interface YelpSearchOptions {
+    /**
+     * What to search for (1-200 characters), e.g. "coffee". Required together
+     * with `location` unless `url` is given.
+     */
+    term?: string;
+    /**
+     * Where to search (1-200 characters), e.g. "Austin, TX". Effectively
+     * REQUIRED - without it Yelp geolocates off the proxy exit and the same
+     * request answers about a different metro run to run.
+     */
+    location?: string;
+    /** Result page, 1-indexed. Yelp fixes the page size at 10. */
+    page?: number;
+    /**
+     * Result sort order (default "recommended"). Closed set - Yelp ignores an
+     * unrecognised value and serves default ranking under a billed 200.
+     */
+    sort?: "recommended" | "rating" | "review_count";
+    /** Price bands to include, 1 ($) to 4 ($$$$). 1-4 entries. */
+    price?: Array<1 | 2 | 3 | 4>;
+    /** Businesses open at request time only. */
+    open_now?: boolean;
+    /**
+     * Raw Yelp filter aliases (RestaurantsDelivery, GoodForKids,
+     * WheelchairAccessible), max 20. Deliberate PASSTHROUGH, not an enum -
+     * Yelp's vocabulary runs ~117 values per vertical, and an alias it does not
+     * know is ignored upstream so results come back unfiltered.
+     */
+    attributes?: string[];
+    /**
+     * A full yelp.com/search URL as an alternative to term + location
+     * (1-1000 characters).
+     */
+    url?: string;
+    [key: string]: unknown;
+}
+interface YelpBusinessOptions {
+    /**
+     * Yelp alias (desnudo-coffee-austin-2), opaque encid, or a yelp.com/biz URL
+     * (1-500 characters). Either this or `url` is required.
+     */
+    business_id?: string;
+    /** A yelp.com/biz URL (1-1000 characters). Either this or `business_id` is required. */
+    url?: string;
+    [key: string]: unknown;
+}
+interface YelpReviewsOptions {
+    /**
+     * Yelp alias, opaque encid, or a yelp.com/biz URL (1-500 characters).
+     * Either this or `url` is required.
+     */
+    business_id?: string;
+    /** A yelp.com/biz URL (1-1000 characters). Either this or `business_id` is required. */
+    url?: string;
+    /**
+     * Result page, 1-indexed, 10 reviews per page. PAGE 1 IS REDUNDANT with
+     * business() and costs another 2 credits - start at page 2. A page past the
+     * last review is a 404, not an empty result.
+     */
+    page?: number;
+    /**
+     * Review sort order (default "relevance"). Closed set - an unrecognised
+     * value is served as default ranking under a billed 200.
+     */
+    sort?: "relevance" | "newest" | "oldest" | "rating_high" | "rating_low" | "elites";
+    /** Keep only reviews at this star rating. Changes filtered_review_count, not review_count. */
+    rating?: 1 | 2 | 3 | 4 | 5;
+    [key: string]: unknown;
+}
+declare class YelpNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Businesses in Yelp's ranked order: rating, review count, price band,
+     * categories, address, contact rails, hours, photos and a review snippet.
+     * Each row carries both business_id and alias, either of which addresses
+     * business(). `count` is the 10-row page, `total_results` is Yelp's headline
+     * count.
+     *
+     * `term` + `location` or `url` is required, and `location` is effectively
+     * mandatory - Yelp geolocates a location-less search off the proxy exit.
+     * Paged with `page`; the page size is fixed at 10.
+     *
+     * Costs 2 credits.
+     */
+    search(options: YelpSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * One business in full: rating and per-star histogram, review count, price
+     * band, categories, address and coordinates, phone, website and menu links,
+     * hours and holidays, amenities, photos and videos, popular items, health
+     * inspections, Q&A, licences and claim status - PLUS the first page of
+     * reviews at no extra cost.
+     *
+     * Because those reviews ride along, calling reviews({ page: 1 }) after this
+     * buys the same document twice. Yelp's recommendation software hides some
+     * reviews entirely; those are never returned and are counted in
+     * not_recommended_review_count here. popular_items rows can arrive as stub
+     * shells with every field null but `identifier` - those are dropped and
+     * popular_items_omitted flags it.
+     *
+     * `business_id` or `url` is required. Costs 2 credits. Single response, no
+     * pagination.
+     */
+    business(options: YelpBusinessOptions): Promise<Record<string, unknown>>;
+    /**
+     * A page of reviews: rating, full text, language, author profile and
+     * expertise counts, attached photos, reaction counts and owner response.
+     *
+     * START AT PAGE 2 - page 1 re-fetches the document business() already
+     * returned and costs another 2 credits. 10 reviews per page, and a page past
+     * the last review is a 404, not an empty result. `rating` changes
+     * filtered_review_count, not review_count.
+     *
+     * `business_id` or `url` is required. Costs 2 credits.
+     */
+    reviews(options: YelpReviewsOptions): Promise<Record<string, unknown>>;
+}
+
+interface IndeedSearchOptions {
+    /**
+     * Search keywords, 1-500 characters. Optional: either `query` or `location`
+     * must be present.
+     */
+    query?: string;
+    /**
+     * City+state, postal code, state, country or "Remote", 1-200 characters.
+     * Usable with NO `query` at all - that returns every posting in the metro.
+     */
+    location?: string;
+    /** Result page, 1-indexed. 10 postings per page. */
+    page?: number;
+    /**
+     * Search radius in miles. A CLOSED set (upstream default 50) - Indeed
+     * ignores anything else and bills a wider search than you asked for.
+     */
+    radius?: 0 | 5 | 10 | 15 | 25 | 35 | 50 | 100;
+    /**
+     * Maximum posting age in days. A CLOSED set - Indeed ignores anything else
+     * and returns the unfiltered set.
+     */
+    max_age_days?: 1 | 3 | 7 | 14;
+    /** Employment type filter. */
+    job_type?: "full_time" | "part_time" | "contract" | "temporary" | "internship";
+    /**
+     * Minimum salary. Filters on INDEED'S OWN ESTIMATE for the role, not a
+     * posted figure, so postings publishing no salary still match.
+     */
+    min_salary?: number;
+    /** Remote postings only. */
+    remote?: boolean;
+    [key: string]: unknown;
+}
+interface IndeedJobOptions {
+    /**
+     * 16-hex Indeed job key, or any indeed.com URL carrying jk= (/viewjob,
+     * /rc/clk, /pagead/clk).
+     */
+    job_id: string;
+    [key: string]: unknown;
+}
+interface IndeedCompanyOptions {
+    /**
+     * indeed.com/cmp/<slug> slug or a full profile URL, 1-200 characters. Slugs
+     * are untidy - e.g. "Tata-Consultancy-Services-(tcs)".
+     */
+    company: string;
+    [key: string]: unknown;
+}
+interface IndeedCompanyReviewsOptions {
+    /**
+     * indeed.com/cmp/<slug> slug or a full profile URL, 1-200 characters.
+     */
+    company: string;
+    /** Result page, 1-indexed. 20 reviews per page. */
+    page?: number;
+    [key: string]: unknown;
+}
+declare class IndeedNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Search Indeed job postings: title, employer, rating, location, salary
+     * range, job type, benefits, posting age and apply route.
+     *
+     * Either `query` or `location` is required; a location-only search is valid
+     * and returns every posting in the metro.
+     *
+     * Paged with `page`, 10 postings per page. `radius` and `max_age_days` are
+     * closed sets - Indeed silently ignores an off-list value and bills the
+     * unfiltered search. `min_salary` filters on Indeed's own ESTIMATE for the
+     * role, not a posted figure.
+     *
+     * Costs 2 credits.
+     */
+    search(options: IndeedSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * One Indeed posting in full: description text and HTML, structured salary,
+     * employment types, benefits, geocoded address, employer rating, applicant
+     * count and the original ATS link.
+     *
+     * Single response, no pagination. An unknown job key is a real 404 that
+     * scrape.do BILLS - take `job_id` from a search row.
+     *
+     * Costs 2 credits.
+     */
+    job(options: IndeedJobOptions): Promise<Record<string, unknown>>;
+    /**
+     * Indeed employer profile: description, industry, HQ, size, revenue, CEO
+     * approval, overall and per-category ratings, reported salaries, open roles
+     * and locations.
+     *
+     * Single response, no pagination. An unknown company slug is a real 404
+     * that scrape.do BILLS.
+     *
+     * Costs 2 credits.
+     */
+    company(options: IndeedCompanyOptions): Promise<Record<string, unknown>>;
+    /**
+     * Indeed employee reviews with per-category ratings, pros/cons, reviewer
+     * job title and location, plus aggregated sentiment and topic / location /
+     * job-title breakdowns.
+     *
+     * Paged with `page`, 20 reviews per page.
+     *
+     * Costs 2 credits.
+     */
+    companyReviews(options: IndeedCompanyReviewsOptions): Promise<Record<string, unknown>>;
+}
+
+interface GlassdoorCompaniesOptions {
+    /** Company name to resolve (1-120 characters). */
+    query: string;
+    [key: string]: unknown;
+}
+interface GlassdoorCompanyOptions {
+    /**
+     * Glassdoor employer id. MUST BE A STRING - a JSON number is rejected.
+     * Accepts 1699, E1699 or IE1699. Either this or `url` is required.
+     */
+    employer_id?: string;
+    /**
+     * Company name (1-200 characters). COSMETIC ONLY: the profile resolves on
+     * employer_id alone, this is ignored entirely when `url` is set, and it does
+     * NOT satisfy the employer_id-or-url requirement.
+     */
+    company?: string;
+    /**
+     * Any glassdoor.com employer URL (/Overview/, /Reviews/ or /Salary/).
+     * Non-glassdoor.com hosts are rejected. Either this or `employer_id` is
+     * required.
+     */
+    url?: string;
+    [key: string]: unknown;
+}
+interface GlassdoorReviewsOptions {
+    /**
+     * Glassdoor employer id as a STRING (1699, E1699 or IE1699). Either this or
+     * `url` is required. Addressing by employer_id costs two upstream fetches -
+     * pass reviews_url from company() as `url` instead.
+     */
+    employer_id?: string;
+    /** Company name (1-200 characters). Cosmetic; does not satisfy the identifier requirement. */
+    company?: string;
+    /**
+     * Pass back the reviews_url that company() returned to skip the resolve
+     * fetch. Either this or `employer_id` is required.
+     */
+    url?: string;
+    /**
+     * Restrict to reviews about one axis. Closed set - Glassdoor ignores an
+     * unknown value and returns the UNFILTERED set under a 200.
+     */
+    category?: "career_development" | "compensation" | "culture" | "diversity_and_inclusion" | "management" | "work_life_balance";
+    /**
+     * Restrict to reviewers of one employment type. Closed set - an unknown
+     * value is silently unfiltered. FREELANCE is absent because it was never
+     * confirmed to change the result set.
+     */
+    employment_status?: "full_time" | "part_time" | "contract" | "intern";
+    [key: string]: unknown;
+}
+interface GlassdoorSalariesOptions {
+    /**
+     * Glassdoor employer id as a STRING (1699, E1699 or IE1699). Either this or
+     * `url` is required. Addressing by employer_id costs two upstream fetches -
+     * pass salaries_url from company() as `url` instead.
+     */
+    employer_id?: string;
+    /** Company name (1-200 characters). Cosmetic; does not satisfy the identifier requirement. */
+    company?: string;
+    /**
+     * Pass back the salaries_url that company() returned to skip the resolve
+     * fetch. Either this or `employer_id` is required.
+     */
+    url?: string;
+    /**
+     * Result page, 1-indexed. 10 job titles per page; `page_count` on the
+     * response is how many pages exist.
+     */
+    page?: number;
+    [key: string]: unknown;
+}
+declare class GlassdoorNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * START HERE. Search Glassdoor for a company by NAME and resolve it to the
+     * employer_id every other method needs, ranked by Glassdoor and
+     * de-duplicated.
+     *
+     * company(), reviews() and salaries() all key off an employer_id that exists
+     * only inside Glassdoor's /Overview/ URLs, so this lookup is the entry
+     * point.
+     *
+     * Costs 1 credit. Single response, no pagination.
+     */
+    companies(options: GlassdoorCompaniesOptions): Promise<Record<string, unknown>>;
+    /**
+     * Employer profile: description, mission, industry, sector, HQ, size band,
+     * revenue band, stock symbol, year founded, overall and per-category
+     * ratings, star distribution, CEO approval, awards, FAQ, the five
+     * server-rendered reviews, AND reviews_url / salaries_url.
+     *
+     * THE CHAINING ENDPOINT: pass reviews_url / salaries_url back as `url` on
+     * reviews() and salaries() to halve the upstream fetches. `employer_id` or
+     * `url` is required - `company` is cosmetic and does not satisfy it.
+     *
+     * Costs 1 credit. Single response, no pagination. Typically ~3-47s.
+     */
+    company(options: GlassdoorCompanyOptions): Promise<Record<string, unknown>>;
+    /**
+     * Full reviews with per-axis scores, pros, cons, advice, job title,
+     * location, employment status and employer response - plus complete rating
+     * statistics, star distribution, aggregate pro/con highlight terms and
+     * per-job-title review counts.
+     *
+     * HARD CAP OF THREE REVIEW BODIES per response: that is Glassdoor's login
+     * wall, not a limit option. There is deliberately NO `page` param. Move the
+     * window with `category` and `employment_status` and read
+     * filtered_review_count to see how many match; the aggregate statistics are
+     * the full-population signal here, not the bodies.
+     *
+     * `employer_id` or `url` is required. Costs 1 credit. Typically ~75s.
+     */
+    reviews(options: GlassdoorReviewsOptions): Promise<Record<string, unknown>>;
+    /**
+     * Salaries by job title: base-pay and total-pay percentiles P10-P90 with
+     * medians called out, sample counts, currency, pay period and last-reported
+     * date.
+     *
+     * These are Glassdoor's ESTIMATES for the title, not individual reported
+     * salaries. Paged with `page` at 10 job titles per page; `page_count` on the
+     * response is how many pages exist.
+     *
+     * `employer_id` or `url` is required. Costs 1 credit. Typically ~41s.
+     */
+    salaries(options: GlassdoorSalariesOptions): Promise<Record<string, unknown>>;
+}
+
+interface AppStoreSearchOptions {
+    /**
+     * Search term (1-500 characters). Matches app name, keyword OR publisher
+     * name - searching a developer returns their catalogue.
+     */
+    term: string;
+    /**
+     * Number of apps to return, 1-200 (default 25). THE ONLY LEVER on result
+     * volume: there is no pagination and every offset spelling is ignored.
+     */
+    limit?: number;
+    /**
+     * Two-letter storefront code (default "us"). Decides price, currency,
+     * localised title and whether the app is sold there at all. Anything that is
+     * not exactly two letters falls back to US.
+     */
+    country?: string;
+    /** Which catalogue to search (default "software", i.e. iPhone apps). */
+    entity?: "software" | "ipad_software" | "mac_software";
+    /**
+     * Five-letter locale for the returned text, e.g. "en_us". Independent of
+     * `country`: the storefront sets the price, this sets the words.
+     */
+    lang?: string;
+    [key: string]: unknown;
+}
+interface AppStoreAppOptions {
+    /**
+     * App Store id OR bundle id (notion.id, com.burbn.instagram), auto-detected
+     * and returning an identical payload. 1-255 characters matching
+     * ^[A-Za-z0-9][A-Za-z0-9._-]*$ - a pasted apps.apple.com URL is rejected
+     * with a free 400.
+     */
+    app_id: string;
+    /**
+     * Two-letter storefront code (default "us"). Decides price, currency,
+     * localised title and availability. Anything not exactly two letters falls
+     * back to US.
+     */
+    country?: string;
+    [key: string]: unknown;
+}
+interface AppStoreReviewsOptions {
+    /**
+     * NUMERIC App Store id only - the reviews RSS feed has no bundle-id form,
+     * unlike app().
+     */
+    app_id: string;
+    /**
+     * Two-letter storefront code (default "us"). Each storefront has its own
+     * 500-review ceiling, so a different country is how you read past page 10.
+     */
+    country?: string;
+    /**
+     * Result page, 1-10 (default 1), 50 reviews each. HARD STOP AT PAGE 10 -
+     * 500 reviews per storefront is Apple's anonymous ceiling.
+     */
+    page?: number;
+    /**
+     * Review sort order (default "most_recent"). Under "most_recent" almost
+     * every review is too new to have been voted on and the vote fields come
+     * back as ZEROES; "most_helpful" returns them densely populated.
+     */
+    sort?: "most_recent" | "most_helpful";
+    [key: string]: unknown;
+}
+declare class AppStoreNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Up to 200 fully-shaped App Store apps - the same 43-field row as app() -
+     * which makes this a bulk metadata fetch as well as a search, and a
+     * publisher lookup when the term is a developer name.
+     *
+     * NO PAGINATION. `limit` (1-200, default 25) is the only lever on volume;
+     * every offset spelling is silently ignored. Mac rows carry no iPad or Apple
+     * TV screenshots, advisories, features, supported devices or Game Center
+     * flag.
+     *
+     * Costs 1 credit.
+     */
+    search(options: AppStoreSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * Full listing: title, description, developer and seller identity, price and
+     * currency, all-time and current-version ratings, version and release notes,
+     * genres, content rating and advisories, icons at three sizes, screenshots,
+     * download size, minimum OS, languages, supported devices, Game Center and
+     * VPP flags.
+     *
+     * Takes a numeric App Store id or a bundle id interchangeably. An id Apple
+     * cannot resolve is a BILLED 404 - Apple charges for the empty result list.
+     *
+     * Costs 1 credit. Single response, no pagination.
+     */
+    app(options: AppStoreAppOptions): Promise<Record<string, unknown>>;
+    /**
+     * A page of reviews: star rating, title, full text, author, and the APP
+     * VERSION the review was written against.
+     *
+     * NUMERIC APP IDS ONLY here. Paged 1-10 at 50 reviews each and hard-stopped
+     * at page 10 - 500 reviews per storefront is Apple's anonymous ceiling, so
+     * ask a different `country` to reach further. This endpoint CANNOT 404: an
+     * unknown id and a real app with zero reviews return the same empty feed.
+     * Under sort "most_recent" the vote fields are zeroes.
+     *
+     * Costs 1 credit.
+     */
+    reviews(options: AppStoreReviewsOptions): Promise<Record<string, unknown>>;
+}
+
+interface GooglePlaySearchOptions {
+    /** Search query (1-200 characters). */
+    query: string;
+    /**
+     * Interface language (2-20 characters, default "en"). Changes the
+     * STOREFRONT, not only the strings - title, description, install formatting
+     * and content rating all move with it. Play falls back to English on values
+     * it does not serve.
+     */
+    hl?: string;
+    /** Country code (2-10 characters, default "us"). */
+    gl?: string;
+    [key: string]: unknown;
+}
+interface GooglePlayAppOptions {
+    /**
+     * Android package name (com.spotify.music) or any play.google.com URL
+     * carrying one in its id param. 1-500 characters.
+     */
+    app_id: string;
+    /**
+     * Interface language (2-20 characters, default "en"). Changes the storefront
+     * as well as the strings.
+     */
+    hl?: string;
+    /** Country code (2-10 characters, default "us"). */
+    gl?: string;
+    [key: string]: unknown;
+}
+interface GooglePlayReviewsOptions {
+    /**
+     * Android package name or any play.google.com URL carrying one in its id
+     * param. 1-500 characters.
+     */
+    app_id: string;
+    /**
+     * Review sort order (default "newest"). The cursor encodes this value, so
+     * changing `sort` mid-pagination invalidates the cursor.
+     */
+    sort?: "relevance" | "newest" | "rating";
+    /**
+     * Reviews per page, 1-200 (default 50). Capped at 200 on our side; Play
+     * honours more, but a single page that large is megabytes for one call.
+     */
+    count?: number;
+    /**
+     * next_cursor from a prior response (1-4000 characters). OPAQUE and
+     * SINGLE-USE, and it encodes the sort as well as the position - send it back
+     * with the SAME `sort` it came from. A cursor past the last review is a 404,
+     * not an empty page.
+     */
+    cursor?: string;
+    /** Interface language (2-20 characters, default "en"). */
+    hl?: string;
+    /** Country code (2-10 characters, default "us"). */
+    gl?: string;
+    [key: string]: unknown;
+}
+declare class GooglePlayNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Ranked apps: package name, title, developer, rating, install count, price
+     * and IAP range, content rating, icon and screenshots. A branded query
+     * returns the hero card as result 1 projected to the same row shape, plus
+     * Play's related-query rail.
+     *
+     * NO PAGINATION - one shelf of ~30 apps, with no page or cursor param.
+     * `hl` moves the whole storefront, not just the language of the strings.
+     *
+     * Costs 2 credits.
+     */
+    search(options: GooglePlaySearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * Full store listing: installs including the REAL count Play publishes but
+     * never renders, rating and star histogram, description, developer identity
+     * and legal contact, price and IAPs, categories and gameplay tags,
+     * screenshots and trailer, version and Android requirement, release and
+     * update dates, changelog, full permission tree, Data safety table, the 20
+     * server-rendered reviews, and the similar-apps and more-by-developer rails.
+     *
+     * Those 20 reviews ride along at no extra cost - use reviews() only to page
+     * past them or to sort differently.
+     *
+     * Costs 2 credits. Single response, no pagination.
+     */
+    app(options: GooglePlayAppOptions): Promise<Record<string, unknown>>;
+    /**
+     * A page of reviews: star score, full text, author, thumbs-up count,
+     * developer reply, and the APP VERSION the reviewer was running.
+     *
+     * Paged with `cursor` -> next_cursor. The cursor is opaque and SINGLE-USE
+     * and encodes the sort as well as the position, so send it back with the
+     * same `sort` it came from; a cursor past the last review is a 404, not an
+     * empty page. `count` is capped at 200. An empty payload here is a BILLED
+     * 404 - the premium price is paid to learn the package has no reviews or
+     * does not exist.
+     *
+     * Costs 2 credits.
+     */
+    reviews(options: GooglePlayReviewsOptions): Promise<Record<string, unknown>>;
+}
+
+interface G2SearchOptions {
+    /** Search term (1-200 characters). Required unless `url` is given. */
+    query?: string;
+    /** Result page, 1-indexed. 20 per page unless `limit` says otherwise. */
+    page?: number;
+    /**
+     * Results per page (1-100, default 20). Capped at 100 on our side so a
+     * single request cannot ask for a multi-megabyte page on a 60s deadline;
+     * G2 itself keeps paginating at any size.
+     */
+    limit?: number;
+    /** Result sort order (default "relevance"). */
+    sort?: "relevance" | "popular" | "alphabetical" | "rating";
+    /** Products at or above this star rating. */
+    rating?: 1 | 2 | 3 | 4 | 5;
+    /**
+     * Full g2.com/search URL, as an alternative to `query`. The host is checked
+     * by the transport.
+     */
+    url?: string;
+    [key: string]: unknown;
+}
+interface G2ProductOptions {
+    /**
+     * A G2 slug ("notion") or the numeric G2 id ("82623") AS A STRING - both
+     * resolve on the same upstream path. Required unless `url` is given.
+     */
+    product_id?: string;
+    /** Full g2.com product URL, as an alternative to `product_id`. */
+    url?: string;
+    [key: string]: unknown;
+}
+interface G2ReviewsOptions {
+    /**
+     * A G2 slug ("notion") or the numeric G2 id ("82623") as a string.
+     * Required unless `url` is given.
+     */
+    product_id?: string;
+    /** Full g2.com reviews URL, as an alternative to `product_id`. */
+    url?: string;
+    /** Result page, 1-indexed. Fixed at 10 reviews per page. */
+    page?: number;
+    /** Review sort order (default "relevance"). */
+    sort?: "relevance" | "newest" | "most_helpful" | "rating_high" | "rating_low";
+    /**
+     * Star bucket. HALF-STAR-INCLUSIVE: 1 returns 0, 0.5 and 1-star reviews.
+     */
+    rating?: 1 | 2 | 3 | 4 | 5;
+    /** Reviewer's company size: SB <=50, MM 51-1000, Ent >1000. */
+    company_size?: "small_business" | "mid_market" | "enterprise";
+    /** Reviewer's role. */
+    role?: "user" | "administrator" | "executive_sponsor" | "internal_consultant" | "consultant" | "agency" | "industry_analyst";
+    /** Reviewer's region. */
+    region?: "north_america" | "europe" | "asia" | "latin_america" | "anz" | "middle_east" | "africa";
+    /**
+     * Full-text search within the reviews (1-200 characters). Narrows the list
+     * AND every facet count.
+     */
+    query?: string;
+    [key: string]: unknown;
+}
+declare class G2Namespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Ranked B2B software products on G2: star rating, review count, vendor,
+     * categories, seller description and logo. Every row carries `product_id`
+     * and `slug` to feed product() and reviews().
+     *
+     * Paged with `page` and `limit` (1-100, default 20). `total_results` is
+     * G2's Products-tab headline and is CAPPED AT 10000, so treat a 10000 as a
+     * floor rather than a count; `total_by_type` breaks the same query across
+     * products, sellers, categories and discussions.
+     *
+     * Pass `query` or `url`.
+     *
+     * Costs 5 credits.
+     */
+    search(options: G2SearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * A full G2 software profile: rating with per-star histogram, review count,
+     * vendor, description and seller website, pricing editions with parsed
+     * amounts, feature groups, categories and breadcrumbs, supported languages,
+     * integrations, alternatives, head-to-head comparisons, media, community
+     * discussions and G2's AI-derived pros and cons.
+     *
+     * CARRIES NO REVIEW TEXT. G2 loads review bodies in a separate frame, so
+     * this endpoint returns none at all - call reviews() for text.
+     *
+     * Pass `product_id` (slug or numeric id as a string) or `url`.
+     *
+     * Costs 5 credits. Single response, no pagination.
+     */
+    product(options: G2ProductOptions): Promise<Record<string, unknown>>;
+    /**
+     * A page of G2 reviews: rating, title, likes and dislikes, problems solved,
+     * reviewer job title, industry and company size, validated and incentivized
+     * flags - PLUS what the profile page has no form of: exact per-star counts,
+     * pros and cons with per-theme counts, and company-size / role / industry /
+     * region / category facets with counts.
+     *
+     * Fixed at 10 reviews per page; advance with `page`. This paginates well
+     * past the 10 pages G2's own widget links to.
+     *
+     * `rating` buckets are HALF-STAR-INCLUSIVE (1 returns 0, 0.5 and 1-star).
+     * Every filter is a closed enum because an unrecognised value matches
+     * nothing upstream and comes back as an empty, plausible-looking result set.
+     *
+     * Pass `product_id` or `url`.
+     *
+     * Costs 5 credits.
+     */
+    reviews(options: G2ReviewsOptions): Promise<Record<string, unknown>>;
+}
+
+interface CapterraSearchOptions {
+    /**
+     * Search term (1-200 characters). Required unless `url` is given: a
+     * term-less search serves a fixed popular-products list that has nothing to
+     * do with the caller.
+     */
+    query?: string;
+    /**
+     * Full capterra.com search URL, as an alternative to `query`. The host is
+     * checked by the transport, which also covers capterra.co.uk and
+     * capterra.com.br.
+     */
+    url?: string;
+    [key: string]: unknown;
+}
+interface CapterraProductOptions {
+    /**
+     * The number in /p/186596/Notion/, AS A STRING - a JSON number is rejected.
+     * Required unless `url` is given.
+     */
+    product_id?: string;
+    /** Product slug. COSMETIC on this endpoint - any value returns the same profile. */
+    slug?: string;
+    /** Full capterra.com product URL, as an alternative to `product_id`. */
+    url?: string;
+    [key: string]: unknown;
+}
+interface CapterraReviewsOptions {
+    /**
+     * The number in /p/186596/Notion/, as a string. Required unless `url` is
+     * given.
+     */
+    product_id?: string;
+    /**
+     * Product slug. LOAD-BEARING here, unlike on product(): it is case-sensitive
+     * upstream and a wrong one silently serves PAGE ONE under a billed 200.
+     * Pass back the slug from search() or product().
+     */
+    slug?: string;
+    /**
+     * Full capterra.com reviews URL. Passing back `reviews_url` from product()
+     * is the reliable way to page.
+     */
+    url?: string;
+    /**
+     * Result page, 1-100. 25 reviews per page. There is no page past 100
+     * whatever the review count says.
+     */
+    page?: number;
+    [key: string]: unknown;
+}
+declare class CapterraNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * 20 ranked Capterra software products: name, vendor description, rating,
+     * review count, logo and the paid-placement flag. Every row carries
+     * `product_id` and `slug` to feed product() and reviews().
+     *
+     * NO PAGINATION. Capterra fixes the result set at 20 and page 2 returns the
+     * identical rows, so there is deliberately no page param - narrow the query
+     * instead.
+     *
+     * Pass `query` or `url`.
+     *
+     * Costs 2 credits.
+     */
+    search(options: CapterraSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * A full Capterra profile: rating with per-star histogram and the four
+     * scored criteria, likelihood to recommend, review sentiment and topics, the
+     * complete pricing table with every plan and its features, every rated
+     * feature, every integration, AI-derived pros and cons with the quoted
+     * review, FAQs, screenshots, badges and awards, competitor comparisons and
+     * alternatives, and the buyer profile by company size / industry / job
+     * function - PLUS the 25 most recent reviews, which ride along at no extra
+     * cost.
+     *
+     * `vendor` IS ALWAYS NULL here: Capterra does not publish it as structured
+     * data on the product page. The reviews name the vendor per review.
+     *
+     * Pass `product_id` (a string) or `url`. `slug` is cosmetic on this
+     * endpoint.
+     *
+     * Costs 2 credits. Single response, no pagination.
+     */
+    product(options: CapterraProductOptions): Promise<Record<string, unknown>>;
+    /**
+     * A page of Capterra reviews: overall score plus five per-criterion scores,
+     * title, pros, cons, advice, usage duration, incentivized flag, alternatives
+     * considered and what the reviewer switched from, reviewer job title /
+     * industry / company size, and the vendor response - plus a richer
+     * competitor list than the profile carries, each alternative with its own
+     * rating histogram and starting price.
+     *
+     * 25 reviews per page, CAPPED AT PAGE 100. Past it Capterra answers 200 with
+     * PAGE ONE and the page quietly dropped from the canonical, so nothing
+     * signals the cap but repeated rows. Page 1 is already inside product(), so
+     * use this to page past it.
+     *
+     * Pass `product_id` or `url`. `slug` is load-bearing here and case-sensitive
+     * upstream - a wrong one silently serves page one.
+     *
+     * Costs 2 credits.
+     */
+    reviews(options: CapterraReviewsOptions): Promise<Record<string, unknown>>;
+}
+
+interface SECLookupOptions {
+    /** Ticker, company name, or a fragment (1-200 characters). */
+    query: string;
+    /**
+     * How many matches to return, 1-100 (default 10). This SIZES the response,
+     * it is not a page param - there is no pagination here.
+     */
+    limit?: number;
+    /**
+     * Restrict to one listing exchange. Matched case-insensitively. Filers
+     * listed with NO exchange are excluded by ANY value.
+     */
+    exchange?: "NASDAQ" | "NYSE" | "OTC" | "CBOE";
+    [key: string]: unknown;
+}
+interface SECCompanyOptions {
+    /**
+     * CIK in any spelling: 320193, 0000320193 or CIK0000320193. A ticker is
+     * accepted here too. Either `cik` or `ticker` is required.
+     */
+    cik?: string;
+    /**
+     * Ticker, dotted or dashed (BRK.B / BRK-B). WINS over `cik` when both are
+     * given. Either `cik` or `ticker` is required.
+     */
+    ticker?: string;
+    [key: string]: unknown;
+}
+interface SECFilingsOptions {
+    /**
+     * CIK in any spelling; a ticker is accepted here too. Either `cik` or
+     * `ticker` is required.
+     */
+    cik?: string;
+    /**
+     * Ticker, dotted or dashed. WINS over `cik` when both are given. Either
+     * `cik` or `ticker` is required.
+     */
+    ticker?: string;
+    /**
+     * Form filter: "10-K", ["10-K", "10-Q"] or "10-K,8-K". Matched against the
+     * form AND its root form, so "10-K" also returns 10-K/A amendments - ask
+     * for "10-K/A" to get only amendments. Up to 25 forms.
+     */
+    form?: string | string[];
+    /** Earliest filing date, YYYY-MM-DD. */
+    date_from?: string;
+    /** Latest filing date, YYYY-MM-DD. */
+    date_to?: string;
+    /** Result page, 1-indexed. */
+    page?: number;
+    /** Filings per page, 1-500 (default 50). */
+    limit?: number;
+    /**
+     * Reach past EDGAR's "recent" block into up to 10 archived shards. Still
+     * ONE credit. `history_truncated` in the response flags a filer that had
+     * more shards than the cap.
+     */
+    include_history?: boolean;
+    [key: string]: unknown;
+}
+interface SECConceptOptions {
+    /**
+     * CIK in any spelling; a ticker is accepted here too. Either `cik` or
+     * `ticker` is required.
+     */
+    cik?: string;
+    /**
+     * Ticker, dotted or dashed. WINS over `cik` when both are given. Either
+     * `cik` or `ticker` is required.
+     */
+    ticker?: string;
+    /**
+     * XBRL tag, e.g. "NetIncomeLoss" (1-120 characters, letters then
+     * alphanumerics). CASE-SENSITIVE - "netincomeloss" is a 404 upstream, not a
+     * match. Use facts() to discover the tags a filer actually reports.
+     */
+    concept: string;
+    /** Taxonomy: us-gaap, dei, ifrs-full, srt (default "us-gaap"). */
+    taxonomy?: string;
+    /** Unit filter, e.g. "USD" vs "USD/shares". */
+    unit?: string;
+    /**
+     * Form filter. EXACT match here, so "10-K" EXCLUDES 10-K/A - the opposite
+     * of filings().
+     */
+    form?: string;
+    /**
+     * How many values to return, 1-2000 (default 250). This SIZES the response,
+     * it is not a page param.
+     */
+    limit?: number;
+    [key: string]: unknown;
+}
+interface SECFactsOptions {
+    /**
+     * CIK in any spelling; a ticker is accepted here too. Either `cik` or
+     * `ticker` is required.
+     */
+    cik?: string;
+    /**
+     * Ticker, dotted or dashed. WINS over `cik` when both are given. Either
+     * `cik` or `ticker` is required.
+     */
+    ticker?: string;
+    /** Restrict to one taxonomy, e.g. "us-gaap" or "dei". */
+    taxonomy?: string;
+    /**
+     * Case-insensitive substring matched against the tag name and its label
+     * (1-200 characters).
+     */
+    query?: string;
+    /**
+     * How many concepts to return, 1-2000 (default 250). This SIZES the
+     * response, it is not a page param.
+     */
+    limit?: number;
+    [key: string]: unknown;
+}
+interface SECSearchOptions {
+    /**
+     * Full-text query (1-500 characters). A quoted phrase is an exact match;
+     * bare words are a bag of terms. OPTIONAL - a cik, ticker, form or date
+     * filter on its own is a valid search.
+     */
+    query?: string;
+    /** One CIK or up to 25. Tickers are accepted here too. */
+    cik?: string | string[];
+    /** One ticker or up to 25. */
+    ticker?: string | string[];
+    /** One form or up to 25, e.g. "8-K" or ["10-K", "10-Q"]. */
+    form?: string | string[];
+    /** Earliest filing date, YYYY-MM-DD. Coverage starts in 2001. */
+    date_from?: string;
+    /** Latest filing date, YYYY-MM-DD. */
+    date_to?: string;
+    /**
+     * EDGAR's own two-character location codes - "CA", "NY", and alphanumeric
+     * codes for foreign jurisdictions. One or up to 25.
+     */
+    location?: string | string[];
+    /** Result order (default "relevance"). */
+    sort?: "relevance" | "newest" | "oldest";
+    /**
+     * Result page, 1-indexed, CAPPED AT 100. 100 documents per page - the index
+     * refuses a result window past 10,000.
+     */
+    page?: number;
+    [key: string]: unknown;
+}
+declare class SECNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * START HERE. Resolves a company name or ticker to the CIK every other SEC
+     * EDGAR endpoint is keyed by: matching filers with symbol, listing
+     * exchange, and ready-made submissions / company-facts / EDGAR URLs, tiered
+     * by match quality (each row carries its tier as `match`).
+     *
+     * `limit` sizes the response; there is no pagination. `exchange` is a
+     * closed set matched case-insensitively, and filers listed with no exchange
+     * are excluded by ANY value.
+     *
+     * Costs 1 credit.
+     */
+    lookup(options: SECLookupOptions): Promise<Record<string, unknown>>;
+    /**
+     * Filer profile: legal and former names, SIC industry, filer category, EIN,
+     * LEI, state of incorporation, fiscal year end, business and mailing
+     * addresses, every ticker with its exchange, which forms it files and how
+     * often, plus a preview of its 10 most recent filings.
+     *
+     * Either `cik` or `ticker` is required; `ticker` wins when both are given.
+     *
+     * Costs 1 credit. Single response, no pagination.
+     */
+    company(options: SECCompanyOptions): Promise<Record<string, unknown>>;
+    /**
+     * A page of one filer's filings: accession number, form and root form,
+     * filing and period dates, 8-K item codes, and direct links to the primary
+     * document, filing index and attachment directory.
+     *
+     * Either `cik` or `ticker` is required. Paged with `page` + `limit`.
+     * `form` matches the form AND its root form, so "10-K" also returns 10-K/A.
+     * EDGAR's "recent" block is not a fixed window - a decade for a quiet
+     * filer, about a year for a prolific one; `include_history` reaches back
+     * through up to 10 archived shards and sets `history_truncated` when the
+     * filer had more.
+     *
+     * Costs 1 credit - including with `include_history`, which is the one call
+     * that can buy more than one upstream fetch.
+     */
+    filings(options: SECFilingsOptions): Promise<Record<string, unknown>>;
+    /**
+     * Every value a filer reported for one XBRL concept, newest period first,
+     * with the form and filing each number came from. Restatements are KEPT,
+     * not collapsed; `latest` disambiguates a quarter from its year-to-date
+     * twin using the SEC's comparability flag.
+     *
+     * Either `cik` or `ticker` is required. The `concept` tag is CASE-SENSITIVE
+     * - "netincomeloss" is a 404 upstream, not a match; call facts() to find
+     * the real tag. `form` is an EXACT match here, so "10-K" excludes 10-K/A.
+     * `limit` sizes the response; there is no pagination.
+     *
+     * Costs 1 credit.
+     */
+    concept(options: SECConceptOptions): Promise<Record<string, unknown>>;
+    /**
+     * The index of every XBRL concept a filer reports - tag, label,
+     * description, units and most recent value - across us-gaap, dei and any
+     * other taxonomy it uses. This is how you find what to ask concept() for.
+     *
+     * Either `cik` or `ticker` is required. `limit` sizes the response; there
+     * is no pagination.
+     *
+     * Costs 1 credit.
+     */
+    facts(options: SECFactsOptions): Promise<Record<string, unknown>>;
+    /**
+     * EDGAR full-text search: each hit is the matching DOCUMENT with its URL,
+     * form, filing date and filer identity, plus facets breaking the whole
+     * result set down by company, form, industry and state.
+     *
+     * Coverage STARTS IN 2001 - nothing earlier is indexed. Accepts NO query at
+     * all: a cik, ticker, form or date filter on its own is a valid search.
+     * Paged with `page`, capped at 100 (100 documents per page) because the
+     * index refuses a result window past 10,000.
+     *
+     * Costs 1 credit.
+     */
+    search(options: SECSearchOptions): Promise<Record<string, unknown>>;
+}
+
+interface CompaniesHouseSearchOptions {
+    /** Company name or fragment (1-200 characters, non-blank). */
+    query: string;
+    /**
+     * Result page, 1-indexed (default 1). 20 results per page, CAPPED AT 50 -
+     * the register only serves the first 1000 matches for a term.
+     */
+    page?: number;
+    [key: string]: unknown;
+}
+interface CompaniesHouseCompanyOptions {
+    /**
+     * UK company number, 1-20 characters, e.g. "00445790" or "SC090312". Loose
+     * on purpose - it is zero-padded and upper-cased for you, so "445790" and
+     * "sc090312" both work. Prefixes: SC, NI, OC/SO/NC, FC, BR, CE.
+     */
+    company_number: string;
+    [key: string]: unknown;
+}
+interface CompaniesHouseOfficersOptions {
+    /**
+     * UK company number, zero-padded and upper-cased for you.
+     */
+    company_number: string;
+    /**
+     * Result page, 1-indexed (default 1). 35 officers per page, no upper bound
+     * - past the last page the register answers 200 with an empty list.
+     */
+    page?: number;
+    [key: string]: unknown;
+}
+interface CompaniesHouseFilingHistoryOptions {
+    /**
+     * UK company number, zero-padded and upper-cased for you.
+     */
+    company_number: string;
+    /**
+     * Result page, 1-indexed (default 1). No upper bound - past the last page
+     * the register answers 200 with an empty list.
+     */
+    page?: number;
+    [key: string]: unknown;
+}
+declare class CompaniesHouseNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * START HERE. Searches the UK register by name and returns the
+     * `company_number` every other endpoint is keyed by, plus name, status,
+     * incorporation or dissolution date, registered office address and matched
+     * former names.
+     *
+     * Matches CURRENT AND FORMER names. Paged with `page`, 20 results per page,
+     * CAPPED AT PAGE 50 - the register serves a 1000-result window per term
+     * whatever hit count it prints, and answers page 51 with HTTP 416.
+     *
+     * Costs 1 credit.
+     */
+    search(options: CompaniesHouseSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * Full register entry: status, type, incorporation and dissolution dates,
+     * registered office, SIC codes, previous names, accounts and
+     * confirmation-statement due dates with overdue flags, and whether it has
+     * charges, insolvency history, officers or UK establishments. FC companies
+     * return home registry / legal form / governing law, BR returns the parent,
+     * CE returns the charity number.
+     *
+     * `company_number` is zero-padded and upper-cased for you, so a number off
+     * a letterhead or out of a spreadsheet that ate its leading zeros still
+     * resolves.
+     *
+     * Costs 1 credit. Single response, no pagination.
+     */
+    company(options: CompaniesHouseCompanyOptions): Promise<Record<string, unknown>>;
+    /**
+     * Officers current and resigned: name, role, appointment and resignation
+     * dates, correspondence address, nationality, country of residence,
+     * month-and-year date of birth, and identity-verification status.
+     *
+     * Paged with `page`, 35 officers per page, NO upper bound - past the last
+     * page the register answers an ordinary 200 with an empty list, identical
+     * to a company with no officers.
+     *
+     * `officers_count` is EVERY appointment ever made and `resignations_count`
+     * how many ended, so the active count is the difference. There is no
+     * server-side active/resigned filter - filter on each officer's `status` in
+     * the response.
+     *
+     * Costs 1 credit.
+     */
+    officers(options: CompaniesHouseOfficersOptions): Promise<Record<string, unknown>>;
+    /**
+     * Filings, most recent first: date, filing type code (AA, CS01, SH03),
+     * description, register annotations and child documents, and a link to the
+     * filed PDF with its page count.
+     *
+     * A filing the register has not finished processing carries a
+     * `processing_note` instead of a document.
+     *
+     * Paged with `page`, NO upper bound - past the last page it is an ordinary
+     * 200 with an empty list.
+     *
+     * Costs 1 credit.
+     */
+    filingHistory(options: CompaniesHouseFilingHistoryOptions): Promise<Record<string, unknown>>;
+}
+
+interface GoogleAdsAdvertisersOptions {
+    /** Brand name or domain to resolve (1-200 characters). */
+    query: string;
+    /**
+     * ISO alpha-2 country (US, GB, DE) or a Google geo criteria id as a string.
+     * Default: no region filter.
+     */
+    region?: string;
+    /**
+     * Rows per arm (1-20, default 10). Advertisers and domains are capped
+     * SEPARATELY, so a name query can return up to twice this many rows.
+     */
+    limit?: number;
+    [key: string]: unknown;
+}
+interface GoogleAdsSearchOptions {
+    /**
+     * Bare host, www host or full URL; reduced to the registrable host. THE ONLY
+     * WAY to get the `domain` field back on each row. Required unless
+     * `advertiser_id` is given.
+     */
+    domain?: string;
+    /**
+     * Google advertiser id, e.g. "AR16735076323512287233". The shape is checked
+     * before any request is made, so a typo costs nothing. Required unless
+     * `domain` is given.
+     */
+    advertiser_id?: string;
+    /**
+     * ISO alpha-2 country (US, GB, DE) or a Google geo criteria id as a string.
+     * Scopes the deep links on every row - the same advertiser can share ZERO
+     * creatives between two countries. Default: worldwide.
+     */
+    region?: string;
+    /** Creative format. The three sets are DISJOINT. Default: all formats. */
+    format?: "text" | "image" | "video";
+    /** Google surface the ad ran on. Default: all surfaces. */
+    platform?: "play" | "maps" | "search" | "shopping" | "youtube";
+    /** Ad topic (default "all"). */
+    topic?: "all" | "political";
+    /**
+     * Rows per page (1-100, default 40). 100 is a HARD UPSTREAM CEILING, not our
+     * policy: Google answers a larger request with ZERO rows rather than an
+     * error.
+     */
+    limit?: number;
+    /**
+     * `next_cursor` from the previous response (1-4000 characters). Re-send the
+     * SAME filters alongside it. Null once the advertiser is exhausted.
+     */
+    cursor?: string;
+    [key: string]: unknown;
+}
+interface GoogleAdsCreativeOptions {
+    /** Google advertiser id, e.g. "AR16735076323512287233". */
+    advertiser_id: string;
+    /**
+     * Creative id. MUST belong to the `advertiser_id` sent with it - the lookup
+     * is keyed by the pair and a mismatch is a 404.
+     */
+    creative_id: string;
+    [key: string]: unknown;
+}
+declare class GoogleAdsNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * START HERE. Resolves a brand name or a domain to the `advertiser_id` that
+     * search() and creative() are keyed by.
+     *
+     * Returns two row kinds in one list: `advertiser` rows carry the id, the
+     * verified name, the verification country and the total ad count AS A RANGE
+     * (total_ads_min / total_ads_max - Google never publishes an exact figure);
+     * `domain` rows carry a website. A name query returns both kinds, a
+     * domain-shaped query returns domains only.
+     *
+     * NO PAGINATION - this is an autocomplete, roughly 20 rows per arm, and
+     * `limit` caps each arm separately.
+     *
+     * Costs 1 credit.
+     */
+    advertisers(options: GoogleAdsAdvertisersOptions): Promise<Record<string, unknown>>;
+    /**
+     * Every ad Google is running for one advertiser: the creative (archived
+     * image, rich-media bundle, Google's renderer link, dimensions), advertiser
+     * id and name, format, first and last seen dates, days actually run, plus
+     * total_ads_min / total_ads_max.
+     *
+     * Cursor-paginated: read `next_cursor` off the response and send it back as
+     * `cursor` WITH THE SAME FILTERS, up to 100 rows per page. `next_cursor` is
+     * null once exhausted. A `limit` above 100 is not an error - Google answers
+     * it with ZERO rows.
+     *
+     * The three `format` sets are disjoint, and `domain` is dropped from every
+     * row when the query is by `advertiser_id`, so query by domain if you need
+     * that field. The headline total is a RANGE, never an exact count.
+     *
+     * Pass `domain` or `advertiser_id`.
+     *
+     * Costs 1 credit per page.
+     */
+    search(options: GoogleAdsSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * One creative in full, and the ONLY endpoint carrying its history: every
+     * size variation of the asset, the impression bucket, the per-region
+     * breakdown with first and last shown dates and a per-surface impression
+     * split inside each region, the format, Google's category label, and the
+     * funder disclosure on political ads.
+     *
+     * IMPRESSIONS AND REACH ARE EEA-ONLY: impressions_min, impressions_max and
+     * first_shown are NULL on US creatives because Google publishes reach only
+     * where the DSA compels it. A bucket row can carry a lower bound, an upper
+     * bound, or one alone.
+     *
+     * Keyed by the `advertiser_id` + `creative_id` PAIR - a mismatched pair is a
+     * 404, not an empty response.
+     *
+     * Costs 1 credit. Single response, no pagination.
+     */
+    creative(options: GoogleAdsCreativeOptions): Promise<Record<string, unknown>>;
+}
+
+interface MetaAdsSearchOptions {
+    /** Search term (1-200 characters). */
+    query: string;
+    /** Two-letter country code (default "US"). */
+    country?: string;
+    /** Whether to include ads that have stopped running (default "all"). */
+    active_status?: "all" | "active" | "inactive";
+    /**
+     * Ad category (default "all"). "political_and_issue_ads" is the only way to
+     * get spend, reach, impressions and the paid-for-by disclosure back.
+     */
+    ad_type?: "all" | "political_and_issue_ads";
+    /** Creative media filter. Default: no media filter. */
+    media_type?: "all" | "image" | "video" | "meme" | "image_and_meme" | "none";
+    /** How the query terms are matched (default "keyword_unordered"). */
+    search_type?: "keyword_unordered" | "keyword_exact_phrase";
+    /**
+     * `next_cursor` from the previous response. Page 1 is 30 ads, then 10 per
+     * page. EVERY OTHER FILTER IS IGNORED when this is present - the cursor
+     * already carries them.
+     */
+    cursor?: string;
+    [key: string]: unknown;
+}
+interface MetaAdsAdvertiserOptions {
+    /** The advertiser's numeric Facebook Page id (3-25 digits, as a string). */
+    page_id: string;
+    /** Two-letter country code (default "US"). */
+    country?: string;
+    /** Whether to include ads that have stopped running (default "all"). */
+    active_status?: "all" | "active" | "inactive";
+    /**
+     * Ad category (default "all"). "political_and_issue_ads" is the only way to
+     * get spend, reach, impressions and the paid-for-by disclosure back.
+     */
+    ad_type?: "all" | "political_and_issue_ads";
+    /** Creative media filter. Default: no media filter. */
+    media_type?: "all" | "image" | "video" | "meme" | "image_and_meme" | "none";
+    /**
+     * `next_cursor` from the previous response. Page 1 is 30 ads, then 10 per
+     * page. EVERY OTHER FILTER IS IGNORED when this is present.
+     */
+    cursor?: string;
+    [key: string]: unknown;
+}
+interface MetaAdsAdOptions {
+    /** The ad's archive id (3-25 digits, as a string). */
+    ad_archive_id: string;
+    [key: string]: unknown;
+}
+declare class MetaAdsNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Search the Meta Ad Library. Page 1 returns 30 ads with the full creative:
+     * page name, ad copy, headline, CTA, images and videos, the platforms each
+     * ran on, and run dates - plus `total_results`, `total_is_capped`,
+     * `has_next_page` and `next_cursor`.
+     *
+     * Cursor-paginated the whole way down: 30 ads on page 1, then 10 per page.
+     * Walk `has_next_page` to pull an entire query. THE OTHER FILTERS ARE
+     * IGNORED once `cursor` is set, because the cursor carries them itself.
+     *
+     * `total_results` CAPS AT 50000 with `total_is_capped: true` - Meta only
+     * reports ">50,000", so never present it as an exact count. Spend, reach,
+     * impressions and the paid-for-by disclosure are null unless
+     * `ad_type` is "political_and_issue_ads".
+     *
+     * Costs 1 credit PER PAGE, so depth costs roughly 10 ads per credit past the
+     * first 30.
+     */
+    search(options: MetaAdsSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * Every ad a Facebook Page is running, addressed by its numeric page id.
+     * Page 1 returns 30 ads with the same creative detail as search(), then 10
+     * per page off `next_cursor`; walk `has_next_page` to pull the advertiser's
+     * whole library.
+     *
+     * The other filters are ignored once `cursor` is set. Spend, reach,
+     * impressions and the paid-for-by disclosure are null on commercial ads -
+     * only political/issue ads carry them.
+     *
+     * Costs 1 credit per page.
+     */
+    advertiser(options: MetaAdsAdvertiserOptions): Promise<Record<string, unknown>>;
+    /**
+     * One ad in full by archive id: creative, advertiser, run dates, platforms
+     * and any political disclosure.
+     *
+     * Spend, reach and impressions are null unless the ad is a political/issue
+     * ad.
+     *
+     * Costs 1 credit. Single response, no pagination.
+     */
+    ad(options: MetaAdsAdOptions): Promise<Record<string, unknown>>;
+}
+
+interface ScavioConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    timeout?: number;
+    maxRequestsPerSecond?: number;
+    /**
+     * Additional retry attempts after the first request on transient failures
+     * (HTTP 429/500/502/503/504 and network/timeout errors). Defaults to 2.
+     * Set to 0 to disable retries.
+     */
+    maxRetries?: number;
+}
+/**
+ * Options for the top-level `extract()` method.
+ *
+ * Extract is a CORE endpoint, not a platform: it reads any URL, so it hangs
+ * off the client itself rather than a namespace.
+ */
+interface ExtractOptions {
+    /**
+     * Page to read. http(s) only; a bare host is upgraded to https. Loopback,
+     * private, link-local and cloud-metadata hosts are rejected with a 400.
+     * 1-2048 characters.
+     */
+    url: string;
+    /**
+     * Output format (default "markdown").
+     *
+     * - "html": the raw page, unmodified.
+     * - "markdown": readability extraction - boilerplate stripped.
+     * - "text": that markdown flattened to plain text.
+     */
+    format?: "html" | "markdown" | "text";
+    /**
+     * 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.
+     */
+    mode?: "normal" | "advanced" | "ultra";
+    [key: string]: unknown;
+}
+declare class Scavio {
+    readonly google: GoogleNamespace;
+    readonly amazon: AmazonNamespace;
+    readonly walmart: WalmartNamespace;
+    readonly youtube: YouTubeNamespace;
+    readonly reddit: RedditNamespace;
+    readonly tiktok: TikTokNamespace;
+    readonly tiktokShop: TikTokShopNamespace;
+    readonly instagram: InstagramNamespace;
+    readonly x: XNamespace;
+    readonly linkedin: LinkedInNamespace;
+    readonly threads: ThreadsNamespace;
+    readonly kuaishou: KuaishouNamespace;
+    readonly ebay: EbayNamespace;
+    readonly target: TargetNamespace;
+    readonly homeDepot: HomeDepotNamespace;
+    readonly zillow: ZillowNamespace;
+    readonly redfin: RedfinNamespace;
+    readonly booking: BookingNamespace;
+    readonly airbnb: AirbnbNamespace;
+    readonly tripadvisor: TripadvisorNamespace;
+    readonly yelp: YelpNamespace;
+    readonly indeed: IndeedNamespace;
+    readonly glassdoor: GlassdoorNamespace;
+    readonly appStore: AppStoreNamespace;
+    readonly googlePlay: GooglePlayNamespace;
+    readonly g2: G2Namespace;
+    readonly capterra: CapterraNamespace;
+    readonly sec: SECNamespace;
+    readonly companiesHouse: CompaniesHouseNamespace;
+    readonly googleAds: GoogleAdsNamespace;
+    readonly metaAds: MetaAdsNamespace;
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    private readonly maxRetries;
+    private readonly rateLimiter;
+    constructor(config?: ScavioConfig);
+    /** @internal */
+    _post(path: string, body: object): Promise<Record<string, unknown>>;
+    /** @internal */
+    _get(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>>;
+}
+
+declare class ScavioError extends Error {
+    constructor(message: string);
+}
+declare class MissingAPIKeyError extends ScavioError {
+    constructor();
+}
+/** The request could not reach the API (DNS, connection reset, TLS, ...). */
+declare class ScavioConnectionError extends ScavioError {
+    constructor(message?: string);
+}
+/** The request did not complete within the configured timeout. */
+declare class ScavioTimeoutError extends ScavioError {
+    constructor(message?: string);
+}
+declare class InvalidAPIKeyError extends ScavioError {
+    readonly statusCode = 401;
+    readonly responseBody?: Record<string, unknown>;
+    constructor(message?: string, responseBody?: Record<string, unknown>);
+}
+declare class InsufficientCreditsError extends ScavioError {
+    readonly statusCode = 402;
+    readonly responseBody?: Record<string, unknown>;
+    constructor(message?: string, responseBody?: Record<string, unknown>);
+}
+/**
+ * The request body failed validation. Raised for HTTP 400 and for HTTP 422,
+ * which is what Threads and Kuaishou return when an identifier is missing or
+ * conflicting - those routes have no 400. `statusCode` reports whichever the
+ * API actually sent.
+ */
+declare class BadRequestError extends ScavioError {
+    readonly statusCode: number;
+    readonly responseBody?: Record<string, unknown>;
+    constructor(message?: string, responseBody?: Record<string, unknown>, statusCode?: number);
 }
 declare class NotFoundError extends ScavioError {
     readonly statusCode = 404;
@@ -1380,4 +4214,4 @@ declare class ScavioAPIError extends ScavioError {
     constructor(statusCode: number, message: string, responseBody?: Record<string, unknown>);
 }
 
-export { type AmazonOffersOptions, type AmazonProductOptions, type AmazonSearchOptions, BadRequestError, type GoogleAiModeOptions, type GoogleFlightsOptions, type GoogleHotelsDetailOptions, type GoogleHotelsOptions, type GoogleMapsPlaceOptions, type GoogleMapsReviewsOptions, type GoogleMapsSearchOptions, type GoogleNewsOptions, type GoogleSearchOptions, type GoogleShoppingOptions, type GoogleShoppingProductOptions, type GoogleShoppingStoresOptions, type GoogleTrendingOptions, type GoogleTrendsOptions, type InstagramCommentRepliesOptions, type InstagramFollowOptions, type InstagramPostCommentsOptions, type InstagramPostOptions, type InstagramProfileOptions, type InstagramSearchOptions, type InstagramStoriesOptions, type InstagramUserFeedOptions, InsufficientCreditsError, InvalidAPIKeyError, type LinkedInCompanyOptions, type LinkedInCompanyPostsOptions, type LinkedInCompanyPostsRequest, type LinkedInCompanyRefOptions, type LinkedInJobOptions, type LinkedInPersonContactOptions, type LinkedInPersonOptions, type LinkedInPersonPostsOptions, type LinkedInPersonPostsRequest, type LinkedInPersonRefOptions, type LinkedInPostCommentsOptions, type LinkedInPostOptions, type LinkedInSearchJobsOptions, type LinkedInSearchPeopleOptions, type LinkedInSearchPostsOptions, MissingAPIKeyError, NotFoundError, RateLimitError, type RedditCommentRepliesOptions, type RedditFeedSort, type RedditPopularOptions, type RedditPostCommentsOptions, type RedditPostOptions, type RedditSearchOptions, type RedditSearchSuggestionsOptions, type RedditSort, type RedditSubredditOptions, type RedditSubredditPostsOptions, type RedditUserFeedOptions, type RedditUserOptions, Scavio, ScavioAPIError, type ScavioConfig, ScavioConnectionError, ScavioError, ScavioTimeoutError, type TikTokCommentRepliesOptions, type TikTokHashtagOptions, type TikTokHashtagVideosOptions, type TikTokProfileOptions, type TikTokSearchUsersOptions, type TikTokSearchVideosOptions, type TikTokShopCategoryProductsOptions, type TikTokShopListingRegion, 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 WalmartProductOptions, type WalmartSearchOptions, type XSearchOptions, type XTrendingOptions, type XTweetCommentsOptions, type XTweetOptions, type XTweetRetweetersOptions, type XUserFeedOptions, type XUserOptions, type YouTubeChannelCommunityOptions, type YouTubeChannelOptions, type YouTubeChannelResolveOptions, type YouTubeChannelSearchOptions, type YouTubeChannelShortsOptions, type YouTubeChannelVideosOptions, type YouTubeCommentRepliesOptions, type YouTubeCommentsOptions, type YouTubeMetadataOptions, type YouTubeRelatedOptions, type YouTubeSearchOptions, type YouTubeShortsOptions, type YouTubeStreamsOptions, type YouTubeSuggestionsOptions, type YouTubeTranscriptOptions, type YouTubeVideoOptions };
+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, 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, type MetaAdsAdOptions, type MetaAdsAdvertiserOptions, MetaAdsNamespace, type MetaAdsSearchOptions, MissingAPIKeyError, NotFoundError, RateLimitError, 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 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 WalmartCategoryOptions, WalmartNamespace, type WalmartOffersOptions, type WalmartProductOptions, type WalmartReviewsOptions, type WalmartSearchOptions, type WalmartSellerOptions, type WalmartSellerProductsOptions, 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 };