scrapebadger 0.29.0 → 0.30.0

package/dist/index.mjs

@@ -5699,8 +5699,227 @@ var EbayClient = class {
   }
 };
 
-// src/youtube/search.ts
+// src/walmart/search.ts
 var SearchClient9 = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Search walmart.com.
+   *
+   * @param query - Search keywords, e.g. `"laptop"`.
+   * @param params - Optional page (1-10), sort, price and facet filters.
+   * @returns A page of ~40-60 organic products.
+   *
+   * @remarks
+   * Results dry up after page 10 regardless of `total_results_reported`; bound
+   * a crawl with `max_page`. Sponsored ad tiles are dropped, sponsored
+   * *products* are returned and flagged `is_sponsored`.
+   */
+  async search(query, params = {}) {
+    return this.client.request("/v1/walmart/search", {
+      params: {
+        query,
+        page: params.page,
+        sort: params.sort,
+        min_price: params.min_price,
+        max_price: params.max_price,
+        facet: params.facet
+      }
+    });
+  }
+  /**
+   * Browse a Walmart category. Same result shape as {@link search}.
+   *
+   * @param path - Browse path, e.g. `"electronics/3944"`, or a `/cp/...` path.
+   * @param params - Optional page (1-11), price and facet filters.
+   *
+   * @remarks
+   * No `sort`: Walmart's browse pages ignore it (verified). Sort on
+   * {@link search} instead.
+   */
+  async category(path, params = {}) {
+    return this.client.request("/v1/walmart/category", {
+      params: {
+        path,
+        page: params.page,
+        min_price: params.min_price,
+        max_price: params.max_price,
+        facet: params.facet
+      }
+    });
+  }
+  /**
+   * Walmart's current deals, rollbacks and clearance.
+   *
+   * @param params - Optional page (1-11) and price filters.
+   */
+  async deals(params = {}) {
+    return this.client.request("/v1/walmart/deals", {
+      params: {
+        page: params.page,
+        min_price: params.min_price,
+        max_price: params.max_price
+      }
+    });
+  }
+  /**
+   * Walmart search-box suggestions — the cheapest call in this API.
+   *
+   * @param query - Partial search term, e.g. `"lapt"`.
+   */
+  async autocomplete(query) {
+    return this.client.request("/v1/walmart/autocomplete", {
+      params: { query }
+    });
+  }
+};
+
+// src/walmart/products.ts
+var ProductsClient4 = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get full product detail.
+   *
+   * @param itemId - Walmart `usItemId`, e.g. `"5689919121"`.
+   * @throws NotFoundError - If the item doesn't exist.
+   *
+   * @remarks
+   * Only the numeric id is needed — the SEO slug is decorative and ignored by
+   * Walmart's router. Prices and availability are store-specific; the resolved
+   * store is on `location`.
+   */
+  async get(itemId) {
+    return this.client.request(`/v1/walmart/products/${itemId}`);
+  }
+  /**
+   * Get paginated customer reviews with the full star histogram.
+   *
+   * @param itemId - Walmart `usItemId`.
+   * @param params - Optional page (1-100) and sort.
+   * @returns Reviews plus the rating breakdown, aspects, and the most-helpful
+   *   positive and negative reviews.
+   *
+   * @remarks 10 reviews per page — Walmart's page size, not adjustable.
+   */
+  async reviews(itemId, params = {}) {
+    return this.client.request(
+      `/v1/walmart/products/${itemId}/reviews`,
+      { params: { page: params.page, sort: params.sort } }
+    );
+  }
+};
+
+// src/walmart/sellers.ts
+var SellersClient3 = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get a marketplace seller's profile — contact details, address, rating,
+   * policies.
+   *
+   * @param sellerId - Numeric catalog seller id, e.g. `"101040442"`. This is
+   *   the `seller.catalog_seller_id` on a product — NOT the 32-char hex
+   *   `seller_id`, which 404s as a storefront URL.
+   *
+   * @remarks
+   * No page parameter and no product list: adding `?page=` makes Walmart's own
+   * SSR throw. Use {@link products} for the catalogue.
+   */
+  async get(sellerId) {
+    return this.client.request(`/v1/walmart/sellers/${sellerId}`);
+  }
+  /**
+   * List a marketplace seller's catalogue.
+   *
+   * @param sellerId - Numeric catalog seller id.
+   * @param query - Search term scoping the catalogue. REQUIRED — this goes
+   *   through search with a `retailer_id` facet, and the facet alone returns
+   *   zero results.
+   * @param params - Optional page (1-10) and sort.
+   */
+  async products(sellerId, query, params = {}) {
+    return this.client.request(
+      `/v1/walmart/sellers/${sellerId}/products`,
+      { params: { query, page: params.page, sort: params.sort } }
+    );
+  }
+};
+
+// src/walmart/stores.ts
+var StoresClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get store detail plus every store around it.
+   *
+   * @param storeId - Walmart store number, e.g. `"100"`.
+   * @returns The store's address, geo, phone, opening hours and per-department
+   *   services (each with its own hours and phone), plus ~30 nearby stores.
+   */
+  async get(storeId) {
+    return this.client.request(`/v1/walmart/stores/${storeId}`);
+  }
+};
+
+// src/walmart/reference.ts
+var ReferenceClient6 = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get the supported Walmart markets.
+   *
+   * @remarks
+   * Only walmart.com (US) is supported — walmart.ca and walmart.com.mx run on
+   * different platforms with different payload shapes, so they are not claimed
+   * here rather than shipped broken.
+   */
+  async markets() {
+    return this.client.request("/v1/walmart/markets");
+  }
+  /**
+   * Check the health of the Walmart scraper service.
+   *
+   * @returns The raw health payload from the scraper service.
+   */
+  async health() {
+    return this.client.request("/v1/walmart/health");
+  }
+};
+
+// src/walmart/client.ts
+var WalmartClient = class {
+  /** Client for search, category browse, deals and autocomplete */
+  search;
+  /** Client for product detail and reviews */
+  products;
+  /** Client for marketplace seller profile and catalogue */
+  sellers;
+  /** Client for store detail and nearby stores */
+  stores;
+  /** Client for reference data (markets) and service health */
+  reference;
+  /**
+   * Create a new Walmart client.
+   *
+   * @param client - The base HTTP client for making requests.
+   */
+  constructor(client) {
+    this.search = new SearchClient9(client);
+    this.products = new ProductsClient4(client);
+    this.sellers = new SellersClient3(client);
+    this.stores = new StoresClient(client);
+    this.reference = new ReferenceClient6(client);
+  }
+};
+
+// src/youtube/search.ts
+var SearchClient10 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6225,7 +6444,7 @@ var MusicClient2 = class {
 };
 
 // src/youtube/reference.ts
