scavio 0.24.0 → 0.25.0

package/dist/index.d.ts

@@ -1,7 +1,6 @@
 /**
- * Amazon moved to a new upstream in 2026-07 and the API now returns a
- * normalized shape instead of the old raw provider payload. Nine options went
- * with the old provider: language, currency, device, sort_by, pages,
+ * The Amazon API changed in 2026-07 and now returns a normalized shape
+ * instead of the old raw payload. Nine options were removed: language, currency, device, sort_by, pages,
  * category_id, merchant_id, zip_code and autoselect_variant. They are removed
  * rather than kept as no-ops - notably `sort_by`, which the marketplace was
  * verified to ignore entirely (every sort value returned the same unordered
@@ -57,9 +56,9 @@ declare class AmazonNamespace {
 }
 
 /**
- * Google endpoints (scrape.do engine, /api/v2/google). A faithful passthrough
- * that returns Google's full response. Every endpoint costs 1 credit. Any
- * additional scrape.do parameter can be added to the options object.
+ * Google endpoints (/api/v2/google). A faithful passthrough that returns
+ * Google's full response. Every endpoint costs 1 credit. Any additional
+ * API parameter can be added to the options object.
  * See https://scavio.dev/docs/search-api.
  */
 interface GoogleSearchOptions {
@@ -378,11 +377,128 @@ interface GoogleTrendingOptions {
     status?: "all" | "active";
     [key: string]: unknown;
 }
+interface GoogleCustomSearchOptions {
+    /** Search query. */
+    q: string;
+    /** Accepted and echoed back; results come from the whole web. */
+    cx?: string;
+    /** Results to return, 1-10 (default 10). */
+    num?: number;
+    /** 1-based index of the first result (default 1); start + num <= 100. */
+    start?: number;
+    /** Country of the search (ISO 3166-1 alpha-2, e.g. 'us'). */
+    gl?: string;
+    /** UI language (e.g. 'en', 'zh-TW'). */
+    hl?: string;
+    /** Language restrict (e.g. 'lang_en'). */
+    lr?: string;
+    /** Country restrict, a single value (e.g. 'countryUS'). */
+    cr?: string;
+    /** SafeSearch (default 'off'). */
+    safe?: "active" | "off";
+    /** '0' turns off duplicate-content filtering. */
+    filter?: "0" | "1";
+    /** d[N], w[N], m[N] or y[N] (e.g. 'm6'). Sent as dateRestrict. */
+    date_restrict?: string;
+    /** Site to include or exclude (e.g. 'example.com'); enforced on results. Sent as siteSearch. */
+    site_search?: string;
+    /** 'i' include site_search (default), 'e' exclude it. Sent as siteSearchFilter. */
+    site_search_filter?: "i" | "e";
+    /** Phrase every result must contain. Sent as exactTerms. */
+    exact_terms?: string;
+    /** Word or phrase no result may contain. Sent as excludeTerms. */
+    exclude_terms?: string;
+    /** Space-separated terms; each result contains at least one. Sent as orTerms. */
+    or_terms?: string;
+    /** Extra terms ANDed onto the query. */
+    hq?: string;
+    /** File extension to restrict to (e.g. 'pdf'). Sent as fileType. */
+    file_type?: string;
+    /** Google domain to search (e.g. 'google.co.uk'). */
+    googlehost?: string;
+    /** Canonical location name (Scavio extension). */
+    location?: string;
+    /** Device to emulate (Scavio extension). */
+    device?: "desktop" | "mobile";
+    /** Disable spelling autocorrection when true (Scavio extension). */
+    nfpr?: boolean;
+    /** Skip the 24h result cache when true (Scavio extension). */
+    no_cache?: boolean;
+    [key: string]: unknown;
+}
+/** One result in the Custom Search JSON API format. */
+interface GoogleCustomSearchItem {
+    kind: "customsearch#result";
+    title: string;
+    htmlTitle: string;
+    link: string;
+    displayLink: string;
+    snippet: string;
+    htmlSnippet: string;
+    formattedUrl: string;
+    htmlFormattedUrl: string;
+    pagemap?: {
+        cse_thumbnail?: {
+            src: string;
+        }[];
+        [key: string]: unknown;
+    };
+}
+/** queries.request / nextPage / previousPage entry. */
+interface GoogleCustomSearchQuery {
+    title: string;
+    totalResults: string;
+    searchTerms: string;
+    count: number;
+    startIndex: number;
+    inputEncoding: string;
+    outputEncoding: string;
+    safe: string;
+    cx?: string;
+    [key: string]: unknown;
+}
+/** customsearch#search response, plus Scavio's billing object. */
+interface GoogleCustomSearchResponse {
+    kind: "customsearch#search";
+    url: {
+        type: string;
+        template: string;
+    };
+    queries: {
+        request: GoogleCustomSearchQuery[];
+        nextPage?: GoogleCustomSearchQuery[];
+        previousPage?: GoogleCustomSearchQuery[];
+    };
+    searchInformation: {
+        searchTime: number;
+        formattedSearchTime: string;
+        totalResults: string;
+        formattedTotalResults: string;
+    };
+    /** Omitted when there are no results, as in the Custom Search JSON API. */
+    items?: GoogleCustomSearchItem[];
+    scavio: {
+        credits_used: number;
+        credits_remaining: number;
+        cached: boolean;
+        response_time: number;
+    };
+    [key: string]: unknown;
+}
 declare class GoogleNamespace {
     private client;
     constructor(client: Scavio);
     /** Google SERP search (includes the AI Overview when Google returns one). */
     search(options: GoogleSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * Google search in the Custom Search JSON API format: a drop-in for cse.list.
+     * Returns customsearch#search (items[], searchInformation, queries.nextPage)
+     * plus a scavio billing object, so CSE parsing code keeps working. For the
+     * full SERP (knowledge graph, AI overview, People Also Ask) use search().
+     * Unsupported CSE params (image search, sort, rights) throw BadRequestError.
+     * 1 credit.
+     */
+    customSearch(options: GoogleCustomSearchOptions): Promise<GoogleCustomSearchResponse>;
     /** Google AI Mode answer. */
     aiMode(options: GoogleAiModeOptions): Promise<Record<string, unknown>>;
     /** Google Maps local results. */
@@ -1727,18 +1843,18 @@ interface LinkedInPostCommentsOptions extends LinkedInPostOptions {
     /** 1-based page number. Page size varies, so page until a page comes back empty. */
     page?: number;
 }
-/** @deprecated Retired upstream; always returns HTTP 410. */
+/** @deprecated Retired; always returns HTTP 410. */
 interface LinkedInPersonContactOptions {
     username?: string;
     [key: string]: unknown;
 }
-/** @deprecated Retired upstream; always returns HTTP 410. */
+/** @deprecated Retired; always returns HTTP 410. */
 interface LinkedInCompanyRefOptions {
     company_id?: string;
     company?: string;
     [key: string]: unknown;
 }
-/** @deprecated Retired upstream; always returns HTTP 410. */
+/** @deprecated Retired; always returns HTTP 410. */
 interface LinkedInSearchPeopleOptions {
     search?: string;
     title?: string;
@@ -1747,7 +1863,7 @@ interface LinkedInSearchPeopleOptions {
     location?: string;
     [key: string]: unknown;
 }
-/** @deprecated Retired upstream; always returns HTTP 410. */
+/** @deprecated Retired; always returns HTTP 410. */
 interface LinkedInSearchPostsOptions {
     search?: string;
     [key: string]: unknown;
@@ -1780,28 +1896,28 @@ declare class LinkedInNamespace {
     /** Comments with their replies. Page size varies - keep paging until empty. */
     postComments(options: LinkedInPostCommentsOptions): Promise<Record<string, unknown>>;
     /**
-     * @deprecated Retired by the upstream provider. Always returns HTTP 410 and is
+     * @deprecated Retired. Always returns HTTP 410 and is
      * never billed.
      */
     personContact(options: LinkedInPersonContactOptions): Promise<Record<string, unknown>>;
     /**
-     * @deprecated Retired by the upstream provider. Always returns HTTP 410 and is
+     * @deprecated Retired. Always returns HTTP 410 and is
      * never billed. `company()` returns `featured_employees`, a small sample of
      * staff profiles.
      */
     companyPeople(options: LinkedInCompanyRefOptions): Promise<Record<string, unknown>>;
     /**
-     * @deprecated Retired by the upstream provider. Always returns HTTP 410 and is
+     * @deprecated Retired. Always returns HTTP 410 and is
      * never billed. Use `searchJobs()` with the company name as the search term.
      */
     companyJobs(options: LinkedInCompanyRefOptions): Promise<Record<string, unknown>>;
     /**
-     * @deprecated Retired by the upstream provider. Always returns HTTP 410 and is
+     * @deprecated Retired. Always returns HTTP 410 and is
      * never billed.
      */
     searchPeople(options: LinkedInSearchPeopleOptions): Promise<Record<string, unknown>>;
     /**
-     * @deprecated Retired by the upstream provider. Always returns HTTP 410 and is
+     * @deprecated Retired. Always returns HTTP 410 and is
      * never billed.
      */
     searchPosts(options: LinkedInSearchPostsOptions): Promise<Record<string, unknown>>;
@@ -1815,7 +1931,7 @@ interface ThreadsProfileOptions {
     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`.
+     * because the id has to be resolved first - prefer `user_id`.
      */
     username?: string;
     [key: string]: unknown;
@@ -2246,7 +2362,7 @@ declare class TargetNamespace {
      * 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.
+     * Costs 1 credit. Typically ~9s.
      */
     search(options: TargetSearchOptions): Promise<Record<string, unknown>>;
     /**
@@ -2621,9 +2737,8 @@ declare class RedfinNamespace {
      * 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().
+     * Returns the whole property page in one call, which is why it is the same
+     * price as search().
      *
      * Costs 1 credit. Single response, no pagination.
      */
@@ -2700,7 +2815,7 @@ interface BookingSearchOptions {
     rooms?: number;
     /**
      * ISO 4217 currency, 3 letters (default "USD"). Leave it set - without a
-     * currency Booking prices off the proxy exit.
+     * currency Booking picks a currency itself.
      */
     currency?: string;
     [key: string]: unknown;
@@ -2859,7 +2974,7 @@ interface AirbnbSearchOptions {
     amenities?: string;
     /**
      * ISO 4217 currency (default "USD"). Leave it set - without a currency
-     * Airbnb prices off the proxy exit.
+     * Airbnb picks a currency itself.
      */
     currency?: string;
     /**
@@ -3115,8 +3230,7 @@ interface YelpSearchOptions {
     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.
+     * REQUIRED - without it Yelp picks a location itself and the same request can answer about a different metro run to run.
      */
     location?: string;
     /** Result page, 1-indexed. Yelp fixes the page size at 10. */
@@ -3188,7 +3302,7 @@ declare class YelpNamespace {
      * count.
      *
      * `term` + `location` or `url` is required, and `location` is effectively
-     * mandatory - Yelp geolocates a location-less search off the proxy exit.
+     * mandatory - without it Yelp picks a location itself.
      * Paged with `page`; the page size is fixed at 10.
      *
      * Costs 2 credits.
@@ -3308,8 +3422,7 @@ declare class IndeedNamespace {
      * 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.
+     * Single response, no pagination. An unknown job key is a real 404 and IS BILLED - take `job_id` from a search row.
      *
      * Costs 2 credits.
      */
@@ -3319,8 +3432,7 @@ declare class IndeedNamespace {
      * 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.
+     * Single response, no pagination. An unknown company slug is a real 404 and IS BILLED.
      *
      * Costs 2 credits.
      */
@@ -3365,7 +3477,7 @@ interface GlassdoorCompanyOptions {
 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 -
+     * `url` is required. Addressing by employer_id costs two lookups -
      * pass reviews_url from company() as `url` instead.
      */
     employer_id?: string;
@@ -3392,7 +3504,7 @@ interface GlassdoorReviewsOptions {
 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 -
+     * `url` is required. Addressing by employer_id costs two lookups -
      * pass salaries_url from company() as `url` instead.
      */
     employer_id?: string;
@@ -3432,7 +3544,7 @@ declare class GlassdoorNamespace {
      * 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
+     * reviews() and salaries() to halve the lookups. `employer_id` or
      * `url` is required - `company` is cosmetic and does not satisfy it.
      *
      * Costs 1 credit. Single response, no pagination. Typically ~3-47s.
@@ -4093,7 +4205,7 @@ declare class SECNamespace {
      * filer had more.
      *
      * Costs 1 credit - including with `include_history`, which is the one call
-     * that can buy more than one upstream fetch.
+     * that can buy more than one lookup.
      */
     filings(options: SECFilingsOptions): Promise<Record<string, unknown>>;
     /**
@@ -5721,7 +5833,7 @@ interface ExtractOptions {
      *
      * - "normal": the standard fetch - 1 credit.
      * - "advanced": renders JavaScript, for JS-built pages - 1 credit.
-     * - "ultra": the hardest pages and bot walls - 2 credits.
+     * - "ultra": the hardest pages - 2 credits.
      */
     mode?: "normal" | "advanced" | "ultra";
     [key: string]: unknown;
@@ -5903,4 +6015,4 @@ declare class ScavioJobTimeoutError extends ScavioError {
     constructor(jobType: "crawl" | "batch", jobId: string, statusUrl: string, lastStatus: string);
 }
 
-export { type AirbnbListingOptions, AirbnbNamespace, type AirbnbReviewsOptions, type AirbnbSearchOptions, AmazonNamespace, type AmazonOffersOptions, type AmazonProductOptions, type AmazonSearchOptions, type AppStoreAppOptions, AppStoreNamespace, type AppStoreReviewsOptions, type AppStoreSearchOptions, BadRequestError, type BookingHotelOptions, BookingNamespace, type BookingReviewsOptions, type BookingSearchOptions, CapterraNamespace, type CapterraProductOptions, type CapterraReviewsOptions, type CapterraSearchOptions, type CompaniesHouseCompanyOptions, type CompaniesHouseFilingHistoryOptions, CompaniesHouseNamespace, type CompaniesHouseOfficersOptions, type CompaniesHouseSearchOptions, type CostcoAutocompleteOptions, type CostcoAvailabilityOptions, type CostcoCategoriesOptions, type CostcoCategoryOptions, type CostcoClearanceOptions, type CostcoCountry, type CostcoCouponsOptions, type CostcoDealType, type CostcoDealsOptions, type CostcoGasOptions, type CostcoListingFilters, type CostcoNaCountry, CostcoNamespace, type CostcoPriceCode, type CostcoPricesOptions, type CostcoProductOptions, type CostcoReviewsOptions, type CostcoSearchOptions, type CostcoSortBy, type CostcoWarehousesOptions, DEFAULT_MAX_REQUESTS_PER_SECOND, EbayNamespace, type EbayProductOptions, type EbaySearchOptions, type EbaySellerOptions, type Extract, type ExtractBatchOptions, type ExtractCrawlOptions, type ExtractFormat, type ExtractJobCreatedResponse, type ExtractJobRequestOptions, type ExtractJobResult, type ExtractJobState, type ExtractJobStatusQuery, type ExtractJobStatusResponse, type ExtractJobSummary, type ExtractJobSummaryResponse, type ExtractJobWaitResponse, type ExtractMapLink, type ExtractMapOptions, type ExtractMapResponse, type ExtractMode, ExtractNamespace, type ExtractOptions, type ExtractSitemapMode, G2Namespace, type G2ProductOptions, type G2ReviewsOptions, type G2SearchOptions, type GlassdoorCompaniesOptions, type GlassdoorCompanyOptions, GlassdoorNamespace, type GlassdoorReviewsOptions, type GlassdoorSalariesOptions, type GoogleAdsAdvertisersOptions, type GoogleAdsCreativeOptions, GoogleAdsNamespace, type GoogleAdsSearchOptions, type GoogleAiModeOptions, type GoogleFlightsOptions, type GoogleHotelsDetailOptions, type GoogleHotelsOptions, type GoogleMapsPlaceOptions, type GoogleMapsReviewsOptions, type GoogleMapsSearchOptions, GoogleNamespace, type GoogleNewsOptions, type GooglePlayAppOptions, GooglePlayNamespace, type GooglePlayReviewsOptions, type GooglePlaySearchOptions, type GoogleSearchOptions, type GoogleShoppingOptions, type GoogleShoppingProductOptions, type GoogleShoppingStoresOptions, type GoogleTrendingOptions, type GoogleTrendsOptions, HomeDepotNamespace, type HomeDepotProductOptions, type HomeDepotReviewsOptions, type HomeDepotSearchOptions, type IndeedCompanyOptions, type IndeedCompanyReviewsOptions, type IndeedJobOptions, IndeedNamespace, type IndeedSearchOptions, type InstagramCommentRepliesOptions, type InstagramFollowOptions, type InstagramHighlightStoriesOptions, type InstagramKeywordOptions, type InstagramMusicPostsOptions, InstagramNamespace, type InstagramPostCommentsOptions, type InstagramPostLikersOptions, type InstagramPostOptions, type InstagramProfileOptions, type InstagramSearchOptions, type InstagramStoriesOptions, type InstagramUserFeedOptions, type InstagramUserRefOptions, InsufficientCreditsError, InvalidAPIKeyError, type KuaishouCommentRepliesOptions, KuaishouNamespace, type KuaishouProfileOptions, type KuaishouSearchLiveOptions, type KuaishouSearchOptions, type KuaishouSearchUsersOptions, type KuaishouSearchVideosOptions, type KuaishouTagFeedOptions, type KuaishouTrendingOptions, type KuaishouUserLiveOptions, type KuaishouUserPostsOptions, type KuaishouUserResolveOptions, type KuaishouVideoCommentsOptions, type KuaishouVideoOptions, type KuaishouVideosBatchOptions, type LinkedInCompanyOptions, type LinkedInCompanyPostsOptions, type LinkedInCompanyPostsRequest, type LinkedInCompanyRefOptions, type LinkedInJobOptions, LinkedInNamespace, type LinkedInPersonContactOptions, type LinkedInPersonOptions, type LinkedInPersonPostsOptions, type LinkedInPersonPostsRequest, type LinkedInPersonRefOptions, type LinkedInPostCommentsOptions, type LinkedInPostOptions, type LinkedInSearchJobsOptions, type LinkedInSearchPeopleOptions, type LinkedInSearchPostsOptions, MAX_REQUESTS_PER_SECOND, type MercadoLibreBestSellersCountry, type MercadoLibreBestSellersOptions, type MercadoLibreCondition, type MercadoLibreCountry, type MercadoLibreDiscount, MercadoLibreNamespace, type MercadoLibreProductOptions, type MercadoLibreQuestionsOptions, type MercadoLibreReviewsOptions, type MercadoLibreSearchOptions, type MercadoLibreSort, type MetaAdsAdOptions, type MetaAdsAdvertiserOptions, MetaAdsNamespace, type MetaAdsSearchOptions, MissingAPIKeyError, NotFoundError, RateLimitError, type RealtorAgentOptions, type RealtorAgentsOptions, type RealtorListingStatus, type RealtorLocationsOptions, type RealtorMarketOptions, RealtorNamespace, type RealtorPropertyOptions, type RealtorPropertyType, type RealtorSearchOptions, type RealtorSort, type RedditCommentRepliesOptions, type RedditCommentSearchSort, type RedditFeedSort, RedditNamespace, type RedditPopularOptions, type RedditPostCommentsOptions, type RedditPostOptions, type RedditSearchCommentsOptions, type RedditSearchOptions, type RedditSearchSubredditsOptions, type RedditSearchSuggestionsOptions, type RedditSort, type RedditSubredditOptions, type RedditSubredditPostsOptions, type RedditUserFeedOptions, type RedditUserOptions, type RedfinMarketOptions, RedfinNamespace, type RedfinPropertyOptions, type RedfinSearchOptions, type RightmoveAgentOptions, type RightmoveAgentsOptions, type RightmoveExclude, type RightmoveFurnishing, type RightmoveLetType, type RightmoveListingStatus, type RightmoveLocationsOptions, type RightmoveMustHave, RightmoveNamespace, type RightmovePropertyOptions, type RightmovePropertyType, type RightmoveRadius, type RightmoveSearchOptions, type RightmoveSoldOptions, type RightmoveSoldPropertyOptions, type RightmoveSoldPropertyType, type RightmoveSoldSort, type RightmoveSort, type RightmoveTenure, type SECCompanyOptions, type SECConceptOptions, type SECFactsOptions, type SECFilingsOptions, type SECLookupOptions, SECNamespace, type SECSearchOptions, Scavio, ScavioAPIError, type ScavioConfig, ScavioConnectionError, ScavioError, ScavioJobTimeoutError, ScavioTimeoutError, type TargetCategoryOptions, TargetNamespace, type TargetProductOptions, type TargetReviewsOptions, type TargetSearchOptions, ThreadsNamespace, type ThreadsPostCommentsOptions, type ThreadsPostOptions, type ThreadsProfileOptions, type ThreadsSearchUsersOptions, type ThreadsUserPostsOptions, type ThreadsUserRepliesOptions, type TikTokCommentRepliesOptions, type TikTokHashtagOptions, type TikTokHashtagVideosOptions, type TikTokMusicChartOptions, type TikTokMusicOptions, type TikTokMusicVideosOptions, TikTokNamespace, type TikTokPlaylistVideosOptions, type TikTokProfileOptions, type TikTokSearchMusicOptions, type TikTokSearchSuggestionsOptions, type TikTokSearchUsersOptions, type TikTokSearchVideosOptions, type TikTokShopCategoryProductsOptions, type TikTokShopListingRegion, TikTokShopNamespace, type TikTokShopProductOptions, type TikTokShopProductReviewsOptions, type TikTokShopRegion, type TikTokShopResolveOptions, type TikTokShopReviewSort, type TikTokShopSearchOptions, type TikTokShopShopProductsOptions, type TikTokShopSuggestionsOptions, type TikTokTrendingVideosOptions, type TikTokUserFollowersOptions, type TikTokUserFollowingsOptions, type TikTokUserPlaylistsOptions, type TikTokUserPostsOptions, type TikTokUserSimilarOptions, type TikTokUsernameOptions, type TikTokVideoCommentsOptions, type TikTokVideoOptions, type TikTokVideoTranscriptOptions, type TripadvisorLocationOptions, type TripadvisorLocationsOptions, TripadvisorNamespace, type TripadvisorReviewsOptions, type TripadvisorSearchOptions, type TrustpilotBusinessAddress, type TrustpilotBusinessOptions, type TrustpilotCategoriesOptions, type TrustpilotCategoryOptions, type TrustpilotCategorySort, TrustpilotNamespace, type TrustpilotReviewOptions, type TrustpilotReviewsDateRange, type TrustpilotReviewsOptions, type TrustpilotReviewsSort, type TrustpilotSearchOptions, type TrustpilotStars, type WalmartCategoryOptions, WalmartNamespace, type WalmartOffersOptions, type WalmartProductOptions, type WalmartReviewsOptions, type WalmartSearchOptions, type WalmartSellerOptions, type WalmartSellerProductsOptions, type WalmartStore, type WalmartStoresData, type WalmartStoresOptions, type WalmartStoresResponse, type XCommunityOptions, type XCommunityTweetsOptions, XNamespace, type XSearchCommunitiesOptions, type XSearchOptions, type XTrendingOptions, type XTweetCommentsOptions, type XTweetOptions, type XTweetRetweetersOptions, type XUserFeedOptions, type XUserOptions, type YelpBusinessOptions, YelpNamespace, type YelpReviewsOptions, type YelpSearchOptions, type YouTubeChannelCommunityOptions, type YouTubeChannelOptions, type YouTubeChannelResolveOptions, type YouTubeChannelSearchOptions, type YouTubeChannelShortsOptions, type YouTubeChannelVideosOptions, type YouTubeCommentRepliesOptions, type YouTubeCommentsOptions, type YouTubeCommunityPostCommentsOptions, type YouTubeCommunityPostOptions, type YouTubeMetadataOptions, YouTubeNamespace, type YouTubeRelatedOptions, type YouTubeSearchOptions, type YouTubeShortsOptions, type YouTubeStreamsOptions, type YouTubeSuggestionsOptions, type YouTubeTranscriptOptions, type YouTubeVideoOptions, type ZillowAgentReviewsOptions, ZillowNamespace, type ZillowPropertyOptions, type ZillowSearchOptions, verifyWebhook };
+export { type AirbnbListingOptions, AirbnbNamespace, type AirbnbReviewsOptions, type AirbnbSearchOptions, AmazonNamespace, type AmazonOffersOptions, type AmazonProductOptions, type AmazonSearchOptions, type AppStoreAppOptions, AppStoreNamespace, type AppStoreReviewsOptions, type AppStoreSearchOptions, BadRequestError, type BookingHotelOptions, BookingNamespace, type BookingReviewsOptions, type BookingSearchOptions, CapterraNamespace, type CapterraProductOptions, type CapterraReviewsOptions, type CapterraSearchOptions, type CompaniesHouseCompanyOptions, type CompaniesHouseFilingHistoryOptions, CompaniesHouseNamespace, type CompaniesHouseOfficersOptions, type CompaniesHouseSearchOptions, type CostcoAutocompleteOptions, type CostcoAvailabilityOptions, type CostcoCategoriesOptions, type CostcoCategoryOptions, type CostcoClearanceOptions, type CostcoCountry, type CostcoCouponsOptions, type CostcoDealType, type CostcoDealsOptions, type CostcoGasOptions, type CostcoListingFilters, type CostcoNaCountry, CostcoNamespace, type CostcoPriceCode, type CostcoPricesOptions, type CostcoProductOptions, type CostcoReviewsOptions, type CostcoSearchOptions, type CostcoSortBy, type CostcoWarehousesOptions, DEFAULT_MAX_REQUESTS_PER_SECOND, EbayNamespace, type EbayProductOptions, type EbaySearchOptions, type EbaySellerOptions, type Extract, type ExtractBatchOptions, type ExtractCrawlOptions, type ExtractFormat, type ExtractJobCreatedResponse, type ExtractJobRequestOptions, type ExtractJobResult, type ExtractJobState, type ExtractJobStatusQuery, type ExtractJobStatusResponse, type ExtractJobSummary, type ExtractJobSummaryResponse, type ExtractJobWaitResponse, type ExtractMapLink, type ExtractMapOptions, type ExtractMapResponse, type ExtractMode, ExtractNamespace, type ExtractOptions, type ExtractSitemapMode, G2Namespace, type G2ProductOptions, type G2ReviewsOptions, type G2SearchOptions, type GlassdoorCompaniesOptions, type GlassdoorCompanyOptions, GlassdoorNamespace, type GlassdoorReviewsOptions, type GlassdoorSalariesOptions, type GoogleAdsAdvertisersOptions, type GoogleAdsCreativeOptions, GoogleAdsNamespace, type GoogleAdsSearchOptions, type GoogleAiModeOptions, type GoogleCustomSearchItem, type GoogleCustomSearchOptions, type GoogleCustomSearchQuery, type GoogleCustomSearchResponse, 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, type InstagramHighlightStoriesOptions, type InstagramKeywordOptions, type InstagramMusicPostsOptions, InstagramNamespace, type InstagramPostCommentsOptions, type InstagramPostLikersOptions, type InstagramPostOptions, type InstagramProfileOptions, type InstagramSearchOptions, type InstagramStoriesOptions, type InstagramUserFeedOptions, type InstagramUserRefOptions, InsufficientCreditsError, InvalidAPIKeyError, type KuaishouCommentRepliesOptions, KuaishouNamespace, type KuaishouProfileOptions, type KuaishouSearchLiveOptions, type KuaishouSearchOptions, type KuaishouSearchUsersOptions, type KuaishouSearchVideosOptions, type KuaishouTagFeedOptions, type KuaishouTrendingOptions, type KuaishouUserLiveOptions, type KuaishouUserPostsOptions, type KuaishouUserResolveOptions, type KuaishouVideoCommentsOptions, type KuaishouVideoOptions, type KuaishouVideosBatchOptions, type LinkedInCompanyOptions, type LinkedInCompanyPostsOptions, type LinkedInCompanyPostsRequest, type LinkedInCompanyRefOptions, type LinkedInJobOptions, LinkedInNamespace, type LinkedInPersonContactOptions, type LinkedInPersonOptions, type LinkedInPersonPostsOptions, type LinkedInPersonPostsRequest, type LinkedInPersonRefOptions, type LinkedInPostCommentsOptions, type LinkedInPostOptions, type LinkedInSearchJobsOptions, type LinkedInSearchPeopleOptions, type LinkedInSearchPostsOptions, MAX_REQUESTS_PER_SECOND, type MercadoLibreBestSellersCountry, type MercadoLibreBestSellersOptions, type MercadoLibreCondition, type MercadoLibreCountry, type MercadoLibreDiscount, MercadoLibreNamespace, type MercadoLibreProductOptions, type MercadoLibreQuestionsOptions, type MercadoLibreReviewsOptions, type MercadoLibreSearchOptions, type MercadoLibreSort, type MetaAdsAdOptions, type MetaAdsAdvertiserOptions, MetaAdsNamespace, type MetaAdsSearchOptions, MissingAPIKeyError, NotFoundError, RateLimitError, type RealtorAgentOptions, type RealtorAgentsOptions, type RealtorListingStatus, type RealtorLocationsOptions, type RealtorMarketOptions, RealtorNamespace, type RealtorPropertyOptions, type RealtorPropertyType, type RealtorSearchOptions, type RealtorSort, type RedditCommentRepliesOptions, type RedditCommentSearchSort, type RedditFeedSort, RedditNamespace, type RedditPopularOptions, type RedditPostCommentsOptions, type RedditPostOptions, type RedditSearchCommentsOptions, type RedditSearchOptions, type RedditSearchSubredditsOptions, type RedditSearchSuggestionsOptions, type RedditSort, type RedditSubredditOptions, type RedditSubredditPostsOptions, type RedditUserFeedOptions, type RedditUserOptions, type RedfinMarketOptions, RedfinNamespace, type RedfinPropertyOptions, type RedfinSearchOptions, type RightmoveAgentOptions, type RightmoveAgentsOptions, type RightmoveExclude, type RightmoveFurnishing, type RightmoveLetType, type RightmoveListingStatus, type RightmoveLocationsOptions, type RightmoveMustHave, RightmoveNamespace, type RightmovePropertyOptions, type RightmovePropertyType, type RightmoveRadius, type RightmoveSearchOptions, type RightmoveSoldOptions, type RightmoveSoldPropertyOptions, type RightmoveSoldPropertyType, type RightmoveSoldSort, type RightmoveSort, type RightmoveTenure, type SECCompanyOptions, type SECConceptOptions, type SECFactsOptions, type SECFilingsOptions, type SECLookupOptions, SECNamespace, type SECSearchOptions, Scavio, ScavioAPIError, type ScavioConfig, ScavioConnectionError, ScavioError, ScavioJobTimeoutError, ScavioTimeoutError, type TargetCategoryOptions, TargetNamespace, type TargetProductOptions, type TargetReviewsOptions, type TargetSearchOptions, ThreadsNamespace, type ThreadsPostCommentsOptions, type ThreadsPostOptions, type ThreadsProfileOptions, type ThreadsSearchUsersOptions, type ThreadsUserPostsOptions, type ThreadsUserRepliesOptions, type TikTokCommentRepliesOptions, type TikTokHashtagOptions, type TikTokHashtagVideosOptions, type TikTokMusicChartOptions, type TikTokMusicOptions, type TikTokMusicVideosOptions, TikTokNamespace, type TikTokPlaylistVideosOptions, type TikTokProfileOptions, type TikTokSearchMusicOptions, type TikTokSearchSuggestionsOptions, type TikTokSearchUsersOptions, type TikTokSearchVideosOptions, type TikTokShopCategoryProductsOptions, type TikTokShopListingRegion, TikTokShopNamespace, type TikTokShopProductOptions, type TikTokShopProductReviewsOptions, type TikTokShopRegion, type TikTokShopResolveOptions, type TikTokShopReviewSort, type TikTokShopSearchOptions, type TikTokShopShopProductsOptions, type TikTokShopSuggestionsOptions, type TikTokTrendingVideosOptions, type TikTokUserFollowersOptions, type TikTokUserFollowingsOptions, type TikTokUserPlaylistsOptions, type TikTokUserPostsOptions, type TikTokUserSimilarOptions, type TikTokUsernameOptions, type TikTokVideoCommentsOptions, type TikTokVideoOptions, type TikTokVideoTranscriptOptions, type TripadvisorLocationOptions, type TripadvisorLocationsOptions, TripadvisorNamespace, type TripadvisorReviewsOptions, type TripadvisorSearchOptions, type TrustpilotBusinessAddress, type TrustpilotBusinessOptions, type TrustpilotCategoriesOptions, type TrustpilotCategoryOptions, type TrustpilotCategorySort, TrustpilotNamespace, type TrustpilotReviewOptions, type TrustpilotReviewsDateRange, type TrustpilotReviewsOptions, type TrustpilotReviewsSort, type TrustpilotSearchOptions, type TrustpilotStars, type WalmartCategoryOptions, WalmartNamespace, type WalmartOffersOptions, type WalmartProductOptions, type WalmartReviewsOptions, type WalmartSearchOptions, type WalmartSellerOptions, type WalmartSellerProductsOptions, type WalmartStore, type WalmartStoresData, type WalmartStoresOptions, type WalmartStoresResponse, type XCommunityOptions, type XCommunityTweetsOptions, XNamespace, type XSearchCommunitiesOptions, type XSearchOptions, type XTrendingOptions, type XTweetCommentsOptions, type XTweetOptions, type XTweetRetweetersOptions, type XUserFeedOptions, type XUserOptions, type YelpBusinessOptions, YelpNamespace, type YelpReviewsOptions, type YelpSearchOptions, type YouTubeChannelCommunityOptions, type YouTubeChannelOptions, type YouTubeChannelResolveOptions, type YouTubeChannelSearchOptions, type YouTubeChannelShortsOptions, type YouTubeChannelVideosOptions, type YouTubeCommentRepliesOptions, type YouTubeCommentsOptions, type YouTubeCommunityPostCommentsOptions, type YouTubeCommunityPostOptions, type YouTubeMetadataOptions, YouTubeNamespace, type YouTubeRelatedOptions, type YouTubeSearchOptions, type YouTubeShortsOptions, type YouTubeStreamsOptions, type YouTubeSuggestionsOptions, type YouTubeTranscriptOptions, type YouTubeVideoOptions, type ZillowAgentReviewsOptions, ZillowNamespace, type ZillowPropertyOptions, type ZillowSearchOptions, verifyWebhook };

package/dist/index.js

@@ -145,7 +145,7 @@ function parseRetryAfter(header) {
 var BASE_URL = "https://api.scavio.dev";
 var DEFAULT_TIMEOUT = 3e4;
 var DEFAULT_MAX_RETRIES = 2;
-var SDK_VERSION = true ? "0.24.0" : "0.0.0";
+var SDK_VERSION = true ? "0.25.0" : "0.0.0";
 var USER_AGENT = `scavio-js/${SDK_VERSION}`;
 function isServerRuntime() {
   const g = globalThis;
@@ -334,6 +334,15 @@ var AmazonNamespace = class {
 };
 
 // src/namespaces/google.ts
+var CUSTOM_SEARCH_WIRE = {
+  date_restrict: "dateRestrict",
+  site_search: "siteSearch",
+  site_search_filter: "siteSearchFilter",
+  exact_terms: "exactTerms",
+  exclude_terms: "excludeTerms",
+  or_terms: "orTerms",
+  file_type: "fileType"
+};
 var GoogleNamespace = class {
   constructor(client) {
     this.client = client;
@@ -343,6 +352,21 @@ var GoogleNamespace = class {
   async search(options) {
     return this.client._post("/api/v2/google", options);
   }
+  /**
+   * Google search in the Custom Search JSON API format: a drop-in for cse.list.
+   * Returns customsearch#search (items[], searchInformation, queries.nextPage)
+   * plus a scavio billing object, so CSE parsing code keeps working. For the
+   * full SERP (knowledge graph, AI overview, People Also Ask) use search().
+   * Unsupported CSE params (image search, sort, rights) throw BadRequestError.
+   * 1 credit.
+   */
+  async customSearch(options) {
+    const body = {};
+    for (const [key, value] of Object.entries(options)) {
+      body[CUSTOM_SEARCH_WIRE[key] ?? key] = value;
+    }
+    return await this.client._post("/api/v1/google/customsearch", body);
+  }
   /** Google AI Mode answer. */
   async aiMode(options) {
     return this.client._post("/api/v2/google/ai-mode", options);
@@ -1105,14 +1129,14 @@ var LinkedInNamespace = class {
     return this.client._post("/api/v1/linkedin/post/comments", options);
   }
   /**
-   * @deprecated Retired by the upstream provider. Always returns HTTP 410 and is
+   * @deprecated Retired. Always returns HTTP 410 and is
    * never billed.
    */
   async personContact(options) {
     return this.client._post("/api/v1/linkedin/person/contact", options);
   }
   /**
-   * @deprecated Retired by the upstream provider. Always returns HTTP 410 and is
+   * @deprecated Retired. Always returns HTTP 410 and is
    * never billed. `company()` returns `featured_employees`, a small sample of
    * staff profiles.
    */
@@ -1120,21 +1144,21 @@ var LinkedInNamespace = class {
     return this.client._post("/api/v1/linkedin/company/people", options);
   }
   /**
-   * @deprecated Retired by the upstream provider. Always returns HTTP 410 and is
+   * @deprecated Retired. Always returns HTTP 410 and is
    * never billed. Use `searchJobs()` with the company name as the search term.
    */
   async companyJobs(options) {
     return this.client._post("/api/v1/linkedin/company/jobs", options);
   }
   /**
-   * @deprecated Retired by the upstream provider. Always returns HTTP 410 and is
+   * @deprecated Retired. Always returns HTTP 410 and is
    * never billed.
    */
   async searchPeople(options) {
     return this.client._post("/api/v1/linkedin/search/people", options);
   }
   /**
-   * @deprecated Retired by the upstream provider. Always returns HTTP 410 and is
+   * @deprecated Retired. Always returns HTTP 410 and is
    * never billed.
    */
   async searchPosts(options) {
@@ -1394,7 +1418,7 @@ var TargetNamespace = class {
    * 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.
+   * Costs 1 credit. Typically ~9s.
    */
   async search(options) {
     return this.client._post("/api/v1/target/search", options);
@@ -1560,9 +1584,8 @@ var RedfinNamespace = class {
    * 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().
+   * Returns the whole property page in one call, which is why it is the same
+   * price as search().
    *
    * Costs 1 credit. Single response, no pagination.
    */
@@ -1792,7 +1815,7 @@ var YelpNamespace = class {
    * count.
    *
    * `term` + `location` or `url` is required, and `location` is effectively
-   * mandatory - Yelp geolocates a location-less search off the proxy exit.
+   * mandatory - without it Yelp picks a location itself.
    * Paged with `page`; the page size is fixed at 10.
    *
    * Costs 2 credits.
@@ -1864,8 +1887,7 @@ var IndeedNamespace = class {
    * 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.
+   * Single response, no pagination. An unknown job key is a real 404 and IS BILLED - take `job_id` from a search row.
    *
    * Costs 2 credits.
    */
@@ -1877,8 +1899,7 @@ var IndeedNamespace = class {
    * 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.
+   * Single response, no pagination. An unknown company slug is a real 404 and IS BILLED.
    *
    * Costs 2 credits.
    */
@@ -1926,7 +1947,7 @@ var GlassdoorNamespace = class {
    * 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
+   * reviews() and salaries() to halve the lookups. `employer_id` or
    * `url` is required - `company` is cosmetic and does not satisfy it.
    *
    * Costs 1 credit. Single response, no pagination. Typically ~3-47s.
@@ -2250,7 +2271,7 @@ var SECNamespace = class {
    * filer had more.
    *
    * Costs 1 credit - including with `include_history`, which is the one call
-   * that can buy more than one upstream fetch.
+   * that can buy more than one lookup.
    */
   async filings(options) {
     return this.client._post("/api/v1/sec/filings", options);