scrapebadger 0.14.0 → 0.15.0

package/dist/index.mjs

@@ -4806,6 +4806,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;
@@ -4825,6 +5067,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.
    *
@@ -4867,9 +5111,10 @@ 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);
   }
 };
 
-export { AccountRestrictedError, AmazonClient, ListingsClient as AmazonListingsClient, ProductsClient2 as AmazonProductsClient, ReferenceClient2 as AmazonReferenceClient, SearchClient4 as AmazonSearchClient, SellersClient as AmazonSellersClient, AuthenticationError, CommunitiesClient, ConflictError, GeoClient, AiModeClient as GoogleAiModeClient, AutocompleteClient as GoogleAutocompleteClient, GoogleClient, FinanceClient as GoogleFinanceClient, FlightsClient as GoogleFlightsClient, HotelsClient as GoogleHotelsClient, ImagesClient as GoogleImagesClient, JobsClient as GoogleJobsClient, LensClient as GoogleLensClient, MapsClient as GoogleMapsClient, NewsClient as GoogleNewsClient, PatentsClient as GooglePatentsClient, ProductsClient as GoogleProductsClient, ScholarClient as GoogleScholarClient, SearchClient2 as GoogleSearchClient, ShoppingClient as GoogleShoppingClient, ShortsClient as GoogleShortsClient, TrendsClient2 as GoogleTrendsClient, VideosClient as GoogleVideosClient, InsufficientCreditsError, ListsClient, NotFoundError, RateLimitError, RedditClient, PostsClient as RedditPostsClient, SearchClient3 as RedditSearchClient, SubredditsClient as RedditSubredditsClient, UsersClient3 as RedditUsersClient, ScrapeBadger, ScrapeBadgerError, ServerError, ShopeeClient, ProductsClient3 as ShopeeProductsClient, ReferenceClient3 as ShopeeReferenceClient, ReviewsClient as ShopeeReviewsClient, SearchClient5 as ShopeeSearchClient, SpacesClient, StreamClient, AdsClient as TikTokAdsClient, TikTokClient, HashtagsClient as TikTokHashtagsClient, MusicClient as TikTokMusicClient, ReferenceClient4 as TikTokReferenceClient, SearchClient6 as TikTokSearchClient, TrendingClient as TikTokTrendingClient, UsersClient4 as TikTokUsersClient, VideosClient2 as TikTokVideosClient, TimeoutError, TrendsClient, TweetsClient, TwitterClient, UsersClient, ValidationError, VintedClient, ItemsClient as VintedItemsClient, ReferenceClient as VintedReferenceClient, SearchClient as VintedSearchClient, UsersClient2 as VintedUsersClient, WebClient, WebSocketStreamError, collectAll, verifyWebhookSignature };
+export { AccountRestrictedError, AmazonClient, ListingsClient as AmazonListingsClient, ProductsClient2 as AmazonProductsClient, ReferenceClient2 as AmazonReferenceClient, SearchClient4 as AmazonSearchClient, SellersClient as AmazonSellersClient, AuthenticationError, CommunitiesClient, ConflictError, CategoriesClient as EbayCategoriesClient, EbayClient, ItemsClient2 as EbayItemsClient, ReferenceClient5 as EbayReferenceClient, SearchClient7 as EbaySearchClient, SellersClient2 as EbaySellersClient, GeoClient, AiModeClient as GoogleAiModeClient, AutocompleteClient as GoogleAutocompleteClient, GoogleClient, FinanceClient as GoogleFinanceClient, FlightsClient as GoogleFlightsClient, HotelsClient as GoogleHotelsClient, ImagesClient as GoogleImagesClient, JobsClient as GoogleJobsClient, LensClient as GoogleLensClient, MapsClient as GoogleMapsClient, NewsClient as GoogleNewsClient, PatentsClient as GooglePatentsClient, ProductsClient as GoogleProductsClient, ScholarClient as GoogleScholarClient, SearchClient2 as GoogleSearchClient, ShoppingClient as GoogleShoppingClient, ShortsClient as GoogleShortsClient, TrendsClient2 as GoogleTrendsClient, VideosClient as GoogleVideosClient, InsufficientCreditsError, ListsClient, NotFoundError, RateLimitError, RedditClient, PostsClient as RedditPostsClient, SearchClient3 as RedditSearchClient, SubredditsClient as RedditSubredditsClient, UsersClient3 as RedditUsersClient, ScrapeBadger, ScrapeBadgerError, ServerError, ShopeeClient, ProductsClient3 as ShopeeProductsClient, ReferenceClient3 as ShopeeReferenceClient, ReviewsClient as ShopeeReviewsClient, SearchClient5 as ShopeeSearchClient, SpacesClient, StreamClient, AdsClient as TikTokAdsClient, TikTokClient, HashtagsClient as TikTokHashtagsClient, MusicClient as TikTokMusicClient, ReferenceClient4 as TikTokReferenceClient, SearchClient6 as TikTokSearchClient, TrendingClient as TikTokTrendingClient, UsersClient4 as TikTokUsersClient, VideosClient2 as TikTokVideosClient, TimeoutError, TrendsClient, TweetsClient, TwitterClient, UsersClient, ValidationError, VintedClient, ItemsClient as VintedItemsClient, ReferenceClient as VintedReferenceClient, SearchClient as VintedSearchClient, UsersClient2 as VintedUsersClient, WebClient, WebSocketStreamError, collectAll, verifyWebhookSignature };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map