scavio 0.34.1 → 0.35.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 59 platforms on one API key, plus `extract()` to read
+data across 60 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, Whole Foods, Harbor Freight, PetSmart, Petco, iHerb, Chewy, Menards, 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, Nordstrom, 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
@@ -683,6 +683,32 @@ 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.
 
+### [Nordstrom](https://scavio.dev/docs/nordstrom-search?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme)
+
+Two endpoints, new in 0.35.0, 5 credits each. nordstrom.com (US site only).
+`search` returns 24 products a page with current and original price ranges,
+percent off, on-sale flag, rating, review count, badges and colors; `sort` is
+`relevance` (default), `rating`, `price_high`, `price_low`, `newest` or
+`percent_off`. `product` takes a result's `url` or `style_id` and lists every
+color and size as a sku with UPC, price, price type, `in_stock` and the
+`quantity` available to ship online.
+
+```ts
+const found = await client.nordstrom.search({ query: "dress", sort: "percent_off" });
+const top = (found as any).data.products[0];
+console.log(top.style_id, top.brand, top.name, top.price, top.percent_off);
+
+const item = await client.nordstrom.product({ style_id: top.style_id });
+for (const color of (item as any).data.colors) {
+  for (const sku of color.skus) console.log(color.name, sku.size, sku.upc, sku.price, sku.price_type, sku.quantity);
+}
+```
+
+Reviews are the 12-13 shown on the product page, with no deeper paging. There
+is no store locator, store-level stock or category endpoint. An unknown style
+id is a 404. Both calls raise the request timeout to `NORDSTROM_TIMEOUT`
+(120s), never lowering 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

@@ -70,11 +70,14 @@ __export(index_exports, {
   LowesNamespace: () => LowesNamespace,
   MAX_REQUESTS_PER_SECOND: () => MAX_REQUESTS_PER_SECOND,
   MENARDS_PRODUCT_TIMEOUT: () => MENARDS_PRODUCT_TIMEOUT,
+  MENARDS_SEARCH_TIMEOUT: () => MENARDS_SEARCH_TIMEOUT,
   MenardsNamespace: () => MenardsNamespace,
   MercadoLibreNamespace: () => MercadoLibreNamespace,
   MetaAdsNamespace: () => MetaAdsNamespace,
   MicroCenterNamespace: () => MicroCenterNamespace,
   MissingAPIKeyError: () => MissingAPIKeyError,
+  NORDSTROM_TIMEOUT: () => NORDSTROM_TIMEOUT,
+  NordstromNamespace: () => NordstromNamespace,
   NotFoundError: () => NotFoundError,
   PETCO_SLOW_TIMEOUT: () => PETCO_SLOW_TIMEOUT,
   PetcoNamespace: () => PetcoNamespace,
@@ -258,7 +261,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.34.1" : "0.0.0";
+var SDK_VERSION = true ? "0.35.0" : "0.0.0";
 var USER_AGENT = `scavio-js/${SDK_VERSION}`;
 function isServerRuntime() {
   const g = globalThis;
@@ -3857,6 +3860,7 @@ var ChewyNamespace = class {
 
 // src/namespaces/menards.ts
 var MENARDS_PRODUCT_TIMEOUT = 12e4;
+var MENARDS_SEARCH_TIMEOUT = 6e4;
 var MenardsNamespace = class {
   constructor(client) {
     this.client = client;
@@ -3872,7 +3876,7 @@ var MenardsNamespace = class {
    * Costs 2 credits.
    */
   async search(options) {
-    return this.client._post("/api/v1/menards/search", options);
+    return this.client._post("/api/v1/menards/search", options, void 0, MENARDS_SEARCH_TIMEOUT);
   }
   /**
    * One Menards product by item id or URL: name, brand, model number, SKU,
@@ -3900,6 +3904,49 @@ var MenardsNamespace = class {
   }
 };
 
+// src/namespaces/nordstrom.ts
+var NORDSTROM_TIMEOUT = 12e4;
+var NordstromNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search nordstrom.com (US) products, 24 per page, sorted by relevance,
+   * rating, price, newest or percent off. Each result has style id, URL,
+   * name, brand, image, current price and price range in dollars, original
+   * price range, percent off and on-sale flag, rating, review count, badges
+   * such as new or new_markdown, a low-inventory flag, whether it is sold by a
+   * marketplace seller (and the seller's name), and every color with its color
+   * family and image. Also returns the total result count and page count. Use
+   * a result's url or style_id with product().
+   *
+   * Costs 5 credits.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/nordstrom/search", options, void 0, NORDSTROM_TIMEOUT);
+  }
+  /**
+   * One nordstrom.com (US) product by URL or style id: name, brand,
+   * description, feature bullets, fit notes, final-sale flag, current,
+   * original and clearance price ranges, percent off, rating, review count,
+   * the star histogram, the size-fit distribution (too small to too big), the
+   * AI review summary when the site shows one, the most mentioned praised and
+   * criticized features with a quote each, breadcrumbs and images. Every color
+   * lists its images and every size as a sku with sku id, size, size type,
+   * UPC, price, original price, percent off, price type (regular, clearance,
+   * promotion), in_stock and the quantity available to ship. Includes the
+   * 12-13 reviews shown on the product page, with title, text, rating, size
+   * rating, author, date, helpful votes and verified-purchase flag. Pass url
+   * or style_id. An unknown style id is a 404.
+   *
+   * Costs 5 credits.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/nordstrom/product", options, void 0, NORDSTROM_TIMEOUT);
+  }
+};
+
 // src/namespaces/trustpilot.ts
 var TrustpilotNamespace = class {
   constructor(client) {
@@ -4432,6 +4479,7 @@ var Scavio = class extends ScavioCore {
   iherb;
   chewy;
   menards;
+  nordstrom;
   trustpilot;
   chatgpt;
   gemini;
@@ -4512,6 +4560,7 @@ var Scavio = class extends ScavioCore {
     this.iherb = new IherbNamespace(this);
     this.chewy = new ChewyNamespace(this);
     this.menards = new MenardsNamespace(this);
+    this.nordstrom = new NordstromNamespace(this);
     this.trustpilot = new TrustpilotNamespace(this);
     this.chatgpt = new ChatgptNamespace(this);
     this.gemini = new GeminiNamespace(this);
@@ -4661,11 +4710,14 @@ async function getSubtle() {
   LowesNamespace,
   MAX_REQUESTS_PER_SECOND,
   MENARDS_PRODUCT_TIMEOUT,
+  MENARDS_SEARCH_TIMEOUT,
   MenardsNamespace,
   MercadoLibreNamespace,
   MetaAdsNamespace,
   MicroCenterNamespace,
   MissingAPIKeyError,
+  NORDSTROM_TIMEOUT,
+  NordstromNamespace,
   NotFoundError,
   PETCO_SLOW_TIMEOUT,
   PetcoNamespace,