-var ReferenceClient6 = class {
+var ReferenceClient7 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6293,7 +6512,7 @@ var YoutubeClient = class {
    * @param client - The base HTTP client for making requests.
    */
   constructor(client) {
-    this.search = new SearchClient9(client);
+    this.search = new SearchClient10(client);
     this.videos = new VideosClient3(client);
     this.channels = new ChannelsClient(client);
     this.playlists = new PlaylistsClient(client);
@@ -6301,12 +6520,12 @@ var YoutubeClient = class {
     this.shorts = new ShortsClient2(client);
     this.trending = new TrendingClient2(client);
     this.music = new MusicClient2(client);
-    this.reference = new ReferenceClient6(client);
+    this.reference = new ReferenceClient7(client);
   }
 };
 
 // src/realtor/search.ts
-var SearchClient10 = class {
+var SearchClient11 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6380,7 +6599,7 @@ var PropertiesClient = class {
 };
 
 // src/realtor/reference.ts
-var ReferenceClient7 = class {
+var ReferenceClient8 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6409,14 +6628,14 @@ var RealtorClient = class {
    * @param client - The base HTTP client for making requests.
    */
   constructor(client) {
-    this.search = new SearchClient10(client);
+    this.search = new SearchClient11(client);
     this.properties = new PropertiesClient(client);
-    this.reference = new ReferenceClient7(client);
+    this.reference = new ReferenceClient8(client);
   }
 };
 
 // src/leboncoin/search.ts
-var SearchClient11 = class {
+var SearchClient12 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6485,7 +6704,7 @@ var AdsClient2 = class {
 };
 
 // src/leboncoin/sellers.ts
-var SellersClient3 = class {
+var SellersClient4 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6518,7 +6737,7 @@ var SellersClient3 = class {
 };
 
 // src/leboncoin/reference.ts
-var ReferenceClient8 = class {
+var ReferenceClient9 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6589,15 +6808,15 @@ var LeboncoinClient = class {
    * @param client - The base HTTP client for making requests.
    */
   constructor(client) {
-    this.search = new SearchClient11(client);
+    this.search = new SearchClient12(client);
     this.ads = new AdsClient2(client);
-    this.sellers = new SellersClient3(client);
-    this.reference = new ReferenceClient8(client);
+    this.sellers = new SellersClient4(client);
+    this.reference = new ReferenceClient9(client);
   }
 };
 
 // src/zillow/search.ts
-var SearchClient12 = class {
+var SearchClient13 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6701,7 +6920,7 @@ var AgentClient = class {
 };
 
 // src/zillow/reference.ts
-var ReferenceClient9 = class {
+var ReferenceClient10 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6732,10 +6951,10 @@ var ZillowClient = class {
    * @param client - The base HTTP client for making requests.
    */
   constructor(client) {
-    this.search = new SearchClient12(client);
+    this.search = new SearchClient13(client);
     this.properties = new PropertiesClient2(client);
     this.agent = new AgentClient(client);
-    this.reference = new ReferenceClient9(client);
+    this.reference = new ReferenceClient10(client);
   }
 };
 
@@ -6870,7 +7089,7 @@ var ImmobiliareClient = class {
 };
 
 // src/loopnet/search.ts
-var SearchClient13 = class {
+var SearchClient14 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6951,7 +7170,7 @@ var BrokersClient = class {
 };
 
 // src/loopnet/reference.ts
-var ReferenceClient10 = class {
+var ReferenceClient11 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6994,10 +7213,10 @@ var LoopNetClient = class {
    * @param client - The base HTTP client for making requests.
    */
   constructor(client) {
-    this.search = new SearchClient13(client);
+    this.search = new SearchClient14(client);
     this.listings = new ListingsClient2(client);
     this.brokers = new BrokersClient(client);
-    this.reference = new ReferenceClient10(client);
+    this.reference = new ReferenceClient11(client);
   }
 };
 
@@ -7358,7 +7577,7 @@ var BrandClient = class {
 };
 
 // src/chatgpt/reference.ts
-var ReferenceClient11 = class {
+var ReferenceClient12 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -7404,7 +7623,7 @@ var ChatGPTClient = class {
   constructor(client) {
     this.ask = new AskClient(client);
     this.brand = new BrandClient(client);
-    this.reference = new ReferenceClient11(client);
+    this.reference = new ReferenceClient12(client);
   }
 };
 
@@ -7435,6 +7654,8 @@ var ScrapeBadger = class {
   tiktok;
   /** eBay scraper API client — 12 endpoints across 18 markets */
   ebay;
+  /** Walmart scraper API client — 11 endpoints (walmart.com, US-only) */
+  walmart;
   /** YouTube scraper API client — 39 endpoints */
   youtube;
   /** Realtor scraper API client — 4 endpoints across 2 markets (us, ca) */
@@ -7499,6 +7720,7 @@ var ScrapeBadger = class {
     this.shopee = new ShopeeClient(this.baseClient);
     this.tiktok = new TikTokClient(this.baseClient);
     this.ebay = new EbayClient(this.baseClient);
+    this.walmart = new WalmartClient(this.baseClient);
     this.youtube = new YoutubeClient(this.baseClient);
     this.realtor = new RealtorClient(this.baseClient);
     this.leboncoin = new LeboncoinClient(this.baseClient);
@@ -7511,6 +7733,6 @@ var ScrapeBadger = class {
   }
 };
 
-export { AccountRestrictedError, AmazonClient, ListingsClient as AmazonListingsClient, ProductsClient2 as AmazonProductsClient, ReferenceClient2 as AmazonReferenceClient, SearchClient5 as AmazonSearchClient, SellersClient as AmazonSellersClient, ApartmentsClient, AuthenticationError, AskClient as ChatGPTAskClient, BrandClient as ChatGPTBrandClient, ChatGPTClient, ReferenceClient11 as ChatGPTReferenceClient, CommunitiesClient, ConflictError, DepopClient, CategoriesClient as EbayCategoriesClient, EbayClient, ItemsClient2 as EbayItemsClient, ReferenceClient5 as EbayReferenceClient, SearchClient8 as EbaySearchClient, SellersClient2 as EbaySellersClient, GeoClient, AiModeClient as GoogleAiModeClient, AutocompleteClient as GoogleAutocompleteClient, GoogleClient, FinanceClient as GoogleFinanceClient, FlightsClient as GoogleFlightsClient, HotelsClient as GoogleHotelsClient, ImagesClient as GoogleImagesClient, JobsClient as GoogleJobsClient, LensClient as GoogleLensClient, MapsClient as GoogleMapsClient, NewsClient as GoogleNewsClient, PatentsClient as GooglePatentsClient, ProductsClient as GoogleProductsClient, ScholarClient as GoogleScholarClient, SearchClient2 as GoogleSearchClient, ShoppingClient as GoogleShoppingClient, ShortsClient as GoogleShortsClient, TrendsClient2 as GoogleTrendsClient, VideosClient as GoogleVideosClient, ImmobiliareClient, AudioClient as InstagramAudioClient, InstagramClient, HashtagsClient as InstagramHashtagsClient, LocationsClient as InstagramLocationsClient, MediaClient as InstagramMediaClient, SearchClient4 as InstagramSearchClient, UsersClient4 as InstagramUsersClient, InsufficientCreditsError, AdsClient2 as LeboncoinAdsClient, LeboncoinClient, ReferenceClient8 as LeboncoinReferenceClient, SearchClient11 as LeboncoinSearchClient, SellersClient3 as LeboncoinSellersClient, LinkedInClient, ListsClient, BrokersClient as LoopNetBrokersClient, LoopNetClient, ListingsClient2 as LoopNetListingsClient, ReferenceClient10 as LoopNetReferenceClient, SearchClient13 as LoopNetSearchClient, NotFoundError, RateLimitError, RealtorClient, PropertiesClient as RealtorPropertiesClient, ReferenceClient7 as RealtorReferenceClient, SearchClient10 as RealtorSearchClient, RedditClient, PostsClient as RedditPostsClient, SearchClient3 as RedditSearchClient, SubredditsClient as RedditSubredditsClient, UsersClient3 as RedditUsersClient, RedfinClient, ScrapeBadger, ScrapeBadgerError, ServerError, ShopeeClient, ProductsClient3 as ShopeeProductsClient, ReferenceClient3 as ShopeeReferenceClient, ReviewsClient as ShopeeReviewsClient, SearchClient6 as ShopeeSearchClient, SpacesClient, StreamClient, AdsClient as TikTokAdsClient, TikTokClient, HashtagsClient2 as TikTokHashtagsClient, MusicClient as TikTokMusicClient, ReferenceClient4 as TikTokReferenceClient, SearchClient7 as TikTokSearchClient, TrendingClient as TikTokTrendingClient, UsersClient5 as TikTokUsersClient, VideosClient2 as TikTokVideosClient, TimeoutError, TrendsClient, TweetsClient, TwitterClient, UsersClient, ValidationError, VintedClient, ItemsClient as VintedItemsClient, ReferenceClient as VintedReferenceClient, SearchClient as VintedSearchClient, UsersClient2 as VintedUsersClient, WebClient, WebSocketStreamError, ChannelsClient as YoutubeChannelsClient, YoutubeClient, CommunityClient as YoutubeCommunityClient, MusicClient2 as YoutubeMusicClient, PlaylistsClient as YoutubePlaylistsClient, ReferenceClient6 as YoutubeReferenceClient, SearchClient9 as YoutubeSearchClient, ShortsClient2 as YoutubeShortsClient, TrendingClient2 as YoutubeTrendingClient, VideosClient3 as YoutubeVideosClient, AgentClient as ZillowAgentClient, ZillowClient, PropertiesClient2 as ZillowPropertiesClient, ReferenceClient9 as ZillowReferenceClient, SearchClient12 as ZillowSearchClient, collectAll, verifyWebhookSignature };
+export { AccountRestrictedError, AmazonClient, ListingsClient as AmazonListingsClient, ProductsClient2 as AmazonProductsClient, ReferenceClient2 as AmazonReferenceClient, SearchClient5 as AmazonSearchClient, SellersClient as AmazonSellersClient, ApartmentsClient, AuthenticationError, AskClient as ChatGPTAskClient, BrandClient as ChatGPTBrandClient, ChatGPTClient, ReferenceClient12 as ChatGPTReferenceClient, CommunitiesClient, ConflictError, DepopClient, CategoriesClient as EbayCategoriesClient, EbayClient, ItemsClient2 as EbayItemsClient, ReferenceClient5 as EbayReferenceClient, SearchClient8 as EbaySearchClient, SellersClient2 as EbaySellersClient, GeoClient, AiModeClient as GoogleAiModeClient, AutocompleteClient as GoogleAutocompleteClient, GoogleClient, FinanceClient as GoogleFinanceClient, FlightsClient as GoogleFlightsClient, HotelsClient as GoogleHotelsClient, ImagesClient as GoogleImagesClient, JobsClient as GoogleJobsClient, LensClient as GoogleLensClient, MapsClient as GoogleMapsClient, NewsClient as GoogleNewsClient, PatentsClient as GooglePatentsClient, ProductsClient as GoogleProductsClient, ScholarClient as GoogleScholarClient, SearchClient2 as GoogleSearchClient, ShoppingClient as GoogleShoppingClient, ShortsClient as GoogleShortsClient, TrendsClient2 as GoogleTrendsClient, VideosClient as GoogleVideosClient, ImmobiliareClient, AudioClient as InstagramAudioClient, InstagramClient, HashtagsClient as InstagramHashtagsClient, LocationsClient as InstagramLocationsClient, MediaClient as InstagramMediaClient, SearchClient4 as InstagramSearchClient, UsersClient4 as InstagramUsersClient, InsufficientCreditsError, AdsClient2 as LeboncoinAdsClient, LeboncoinClient, ReferenceClient9 as LeboncoinReferenceClient, SearchClient12 as LeboncoinSearchClient, SellersClient4 as LeboncoinSellersClient, LinkedInClient, ListsClient, BrokersClient as LoopNetBrokersClient, LoopNetClient, ListingsClient2 as LoopNetListingsClient, ReferenceClient11 as LoopNetReferenceClient, SearchClient14 as LoopNetSearchClient, NotFoundError, RateLimitError, RealtorClient, PropertiesClient as RealtorPropertiesClient, ReferenceClient8 as RealtorReferenceClient, SearchClient11 as RealtorSearchClient, RedditClient, PostsClient as RedditPostsClient, SearchClient3 as RedditSearchClient, SubredditsClient as RedditSubredditsClient, UsersClient3 as RedditUsersClient, RedfinClient, ScrapeBadger, ScrapeBadgerError, ServerError, ShopeeClient, ProductsClient3 as ShopeeProductsClient, ReferenceClient3 as ShopeeReferenceClient, ReviewsClient as ShopeeReviewsClient, SearchClient6 as ShopeeSearchClient, SpacesClient, StreamClient, AdsClient as TikTokAdsClient, TikTokClient, HashtagsClient2 as TikTokHashtagsClient, MusicClient as TikTokMusicClient, ReferenceClient4 as TikTokReferenceClient, SearchClient7 as TikTokSearchClient, TrendingClient as TikTokTrendingClient, UsersClient5 as TikTokUsersClient, VideosClient2 as TikTokVideosClient, TimeoutError, TrendsClient, TweetsClient, TwitterClient, UsersClient, ValidationError, VintedClient, ItemsClient as VintedItemsClient, ReferenceClient as VintedReferenceClient, SearchClient as VintedSearchClient, UsersClient2 as VintedUsersClient, WalmartClient, ProductsClient4 as WalmartProductsClient, ReferenceClient6 as WalmartReferenceClient, SearchClient9 as WalmartSearchClient, SellersClient3 as WalmartSellersClient, StoresClient as WalmartStoresClient, WebClient, WebSocketStreamError, ChannelsClient as YoutubeChannelsClient, YoutubeClient, CommunityClient as YoutubeCommunityClient, MusicClient2 as YoutubeMusicClient, PlaylistsClient as YoutubePlaylistsClient, ReferenceClient7 as YoutubeReferenceClient, SearchClient10 as YoutubeSearchClient, ShortsClient2 as YoutubeShortsClient, TrendingClient2 as YoutubeTrendingClient, VideosClient3 as YoutubeVideosClient, AgentClient as ZillowAgentClient, ZillowClient, PropertiesClient2 as ZillowPropertiesClient, ReferenceClient10 as ZillowReferenceClient, SearchClient13 as ZillowSearchClient, collectAll, verifyWebhookSignature };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map