scrapebadger 0.39.0 → 0.40.0

package/dist/index.d.cts

@@ -1229,14 +1229,21 @@ interface ShoppingClickParams {
     product_id?: string;
 }
 /**
- * Params for `/v1/google/shopping/offers` — resolve a product by barcode
- * (GTIN-8/UPC-A/EAN-13/GTIN-14) and return its multi-seller Google
- * Shopping offers. Returns 422 for an invalid/checksum-failing barcode and
- * 404 when the barcode can't be resolved to a product.
+ * Params for `/v1/google/shopping/offers` — multi-seller Google Shopping
+ * offers for a product identified by `barcode` (GTIN-8/UPC-A/EAN-13/GTIN-14,
+ * resolved via Google web search first) OR by its Google Shopping
+ * `catalog_id` (sellers read straight off Google's product page). Exactly
+ * one of the two is required (400 otherwise); 422 for an invalid/
+ * checksum-failing barcode, 404 when nothing resolves.
  */
 interface ShoppingOffersParams {
     /** Product barcode: a GTIN-8, UPC-A, EAN-13, or GTIN-14. */
-    barcode: string;
+    barcode?: string;
+    /**
+     * Google Shopping `catalogid` — the `catalog_id` on `shopping.search`
+     * tiles, or `prds=catalogid:…` in a Google Shopping URL.
+     */
+    catalog_id?: string;
     /** ISO-3166 alpha-2 country code (e.g. `us`). */
     gl?: string;
     /** UI/results language (e.g. `en`). Defaults to `en`. */
@@ -2015,9 +2022,11 @@ declare class ShoppingClient {
      */
     click(params: ShoppingClickParams): Promise<GoogleResponse>;
     /**
-     * Resolve a product by `barcode` (GTIN-8/UPC-A/EAN-13/GTIN-14) and return
-     * its multi-seller Google Shopping offers. Throws on a 422 (invalid or
-     * checksum-failing barcode) or 404 (barcode not resolvable to a product).
+     * Multi-seller Google Shopping offers for a product, by `barcode`
+     * (GTIN-8/UPC-A/EAN-13/GTIN-14, resolved via Google web search first) or
+     * by Google Shopping `catalog_id` (sellers read off Google's product page).
+     * Throws on 400 (not exactly one identifier), 422 (invalid barcode) or 404
+     * (nothing resolves).
      */
     offers(params: ShoppingOffersParams): Promise<GoogleResponse>;
 }

package/dist/index.d.ts

@@ -1229,14 +1229,21 @@ interface ShoppingClickParams {
     product_id?: string;
 }
 /**
- * Params for `/v1/google/shopping/offers` — resolve a product by barcode
- * (GTIN-8/UPC-A/EAN-13/GTIN-14) and return its multi-seller Google
- * Shopping offers. Returns 422 for an invalid/checksum-failing barcode and
- * 404 when the barcode can't be resolved to a product.
+ * Params for `/v1/google/shopping/offers` — multi-seller Google Shopping
+ * offers for a product identified by `barcode` (GTIN-8/UPC-A/EAN-13/GTIN-14,
+ * resolved via Google web search first) OR by its Google Shopping
+ * `catalog_id` (sellers read straight off Google's product page). Exactly
+ * one of the two is required (400 otherwise); 422 for an invalid/
+ * checksum-failing barcode, 404 when nothing resolves.
  */
 interface ShoppingOffersParams {
     /** Product barcode: a GTIN-8, UPC-A, EAN-13, or GTIN-14. */
-    barcode: string;
+    barcode?: string;
+    /**
+     * Google Shopping `catalogid` — the `catalog_id` on `shopping.search`
+     * tiles, or `prds=catalogid:…` in a Google Shopping URL.
+     */
+    catalog_id?: string;
     /** ISO-3166 alpha-2 country code (e.g. `us`). */
     gl?: string;
     /** UI/results language (e.g. `en`). Defaults to `en`. */
@@ -2015,9 +2022,11 @@ declare class ShoppingClient {
      */
     click(params: ShoppingClickParams): Promise<GoogleResponse>;
     /**
-     * Resolve a product by `barcode` (GTIN-8/UPC-A/EAN-13/GTIN-14) and return
-     * its multi-seller Google Shopping offers. Throws on a 422 (invalid or
-     * checksum-failing barcode) or 404 (barcode not resolvable to a product).
+     * Multi-seller Google Shopping offers for a product, by `barcode`
+     * (GTIN-8/UPC-A/EAN-13/GTIN-14, resolved via Google web search first) or
+     * by Google Shopping `catalog_id` (sellers read off Google's product page).
+     * Throws on 400 (not exactly one identifier), 422 (invalid barcode) or 404
+     * (nothing resolves).
      */
     offers(params: ShoppingOffersParams): Promise<GoogleResponse>;
 }

package/dist/index.js

@@ -9,7 +9,7 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 var WebSocket__default = /*#__PURE__*/_interopDefault(WebSocket);
 
 // src/internal/version.ts
-var SDK_VERSION = "0.38.0";
+var SDK_VERSION = "0.40.0";
 
 // src/internal/exceptions.ts
 var ScrapeBadgerError = class _ScrapeBadgerError extends Error {
@@ -3336,9 +3336,11 @@ var ShoppingClient = class {
     });
   }
   /**
-   * Resolve a product by `barcode` (GTIN-8/UPC-A/EAN-13/GTIN-14) and return
-   * its multi-seller Google Shopping offers. Throws on a 422 (invalid or
-   * checksum-failing barcode) or 404 (barcode not resolvable to a product).
+   * Multi-seller Google Shopping offers for a product, by `barcode`
+   * (GTIN-8/UPC-A/EAN-13/GTIN-14, resolved via Google web search first) or
+   * by Google Shopping `catalog_id` (sellers read off Google's product page).
+   * Throws on 400 (not exactly one identifier), 422 (invalid barcode) or 404
+   * (nothing resolves).
    */
   async offers(params) {
     return this.client.request("/v1/google/shopping/offers", {