scavio 0.32.1 → 0.34.0

package/README.md

@@ -1,7 +1,7 @@
 # Scavio
 
 TypeScript SDK for the [Scavio API](https://scavio.dev?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme) — real-time structured web
-data across 52 platforms on one API key, plus `extract()` to read
+data across 59 platforms on one API key, plus `extract()` to read
 any URL as clean Markdown, and `extract.map()` / `extract.crawl()` /
 `extract.batch()` to map, crawl and batch-extract whole websites.
 
@@ -9,7 +9,7 @@ Structured JSON in, structured JSON out. No per-site parsers to maintain.
 
 - **Search and SERP** — Google (organic, news, maps, shopping, flights, hotels, trends, AI Mode)
 - **AI assistants** — ChatGPT and Gemini answers with the sources they cite and the products they recommend
-- **E-commerce** — Amazon, Walmart, Costco, Lowe's, Sam's Club, Canadian Tire, Dollar General, Sephora, Ulta Beauty, ALDI, Micro Center, Walgreens, CVS, Mercado Libre, eBay, Target, Home Depot, TikTok Shop
+- **E-commerce** — Amazon, Walmart, Costco, Lowe's, Sam's Club, Canadian Tire, Dollar General, Sephora, Ulta Beauty, ALDI, Micro Center, Walgreens, CVS, Whole Foods, Harbor Freight, PetSmart, Petco, iHerb, Chewy, Menards, Mercado Libre, eBay, Target, Home Depot, TikTok Shop
 - **Real estate and travel** — Zillow, Redfin, Realtor.com, Rightmove, Booking, Airbnb, Tripadvisor
 - **Reviews and local** — Trustpilot, Yelp, G2, Capterra, Glassdoor, App Store, Google Play
 - **Jobs and companies** — Indeed, Glassdoor, SEC EDGAR, Companies House
@@ -252,9 +252,9 @@ await client.google.search({
   device: "desktop",       // optional
 });
 
-// Organic rankings as seen from a city: web_only returns Google's Web results
-// (organic only, localized to location). For now the standard page localizes
-// only the local pack.
+// Local rank tracking: web_only returns Google's Web results (organic only,
+// ranked for location). The standard page localizes only the local pack; call
+// again without web_only when you also need local_results.
 await client.google.search({
   query: "emergency plumber",
   location: "Austin,Texas,United States",
@@ -606,6 +606,83 @@ Sephora, Ulta Beauty, ALDI and CVS calls cost 1 credit each. Micro Center
 raises the request timeout to `CVS_PRODUCT_TIMEOUT` (120s) when the client's is
 shorter; it never lowers it.
 
+### Whole Foods, Harbor Freight, PetSmart, Petco, iHerb, Chewy and Menards
+
+Seven US retailers, new in 0.33.0. Store-level prices or stock take a store
+number from that retailer's locator (`wholeFoods.stores`,
+`harborFreight.stores`, `petsmart.stores`, `petco.stores`, `menards.stores`);
+iHerb and Chewy are online only.
+
+```typescript
+// Whole Foods: prices are per store (5-digit store_id, default 10145 Austin):
+// regular_price, sale_price and prime_price. No ratings, reviews, UPCs or
+// per-store unit stock. search() sorts by relevance, price_asc or price_desc.
+const wf = await client.wholeFoods.stores({ zip: "10019" });
+const wfStore = (wf.data as any).stores[0].store_id; // "10160"
+await client.wholeFoods.search({ query: "milk", store_id: wfStore, on_sale: true });
+await client.wholeFoods.category({ category: "cheese", store_id: wfStore, sort: "popular" });
+await client.wholeFoods.deals({ store_id: wfStore });
+await client.wholeFoods.product({ asin: "B078WVT2BC", store_id: wfStore }); // in_store and online prices, separately
+await client.wholeFoods.store({ store_id: wfStore });
+await client.wholeFoods.salesFlyer({ store_id: wfStore });
+
+// Harbor Freight: national prices with sale and end date, public coupon,
+// Inside Track member price and compare_at. availability() is a stock status
+// per store (in_stock, limited, out_of_stock, not_carried) plus aisle, from
+// a daily snapshot - no unit counts.
+await client.harborFreight.search({ query: "cordless drill", sort: "member_price_low" });
+await client.harborFreight.clearance({ query: "drill" });
+await client.harborFreight.product({ sku: "73216" });
+await client.harborFreight.prices({ skus: ["73216", "59716", "64508"] }); // up to 50
+await client.harborFreight.stores({ query: "60601" });
+await client.harborFreight.availability({ skus: ["73216"], zip: "90012" });
+await client.harborFreight.reviews({ sku: "73216", limit: 10 });
+
+// PetSmart: national price plus Autoship first-order and recurring price;
+// stock is a unit count per store.
+await client.petsmart.search({ query: "dog food", store_id: "1658" }); // in stock at that store only
+await client.petsmart.product({ web_style_id: "36648" });
+await client.petsmart.stores({ zip: "60601", sku: "5252900" }); // + quantity per store
+await client.petsmart.storeStock({ store_id: "1658", skus: ["5252900"] });
+await client.petsmart.availability({ pairs: [{ store_id: "1658", sku: "5252900" }] });
+await client.petsmart.deals({ pet: "dog" }); // on_sale marks real price cuts
+
+// Petco: national price plus Repeat Delivery (autoship) price. storeInventory()
+// takes cat_entry_id (from search or product), not the part number.
+await client.petco.search({ query: "dog food", sort: "price" });
+await client.petco.category({ path: "dog/dog-food/dry-dog-food" });
+await client.petco.product({ part_number: "3748364" });
+const pc = await client.petco.stores({ zip: "10001" });
+const pcStore = (pc.data as any).stores[0].store_id;
+await client.petco.storeInventory({ cat_entry_ids: ["6131012"], store_id: pcStore });
+
+// iHerb: online only, US store, USD. reviews() is the rating summary,
+// histogram and top positive and critical review - not a full list.
+await client.iherb.search({ query: "vitamin d", sort: "best_selling" });
+await client.iherb.product({ product_id: "70316" });
+await client.iherb.prices({ product_ids: ["62118", "70316", "77548"] }); // up to 50
+await client.iherb.reviews({ product_id: "70316" });
+
+// Chewy: one-time, Autoship and first-Autoship prices, MAP fields, ratings.
+// A broad query can land on a category; data.redirect then names it.
+await client.chewy.search({ query: "kong classic dog toy" });
+await client.chewy.product({ product_id: "38485" });
+
+// Menards: search one store (store_id required), then product() by item id or
+// URL. Mail-in rebates and the final price after rebates; store_id adds stock.
+await client.menards.stores({ zip: "55401" });
+await client.menards.search({ query: "sledge hammer", store_id: "3181", sort: "price_asc" });
+await client.menards.product({ item_id: "60893666613", store_id: "3181" });
+```
+
+Whole Foods, Harbor Freight, PetSmart and Petco calls cost 1 credit each.
+iHerb calls cost 2 and Chewy calls 10. Menards `search` costs 2, `stores` 1 and
+`product` 1, or 2 with a `store_id`. Petco calls can take 10-30 seconds, so every Petco
+call raises the request timeout to `PETCO_SLOW_TIMEOUT` (120s); iHerb `search`
+and `product` can take 10-25 seconds, so they raise it to `IHERB_SLOW_TIMEOUT`
+(120s); Menards `product` with a store can take 10-40 seconds, so it raises it
+to `MENARDS_PRODUCT_TIMEOUT` (120s). None ever lowers a longer client timeout.
+
 ### [Mercado Libre](https://scavio.dev/docs/mercadolibre-search?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme)
 
 Five endpoints, new in 0.21.0: `reviews` costs 1 credit, the other four 2. The

package/dist/index.cjs

@@ -41,6 +41,7 @@ __export(index_exports, {
   CanadianTireNamespace: () => CanadianTireNamespace,
   CapterraNamespace: () => CapterraNamespace,
   ChatgptNamespace: () => ChatgptNamespace,
+  ChewyNamespace: () => ChewyNamespace,
   CompaniesHouseNamespace: () => CompaniesHouseNamespace,
   CostcoNamespace: () => CostcoNamespace,
   CvsNamespace: () => CvsNamespace,
@@ -54,8 +55,11 @@ __export(index_exports, {
   GoogleAdsNamespace: () => GoogleAdsNamespace,
   GoogleNamespace: () => GoogleNamespace,
   GooglePlayNamespace: () => GooglePlayNamespace,
+  HarborFreightNamespace: () => HarborFreightNamespace,
   HebNamespace: () => HebNamespace,
   HomeDepotNamespace: () => HomeDepotNamespace,
+  IHERB_SLOW_TIMEOUT: () => IHERB_SLOW_TIMEOUT,
+  IherbNamespace: () => IherbNamespace,
   IndeedNamespace: () => IndeedNamespace,
   InstagramNamespace: () => InstagramNamespace,
   InsufficientCreditsError: () => InsufficientCreditsError,
@@ -65,11 +69,16 @@ __export(index_exports, {
   LinkedInNamespace: () => LinkedInNamespace,
   LowesNamespace: () => LowesNamespace,
   MAX_REQUESTS_PER_SECOND: () => MAX_REQUESTS_PER_SECOND,
+  MENARDS_PRODUCT_TIMEOUT: () => MENARDS_PRODUCT_TIMEOUT,
+  MenardsNamespace: () => MenardsNamespace,
   MercadoLibreNamespace: () => MercadoLibreNamespace,
   MetaAdsNamespace: () => MetaAdsNamespace,
   MicroCenterNamespace: () => MicroCenterNamespace,
   MissingAPIKeyError: () => MissingAPIKeyError,
   NotFoundError: () => NotFoundError,
+  PETCO_SLOW_TIMEOUT: () => PETCO_SLOW_TIMEOUT,
+  PetcoNamespace: () => PetcoNamespace,
+  PetsmartNamespace: () => PetsmartNamespace,
   RateLimitError: () => RateLimitError,
   RealtorNamespace: () => RealtorNamespace,
   RedditNamespace: () => RedditNamespace,
@@ -93,6 +102,7 @@ __export(index_exports, {
   UltaNamespace: () => UltaNamespace,
   WalgreensNamespace: () => WalgreensNamespace,
   WalmartNamespace: () => WalmartNamespace,
+  WholeFoodsNamespace: () => WholeFoodsNamespace,
   XNamespace: () => XNamespace,
   YelpNamespace: () => YelpNamespace,
   YouTubeNamespace: () => YouTubeNamespace,
@@ -248,7 +258,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.32.1" : "0.0.0";
+var SDK_VERSION = true ? "0.34.0" : "0.0.0";
 var USER_AGENT = `scavio-js/${SDK_VERSION}`;
 function isServerRuntime() {
   const g = globalThis;
@@ -3436,6 +3446,459 @@ var CvsNamespace = class {
   }
 };
 
+// src/namespaces/whole-foods.ts
+var WholeFoodsNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search Whole Foods Market products at one store, up to 60 per page: ASIN,
+   * slug, name, brand, image, that store's regular_price, sale_price and
+   * prime_price with sale start and end dates (a multi-buy is a total:
+   * sale_price 10 with sale_quantity 2 is 2 for $10; price_unit lb is per
+   * pound), on_sale and is_local flags. Also total_results and facets
+   * (categories, diets). Sorts by relevance or price only.
+   *
+   * Costs 1 credit.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/wholefoods/search", options);
+  }
+  /**
+   * Browse one Whole Foods Market category at one store, with sort, on_sale
+   * and diet filters. Same product fields as search, plus the category
+   * breadcrumb, total_results and facets. An unknown category slug is a 404.
+   *
+   * Costs 1 credit.
+   */
+  async category(options) {
+    return this.client._post("/api/v1/wholefoods/category", options);
+  }
+  /**
+   * Every product on sale at one Whole Foods Market store, store-wide or in
+   * one category, with regular, sale and Prime prices and sale dates.
+   *
+   * Costs 1 credit.
+   */
+  async deals(options = {}) {
+    return this.client._post("/api/v1/wholefoods/deals", options);
+  }
+  /**
+   * One Whole Foods Market product by ASIN, URL or slug: name, brand,
+   * description, ingredients, nutrition facts, diets, SNAP EBT eligibility
+   * and images. With store_id, two separate price blocks: in_store (the
+   * store's shelf regular, sale and Prime price; null when it does not list
+   * the item) and online (delivery/pickup price, list price, savings, Prime
+   * price, unit price, availability; null with no online offer). An unknown
+   * ASIN is a 404.
+   *
+   * Costs 1 credit.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/wholefoods/product", options);
+  }
+  /**
+   * Whole Foods Market stores near a US ZIP code, nearest first (within 15
+   * miles, widening to 50): store_id, name, address, phone, coordinates,
+   * distance in miles, time zone and seven days of in-store and pickup hours.
+   * No store in range is an empty list.
+   *
+   * Costs 1 credit.
+   */
+  async stores(options) {
+    return this.client._post("/api/v1/wholefoods/stores", options);
+  }
+  /**
+   * One Whole Foods Market store by id: name, status, phone, Prime
+   * eligibility, opening date, address, coordinates, time zone, store page and
+   * sales flyer URLs. An unknown store id is a 404.
+   *
+   * Costs 1 credit.
+   */
+  async store(options) {
+    return this.client._post("/api/v1/wholefoods/store", options);
+  }
+  /**
+   * The current weekly sales flyer of one Whole Foods Market store: each
+   * promotion's product name, brand, headline, description, terms, regular,
+   * sale and Prime price as printed (text such as "$3.99/lb" or "44% off"),
+   * start and end dates, image, rank and the ASINs it covers. An unknown
+   * store id is a 404.
+   *
+   * Costs 1 credit.
+   */
+  async salesFlyer(options) {
+    return this.client._post("/api/v1/wholefoods/sales-flyer", options);
+  }
+};
+
+// src/namespaces/harbor-freight.ts
+var HarborFreightNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search Harbor Freight by keyword and/or category, with brand and
+   * clearance filters: item number, id, title, brand, URL, image, price,
+   * regular price, on_sale and clearance flags, sale (price, end date,
+   * savings), coupon, member_deal, compare_at, badges, rating, review count,
+   * in-store-only / online-only flags and variants. Also total_results,
+   * facets, and redirect when a keyword maps to a category page.
+   *
+   * Costs 1 credit.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/harborfreight/search", options);
+  }
+  /**
+   * Harbor Freight clearance items, optionally narrowed by keyword, category
+   * or brand. Same fields as search; each item's clearance price and end date
+   * are in `sale`.
+   *
+   * Costs 1 credit.
+   */
+  async clearance(options = {}) {
+    return this.client._post("/api/v1/harborfreight/clearance", options);
+  }
+  /**
+   * One product by item number, id or URL: title, brand, UPC, every price
+   * field of search, rating, review count, description, highlights, the full
+   * specification table, warranty, shipping notes, owner's manuals, images
+   * and variants. An unknown item is a 404.
+   *
+   * Costs 1 credit.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/harborfreight/product", options);
+  }
+  /**
+   * Current prices for up to 50 item numbers in one call: price, regular
+   * price, sale, coupon, member_deal and compare_at per item. Unknown item
+   * numbers are listed in not_found.
+   *
+   * Costs 1 credit.
+   */
+  async prices(options) {
+    return this.client._post("/api/v1/harborfreight/prices", options);
+  }
+  /**
+   * Harbor Freight stores near a ZIP code, "City, ST" or coordinates, nearest
+   * first: store_id, name, address, phone, coordinates, distance in miles,
+   * status, opening date and hours.
+   *
+   * Costs 1 credit.
+   */
+  async stores(options) {
+    return this.client._post("/api/v1/harborfreight/stores", options);
+  }
+  /**
+   * In-store stock for up to 20 items at chosen stores, or at the stores
+   * nearest a ZIP code or coordinates. Each store lists every item with
+   * stock_status (in_stock, limited, out_of_stock or not_carried), the aisle
+   * and a nearby store that has it. inventory_updated_at is the time of the
+   * daily stock snapshot. Stock is a status, not a unit count.
+   *
+   * Costs 1 credit.
+   */
+  async availability(options) {
+    return this.client._post("/api/v1/harborfreight/availability", options);
+  }
+  /**
+   * Customer reviews for one item, newest first, with limit/offset paging:
+   * title, text, star rating, author, review and purchase dates, incentivized
+   * flag, helpful votes and the reviewer's answers. Also the average rating
+   * and total review count. An unknown item is a 404.
+   *
+   * Costs 1 credit.
+   */
+  async reviews(options) {
+    return this.client._post("/api/v1/harborfreight/reviews", options);
+  }
+};
+
+// src/namespaces/petsmart.ts
+var PetsmartNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search PetSmart products, up to 40 per page: SKU, web_style_id, name,
+   * brand, UPC, price, original and sale price, price range across sizes,
+   * rating, review count, image, size, variations, category, pets,
+   * promotions, stores_in_stock (how many stores stock it), pickup and
+   * Autoship eligibility and URL. Prices are national. Pass store_id to list
+   * only products in stock at that store.
+   *
+   * Costs 1 credit.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/petsmart/search", options);
+  }
+  /**
+   * One PetSmart product by web_style_id, SKU or URL, with every variant
+   * (size, flavor): SKU, UPC, price, original price, sale price and end date,
+   * Autoship discount with first-order and recurring price, ship-to-home
+   * stock, pickup and same-day options, images and promotions. Also brand,
+   * rating, review count, categories and description. An unknown id is a 404.
+   *
+   * Costs 1 credit.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/petsmart/product", options);
+  }
+  /**
+   * The 12 PetSmart stores nearest a US ZIP code: store_id, name, address,
+   * phone, coordinates, distance in miles, time zone, the next 7 days of
+   * hours and services (grooming, PetsHotel, veterinary, adoptions). Pass a
+   * sku and each store also carries quantity and in_stock for it.
+   *
+   * Costs 1 credit.
+   */
+  async stores(options) {
+    return this.client._post("/api/v1/petsmart/stores", options);
+  }
+  /**
+   * Stock of up to 20 SKUs at one PetSmart store: units for in-store pickup
+   * at that store, units to ship to home, and a nearby alternate store with
+   * its count when the store has none. Includes the store's address and
+   * pickup options. An unknown store is a 404; an unknown SKU reads 0.
+   *
+   * Costs 1 credit.
+   */
+  async storeStock(options) {
+    return this.client._post("/api/v1/petsmart/store-stock", options);
+  }
+  /**
+   * Unit counts for up to 20 store and SKU pairs in one call, mixing stores
+   * and SKUs freely: quantity and in_stock per pair. Unknown stores or SKUs
+   * read 0.
+   *
+   * Costs 1 credit.
+   */
+  async availability(options) {
+    return this.client._post("/api/v1/petsmart/availability", options);
+  }
+  /**
+   * Products in PetSmart's Sale section, up to 40 per page, in the same shape
+   * as search, plus the current sale events with approximate product counts.
+   * The Sale section also lists points and Autoship promotions, so on_sale
+   * marks the rows whose price is actually reduced.
+   *
+   * Costs 1 credit.
+   */
+  async deals(options = {}) {
+    return this.client._post("/api/v1/petsmart/deals", options);
+  }
+};
+
+// src/namespaces/petco.ts
+var PETCO_SLOW_TIMEOUT = 12e4;
+var PetcoNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search Petco products, 48 per page: price, list price and autoship
+   * (Repeat Delivery) price, rating, review count, brand, part_number,
+   * cat_entry_id (for storeInventory), fulfillment flags (pickup, same-day
+   * delivery, autoship, in-store only), deal group ids and every size/flavor
+   * variation with its own prices. Also total_results, facets and the
+   * categories the matches fall into. Prices are national.
+   *
+   * Costs 1 credit.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/petco/search", options, void 0, PETCO_SLOW_TIMEOUT);
+  }
+  /**
+   * Products in a Petco category, e.g. dog/dog-food/dry-dog-food, in the same
+   * shape as search. An unknown category is a 404. Can take 10-30 seconds.
+   *
+   * Costs 1 credit.
+   */
+  async category(options) {
+    return this.client._post("/api/v1/petco/category", options, void 0, PETCO_SLOW_TIMEOUT);
+  }
+  /**
+   * One Petco product by part number or URL, with every variant (size,
+   * flavor): cat_entry_id, part number, SKU, UPC, price, list price, autoship
+   * price, first-autoship promo price, online quantity and status,
+   * fulfillment flags, ingredients, guaranteed analysis, directions,
+   * specifications, dimensions and images. Plus brand, rating, review count
+   * and breadcrumbs. Prices are national. An unknown product is a 404. Can
+   * take 10-30 seconds.
+   *
+   * Costs 1 credit.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/petco/product", options, void 0, PETCO_SLOW_TIMEOUT);
+  }
+  /**
+   * Petco stores nearest a US ZIP code (up to 10): store_id (for
+   * storeInventory), store number, name, address, phone, coordinates,
+   * distance in miles, in-store pickup and opening hours per weekday.
+   *
+   * Costs 1 credit.
+   */
+  async stores(options) {
+    return this.client._post("/api/v1/petco/stores", options, void 0, PETCO_SLOW_TIMEOUT);
+  }
+  /**
+   * Units on hand at one Petco store for up to 10 products: qty_available,
+   * alert_level (GREEN, YELLOW, RED) and in_stock per cat_entry_id. Pass a
+   * store_id, or a zip to use the nearest store.
+   *
+   * Costs 1 credit.
+   */
+  async storeInventory(options) {
+    return this.client._post("/api/v1/petco/store-inventory", options, void 0, PETCO_SLOW_TIMEOUT);
+  }
+};
+
+// src/namespaces/iherb.ts
+var IHERB_SLOW_TIMEOUT = 12e4;
+var IherbNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search iHerb (US store, USD), 48 per page: product_id, part_number, name,
+   * brand, brand_code, URL, image, price, list price, original price and
+   * discount_percent when discounted, rating, review count, in_stock, badges
+   * (Best seller, iHerb Brands, New), recent_sales (e.g. "30K+ sold in 30
+   * days") and position. Also total_results and brand_filters for narrowing
+   * with brand_code.
+   *
+   * Costs 2 credits.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/iherb/search", options, void 0, IHERB_SLOW_TIMEOUT);
+  }
+  /**
+   * One iHerb product by id or URL (US store, USD): name, brand, part number,
+   * UPC, price, list price, discount, price per serving or unit, stock status,
+   * discontinued and coming-soon flags, quantity limit, expiration date,
+   * package quantity, weight and dimensions, rating and review count,
+   * breadcrumbs, best-seller rankings, badges, variants, supplement facts,
+   * description, suggested use, ingredients, warnings and images. An unknown
+   * product id is a 404.
+   *
+   * Costs 2 credits.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/iherb/product", options, void 0, IHERB_SLOW_TIMEOUT);
+  }
+  /**
+   * Current price, list price, discount, in-stock flag, rating and review
+   * count for up to 50 iHerb products in one call (US store, USD). One row
+   * per requested id, in request order; unknown ids come back with
+   * found: false and are listed in not_found.
+   *
+   * Costs 2 credits.
+   */
+  async prices(options) {
+    return this.client._post("/api/v1/iherb/prices", options);
+  }
+  /**
+   * The review summary for one iHerb product: average rating, total review
+   * count, star histogram, review counts per language, and the full text of
+   * the top positive and top critical review (rating, title, author, country,
+   * date, verified-purchase flag, helpful votes, images). Not a full review
+   * list.
+   *
+   * Costs 2 credits.
+   */
+  async reviews(options) {
+    return this.client._post("/api/v1/iherb/reviews", options);
+  }
+};
+
+// src/namespaces/chewy.ts
+var ChewyNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search Chewy by keyword, or browse a category, 36 per page: one-time
+   * price, offer and strike-through price, Autoship price and discount,
+   * first-Autoship price, discount and savings cap, MAP price, per-unit
+   * price, rating, rating count, in-stock flag, deal/new/exclusive/
+   * prescription flags, brand, image and URL. Sponsored listings are removed
+   * (sponsored_removed counts them). `redirect` names the category when
+   * Chewy sends the query to one.
+   *
+   * Costs 10 credits.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/chewy/search", options);
+  }
+  /**
+   * One Chewy product by id or URL: one-time price, offer price, list and
+   * strike-through price with savings, MAP price and whether it is enforced,
+   * Autoship price and discount, first-Autoship price, per-unit price,
+   * in-stock flag, rating, rating count, review count and star distribution,
+   * brand, GTIN, description, key benefits, specifications, breadcrumbs,
+   * images, promotions and every variant (size, flavor) with its own price,
+   * Autoship price and stock. An unknown product id is a 404.
+   *
+   * Costs 10 credits.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/chewy/product", options);
+  }
+};
+
+// src/namespaces/menards.ts
+var MENARDS_PRODUCT_TIMEOUT = 12e4;
+var MenardsNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search menards.com at one store, 40 products a page: item_id, sku, name,
+   * url, image, price, everyday_price, sale_price, price_type (regular, sale,
+   * clearance, minimum_advertised), mail-in rebates, final_price after
+   * rebates, and that store's stock_quantity, stock_message, pickup and
+   * delivery flags. Also total_results, total_pages and facets.
+   *
+   * Costs 2 credits.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/menards/search", options);
+  }
+  /**
+   * One Menards product by item id or URL: name, brand, model number, SKU,
+   * description, bullets, specifications, images, videos and documents, with
+   * the full price ladder: everyday price, sale price and end date, mail-in
+   * rebates (text, amount, dates), final price after rebates and you_save.
+   * Also pickup, delivery and ship-to-store flags. With store_id, that store's
+   * stock quantity, stock message, aisle location and not_available_at_store.
+   * An unknown item id or store number is a 404.
+   *
+   * Costs 1 credit, or 2 with store_id.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/menards/product", options, void 0, MENARDS_PRODUCT_TIMEOUT);
+  }
+  /**
+   * Menards stores near a US ZIP code or a city and state, nearest first:
+   * store_id, name, address, coordinates, distance in miles and services
+   * (garden center, grocery, rental center, propane and more).
+   *
+   * Costs 1 credit.
+   */
+  async stores(options) {
+    return this.client._post("/api/v1/menards/stores", options);
+  }
+};
+
 // src/namespaces/trustpilot.ts
 var TrustpilotNamespace = class {
   constructor(client) {
@@ -3961,6 +4424,13 @@ var Scavio = class extends ScavioCore {
   microCenter;
   walgreens;
   cvs;
+  wholeFoods;
+  harborFreight;
+  petsmart;
+  petco;
+  iherb;
+  chewy;
+  menards;
   trustpilot;
   chatgpt;
   gemini;
@@ -4034,6 +4504,13 @@ var Scavio = class extends ScavioCore {
     this.microCenter = new MicroCenterNamespace(this);
     this.walgreens = new WalgreensNamespace(this);
     this.cvs = new CvsNamespace(this);
+    this.wholeFoods = new WholeFoodsNamespace(this);
+    this.harborFreight = new HarborFreightNamespace(this);
+    this.petsmart = new PetsmartNamespace(this);
+    this.petco = new PetcoNamespace(this);
+    this.iherb = new IherbNamespace(this);
+    this.chewy = new ChewyNamespace(this);
+    this.menards = new MenardsNamespace(this);
     this.trustpilot = new TrustpilotNamespace(this);
     this.chatgpt = new ChatgptNamespace(this);
     this.gemini = new GeminiNamespace(this);
@@ -4154,6 +4631,7 @@ async function getSubtle() {
   CanadianTireNamespace,
   CapterraNamespace,
   ChatgptNamespace,
+  ChewyNamespace,
   CompaniesHouseNamespace,
   CostcoNamespace,
   CvsNamespace,
@@ -4167,8 +4645,11 @@ async function getSubtle() {
   GoogleAdsNamespace,
   GoogleNamespace,
   GooglePlayNamespace,
+  HarborFreightNamespace,
   HebNamespace,
   HomeDepotNamespace,
+  IHERB_SLOW_TIMEOUT,
+  IherbNamespace,
   IndeedNamespace,
   InstagramNamespace,
   InsufficientCreditsError,
@@ -4178,11 +4659,16 @@ async function getSubtle() {
   LinkedInNamespace,
   LowesNamespace,
   MAX_REQUESTS_PER_SECOND,
+  MENARDS_PRODUCT_TIMEOUT,
+  MenardsNamespace,
   MercadoLibreNamespace,
   MetaAdsNamespace,
   MicroCenterNamespace,
   MissingAPIKeyError,
   NotFoundError,
+  PETCO_SLOW_TIMEOUT,
+  PetcoNamespace,
+  PetsmartNamespace,
   RateLimitError,
   RealtorNamespace,
   RedditNamespace,
@@ -4206,6 +4692,7 @@ async function getSubtle() {
   UltaNamespace,
   WalgreensNamespace,
   WalmartNamespace,
+  WholeFoodsNamespace,
   XNamespace,
   YelpNamespace,
   YouTubeNamespace,