scrapebadger 0.40.1 → 0.42.0

package/dist/index.mjs

@@ -3,7 +3,7 @@ import { EventEmitter } from 'events';
 import WebSocket from 'ws';
 
 // src/internal/version.ts
-var SDK_VERSION = "0.40.1";
+var SDK_VERSION = "0.42.0";
 
 // src/internal/exceptions.ts
 var ScrapeBadgerError = class _ScrapeBadgerError extends Error {
@@ -5744,6 +5744,44 @@ var SearchClient8 = class {
       }
     });
   }
+  /**
+   * Search an eBay marketplace by image — eBay's own visual search.
+   *
+   * This is what eBay's camera icon does: the image is uploaded to eBay, and
+   * the handle it answers with is searched like a keyword. Supply the picture
+   * either as `image_url` (downloaded for you) or as `image_base64`; exactly
+   * one of the two is required.
+   *
+   * There is no `sort_by` — eBay ignores sorting on a visual results page.
+   *
+   * @param params - The image plus the usual listing filters and pagination.
+   * @returns Search results (with `query: null`), facets, and pagination.
+   * @throws Error - If neither or both of `image_url` / `image_base64` are given.
+   * @throws ValidationError - If eBay cannot read the image.
+   */
+  async searchByImage(params) {
+    if (Boolean(params.image_url) === Boolean(params.image_base64)) {
+      throw new Error("provide exactly one of image_url or image_base64");
+    }
+    return this.client.request("/v1/ebay/search/by-image", {
+      method: "POST",
+      body: {
+        image_url: params.image_url,
+        image_base64: params.image_base64,
+        domain: params.domain,
+        category_id: params.category_id,
+        page: params.page,
+        per_page: params.per_page,
+        condition: params.condition,
+        buying_format: params.buying_format,
+        min_price: params.min_price,
+        max_price: params.max_price,
+        free_shipping: params.free_shipping,
+        location: params.location,
+        language: params.language
+      }
+    });
+  }
   /**
    * Search completed / sold listings — eBay's sold-price history.
    *
@@ -5919,7 +5957,7 @@ var ReferenceClient5 = class {
 
 // src/ebay/client.ts
 var EbayClient = class {
-  /** Client for active search, completed/sold search, and autocomplete */
+  /** Client for active search, search by image, completed/sold search, and autocomplete */
   search;
   /** Client for item detail and catalog product reviews */
   items;