scrapebadger 0.13.1 → 0.15.0

package/dist/index.js

@@ -2531,6 +2531,19 @@ var SearchClient = class {
    * });
    * console.log(`Found ${results.pagination.total_entries} items`);
    * ```
+   *
+   * @example
+   * ```typescript
+   * // Filter results to sellers physically located in France or Belgium.
+   * // Billing: 1 base credit + 1 credit per uncached seller looked up.
+   * const local = await client.vinted.search.search({
+   *   query: "vintage jacket",
+   *   seller_country: "fr,be",
+   * });
+   * for (const item of local.items) {
+   *   console.log(`${item.title} — seller in ${item.seller_country_code}`);
+   * }
+   * ```
    */
   async search(params) {
     return this.client.request("/v1/vinted/search", {
@@ -2544,7 +2557,8 @@ var SearchClient = class {
         brand_ids: params.brand_ids,
         color_ids: params.color_ids,
         status_ids: params.status_ids,
-        order: params.order
+        order: params.order,
+        seller_country: params.seller_country
       }
     });
   }
@@ -4798,6 +4812,248 @@ var TikTokClient = class {
   }
 };
 
+// src/ebay/search.ts
+var SearchClient7 = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Search an eBay marketplace for active listings.
+   *
+   * @param params - Search parameters including query, filters, and pagination.
+   * @returns Search results with cards, facets, and pagination metadata.
+   * @throws AuthenticationError - If the API key is invalid.
+   * @throws ValidationError - If the parameters are invalid.
+   */
+  async search(params) {
+    return this.client.request("/v1/ebay/search", {
+      params: {
+        query: params.query,
+        domain: params.domain,
+        category_id: params.category_id,
+        page: params.page,
+        per_page: params.per_page,
+        sort_by: params.sort_by,
+        condition: params.condition,
+        buying_format: params.buying_format,
+        min_price: params.min_price,
+        max_price: params.max_price,
+        free_shipping: params.free_shipping
+      }
+    });
+  }
+  /**
+   * Search completed / sold listings — eBay's sold-price history.
+   *
+   * @param params - Search parameters including query, filters, and pagination.
+   * @returns Search results (with `sold: true`), facets, and pagination.
+   */
+  async completed(params) {
+    return this.client.request("/v1/ebay/completed", {
+      params: {
+        query: params.query,
+        domain: params.domain,
+        category_id: params.category_id,
+        page: params.page,
+        per_page: params.per_page,
+        sort_by: params.sort_by,
+        condition: params.condition,
+        min_price: params.min_price,
+        max_price: params.max_price
+      }
+    });
+  }
+  /**
+   * Get eBay keyword autocomplete suggestions.
+   *
+   * @param query - Partial search query prefix.
+   * @param options - Optional parameters (domain).
+   * @returns Autocomplete suggestions.
+   */
+  async autocomplete(query, options = {}) {
+    return this.client.request("/v1/ebay/autocomplete", {
+      params: { query, domain: options.domain }
+    });
+  }
+};
+
+// src/ebay/items.ts
+var ItemsClient2 = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get a single eBay listing's full detail.
+   *
+   * @param itemId - The eBay item id.
+   * @param options - Optional parameters (domain).
+   * @returns Item detail including specifics, shipping, and seller summary.
+   * @throws NotFoundError - If the item doesn't exist.
+   */
+  async get(itemId, options = {}) {
+    return this.client.request(
+      `/v1/ebay/items/${itemId}`,
+      { params: { domain: options.domain } }
+    );
+  }
+  /**
+   * Get the catalog product reviews shown on an eBay listing.
+   *
+   * @param itemId - The eBay item id.
+   * @param options - Optional parameters (domain, page, productId).
+   * @returns Reviews response with reviews, aggregate rating, and histogram.
+   */
+  async reviews(itemId, options = {}) {
+    return this.client.request(
+      `/v1/ebay/items/${itemId}/reviews`,
+      {
+        params: {
+          domain: options.domain,
+          page: options.page,
+          product_id: options.productId
+        }
+      }
+    );
+  }
+};
+
+// src/ebay/sellers.ts
+var SellersClient2 = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get an eBay seller's public profile.
+   *
+   * @param username - The seller username.
+   * @param options - Optional parameters (domain).
+   * @returns Seller profile response.
+   * @throws NotFoundError - If the seller doesn't exist.
+   */
+  async get(username, options = {}) {
+    return this.client.request(
+      `/v1/ebay/sellers/${username}`,
+      { params: { domain: options.domain } }
+    );
+  }
+  /**
+   * List the active listings of a single eBay seller.
+   *
+   * @param username - The seller username.
+   * @param options - Optional parameters (domain, query, page, per_page).
+   * @returns Seller items response with result cards and pagination.
+   */
+  async items(username, options = {}) {
+    return this.client.request(
+      `/v1/ebay/sellers/${username}/items`,
+      {
+        params: {
+          domain: options.domain,
+          query: options.query,
+          page: options.page,
+          per_page: options.per_page
+        }
+      }
+    );
+  }
+  /**
+   * Get a seller's recent feedback comments.
+   *
+   * @param username - The seller username.
+   * @param options - Optional parameters (domain, page).
+   * @returns Seller feedback response with feedback entries and pagination.
+   */
+  async feedback(username, options = {}) {
+    return this.client.request(
+      `/v1/ebay/sellers/${username}/feedback`,
+      { params: { domain: options.domain, page: options.page } }
+    );
+  }
+};
+
+// src/ebay/categories.ts
+var CategoriesClient = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List active listings within an eBay category.
+   *
+   * @param categoryId - The eBay category id.
+   * @param options - Optional parameters (domain, page, per_page, sort_by, min_price, max_price).
+   * @returns Category response with result cards, facets, and pagination.
+   */
+  async browse(categoryId, options = {}) {
+    return this.client.request(
+      `/v1/ebay/categories/${categoryId}/items`,
+      {
+        params: {
+          domain: options.domain,
+          page: options.page,
+          per_page: options.per_page,
+          sort_by: options.sort_by,
+          min_price: options.min_price,
+          max_price: options.max_price
+        }
+      }
+    );
+  }
+  /**
+   * List eBay's reference top-level category ids.
+   *
+   * @returns Categories response with all category aliases.
+   */
+  async list() {
+    return this.client.request("/v1/ebay/categories");
+  }
+};
+
+// src/ebay/reference.ts
+var ReferenceClient5 = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get all supported eBay marketplaces.
+   *
+   * @returns Markets response with all supported marketplaces.
+   */
+  async markets() {
+    return this.client.request("/v1/ebay/markets");
+  }
+};
+
+// src/ebay/client.ts
+var EbayClient = class {
+  /** Client for active search, completed/sold search, and autocomplete */
+  search;
+  /** Client for item detail and catalog product reviews */
+  items;
+  /** Client for seller profile, items, and feedback */
+  sellers;
+  /** Client for category browse and the reference category list */
+  categories;
+  /** Client for reference data (markets) */
+  reference;
+  /**
+   * Create a new eBay client.
+   *
+   * @param client - The base HTTP client for making requests.
+   */
+  constructor(client) {
+    this.search = new SearchClient7(client);
+    this.items = new ItemsClient2(client);
+    this.sellers = new SellersClient2(client);
+    this.categories = new CategoriesClient(client);
+    this.reference = new ReferenceClient5(client);
+  }
+};
+
 // src/client.ts
 var ScrapeBadger = class {
   baseClient;
@@ -4817,6 +5073,8 @@ var ScrapeBadger = class {
   shopee;
   /** TikTok scraper API client — 26 endpoints */
   tiktok;
+  /** eBay scraper API client — 12 endpoints across 18 markets */
+  ebay;
   /**
    * Create a new ScrapeBadger client.
    *
@@ -4859,6 +5117,7 @@ var ScrapeBadger = class {
     this.amazon = new AmazonClient(this.baseClient);
     this.shopee = new ShopeeClient(this.baseClient);
     this.tiktok = new TikTokClient(this.baseClient);
+    this.ebay = new EbayClient(this.baseClient);
   }
 };
 
@@ -4872,6 +5131,12 @@ exports.AmazonSellersClient = SellersClient;
 exports.AuthenticationError = AuthenticationError;
 exports.CommunitiesClient = CommunitiesClient;
 exports.ConflictError = ConflictError;
+exports.EbayCategoriesClient = CategoriesClient;
+exports.EbayClient = EbayClient;
+exports.EbayItemsClient = ItemsClient2;
+exports.EbayReferenceClient = ReferenceClient5;
+exports.EbaySearchClient = SearchClient7;
+exports.EbaySellersClient = SellersClient2;
 exports.GeoClient = GeoClient;
 exports.GoogleAiModeClient = AiModeClient;
 exports.GoogleAutocompleteClient = AutocompleteClient;