scrapebadger 0.29.0 → 0.30.0

package/dist/index.js

@@ -5705,8 +5705,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;
@@ -6231,7 +6450,7 @@ var MusicClient2 = class {
 };
 
 // src/youtube/reference.ts
-var ReferenceClient6 = class {
+var ReferenceClient7 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6299,7 +6518,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);
@@ -6307,12 +6526,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;
@@ -6386,7 +6605,7 @@ var PropertiesClient = class {
 };
 
 // src/realtor/reference.ts
-var ReferenceClient7 = class {
+var ReferenceClient8 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6415,14 +6634,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;
@@ -6491,7 +6710,7 @@ var AdsClient2 = class {
 };
 
 // src/leboncoin/sellers.ts
-var SellersClient3 = class {
+var SellersClient4 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6524,7 +6743,7 @@ var SellersClient3 = class {
 };
 
 // src/leboncoin/reference.ts
-var ReferenceClient8 = class {
+var ReferenceClient9 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6595,15 +6814,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;
@@ -6707,7 +6926,7 @@ var AgentClient = class {
 };
 
 // src/zillow/reference.ts
-var ReferenceClient9 = class {
+var ReferenceClient10 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6738,10 +6957,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);
   }
 };
 
@@ -6876,7 +7095,7 @@ var ImmobiliareClient = class {
 };
 
 // src/loopnet/search.ts
-var SearchClient13 = class {
+var SearchClient14 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6957,7 +7176,7 @@ var BrokersClient = class {
 };
 
 // src/loopnet/reference.ts
-var ReferenceClient10 = class {
+var ReferenceClient11 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -7000,10 +7219,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);
   }
 };
 
@@ -7364,7 +7583,7 @@ var BrandClient = class {
 };
 
 // src/chatgpt/reference.ts
-var ReferenceClient11 = class {
+var ReferenceClient12 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -7410,7 +7629,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);
   }
 };
 
@@ -7441,6 +7660,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) */
@@ -7505,6 +7726,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);
@@ -7529,7 +7751,7 @@ exports.AuthenticationError = AuthenticationError;
 exports.ChatGPTAskClient = AskClient;
 exports.ChatGPTBrandClient = BrandClient;
 exports.ChatGPTClient = ChatGPTClient;
-exports.ChatGPTReferenceClient = ReferenceClient11;
+exports.ChatGPTReferenceClient = ReferenceClient12;
 exports.CommunitiesClient = CommunitiesClient;
 exports.ConflictError = ConflictError;
 exports.DepopClient = DepopClient;
@@ -7570,22 +7792,22 @@ exports.InstagramUsersClient = UsersClient4;
 exports.InsufficientCreditsError = InsufficientCreditsError;
 exports.LeboncoinAdsClient = AdsClient2;
 exports.LeboncoinClient = LeboncoinClient;
-exports.LeboncoinReferenceClient = ReferenceClient8;
-exports.LeboncoinSearchClient = SearchClient11;
-exports.LeboncoinSellersClient = SellersClient3;
+exports.LeboncoinReferenceClient = ReferenceClient9;
+exports.LeboncoinSearchClient = SearchClient12;
+exports.LeboncoinSellersClient = SellersClient4;
 exports.LinkedInClient = LinkedInClient;
 exports.ListsClient = ListsClient;
 exports.LoopNetBrokersClient = BrokersClient;
 exports.LoopNetClient = LoopNetClient;
 exports.LoopNetListingsClient = ListingsClient2;
-exports.LoopNetReferenceClient = ReferenceClient10;
-exports.LoopNetSearchClient = SearchClient13;
+exports.LoopNetReferenceClient = ReferenceClient11;
+exports.LoopNetSearchClient = SearchClient14;
 exports.NotFoundError = NotFoundError;
 exports.RateLimitError = RateLimitError;
 exports.RealtorClient = RealtorClient;
 exports.RealtorPropertiesClient = PropertiesClient;
-exports.RealtorReferenceClient = ReferenceClient7;
-exports.RealtorSearchClient = SearchClient10;
+exports.RealtorReferenceClient = ReferenceClient8;
+exports.RealtorSearchClient = SearchClient11;
 exports.RedditClient = RedditClient;
 exports.RedditPostsClient = PostsClient;
 exports.RedditSearchClient = SearchClient3;
@@ -7622,6 +7844,12 @@ exports.VintedItemsClient = ItemsClient;
 exports.VintedReferenceClient = ReferenceClient;
 exports.VintedSearchClient = SearchClient;
 exports.VintedUsersClient = UsersClient2;
+exports.WalmartClient = WalmartClient;
+exports.WalmartProductsClient = ProductsClient4;
+exports.WalmartReferenceClient = ReferenceClient6;
+exports.WalmartSearchClient = SearchClient9;
+exports.WalmartSellersClient = SellersClient3;
+exports.WalmartStoresClient = StoresClient;
 exports.WebClient = WebClient;
 exports.WebSocketStreamError = WebSocketStreamError;
 exports.YoutubeChannelsClient = ChannelsClient;
@@ -7629,16 +7857,16 @@ exports.YoutubeClient = YoutubeClient;
 exports.YoutubeCommunityClient = CommunityClient;
 exports.YoutubeMusicClient = MusicClient2;
 exports.YoutubePlaylistsClient = PlaylistsClient;
-exports.YoutubeReferenceClient = ReferenceClient6;
-exports.YoutubeSearchClient = SearchClient9;
+exports.YoutubeReferenceClient = ReferenceClient7;
+exports.YoutubeSearchClient = SearchClient10;
 exports.YoutubeShortsClient = ShortsClient2;
 exports.YoutubeTrendingClient = TrendingClient2;
 exports.YoutubeVideosClient = VideosClient3;
 exports.ZillowAgentClient = AgentClient;
 exports.ZillowClient = ZillowClient;
 exports.ZillowPropertiesClient = PropertiesClient2;
-exports.ZillowReferenceClient = ReferenceClient9;
-exports.ZillowSearchClient = SearchClient12;
+exports.ZillowReferenceClient = ReferenceClient10;
+exports.ZillowSearchClient = SearchClient13;
 exports.collectAll = collectAll;
 exports.verifyWebhookSignature = verifyWebhookSignature;
 //# sourceMappingURL=index.js.map