scrapebadger 0.10.0 → 0.12.0

package/dist/index.mjs

@@ -2766,6 +2766,14 @@ var AiModeClient = class {
   constructor(client) {
     this.client = client;
   }
+  /**
+   * Get an AI-generated answer from Google's AI Mode (udm=50).
+   *
+   * The response carries structured `text_blocks` (prose, headings,
+   * comparison `table` blocks and lists), a flat `references` list, a
+   * compact `markdown` rendering and — unless `include_html: false` —
+   * the raw `answer_html` body.
+   */
   async search(params) {
     return this.client.request("/v1/google/ai-mode/search", {
       params: { ...params }
@@ -3902,6 +3910,279 @@ var RedditClient = class {
   }
 };
 
+// src/amazon/search.ts
+var SearchClient4 = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Search Amazon for products by keyword.
+   *
+   * @param params - Search parameters including query, filters, and pagination.
+   * @returns Search results with rows 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/amazon/search", {
+      params: {
+        query: params.query,
+        domain: params.domain,
+        page: params.page,
+        sort_by: params.sort_by,
+        category: params.category,
+        min_price: params.min_price,
+        max_price: params.max_price,
+        zip: params.zip,
+        language: params.language
+      }
+    });
+  }
+  /**
+   * Get Amazon keyword autocomplete suggestions.
+   *
+   * @param query - Partial search query string.
+   * @param options - Optional parameters (domain).
+   * @returns Autocomplete suggestions.
+   */
+  async autocomplete(query, options = {}) {
+    return this.client.request("/v1/amazon/autocomplete", {
+      params: { query, domain: options.domain }
+    });
+  }
+};
+
+// src/amazon/products.ts
+var ProductsClient2 = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get full product detail (PDP) for an ASIN.
+   *
+   * @param asin - The product ASIN.
+   * @param options - Optional parameters (domain, zip, language).
+   * @returns Product detail including variants, badges, buybox, and related products.
+   * @throws NotFoundError - If the product doesn't exist.
+   */
+  async get(asin, options = {}) {
+    return this.client.request(
+      `/v1/amazon/products/${asin}`,
+      {
+        params: {
+          domain: options.domain,
+          zip: options.zip,
+          language: options.language
+        }
+      }
+    );
+  }
+  /**
+   * Get all-seller offers (and the buybox winner) for an ASIN.
+   *
+   * @param asin - The product ASIN.
+   * @param options - Optional parameters (domain, zip).
+   * @returns Offers response with the buybox winner and full offer list.
+   */
+  async offers(asin, options = {}) {
+    return this.client.request(
+      `/v1/amazon/products/${asin}/offers`,
+      { params: { domain: options.domain, zip: options.zip } }
+    );
+  }
+  /**
+   * Get product reviews for an ASIN.
+   *
+   * @param asin - The product ASIN.
+   * @param options - Optional parameters (domain, page, sort_by, star, verified_only, media_only).
+   * @returns Reviews response with reviews, aggregate rating, and breakdown.
+   */
+  async reviews(asin, options = {}) {
+    return this.client.request(
+      `/v1/amazon/products/${asin}/reviews`,
+      {
+        params: {
+          domain: options.domain,
+          page: options.page,
+          sort_by: options.sort_by,
+          star: options.star,
+          verified_only: options.verified_only,
+          media_only: options.media_only
+        }
+      }
+    );
+  }
+};
+
+// src/amazon/listings.ts
+var ListingsClient = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get the bestsellers list for a marketplace / category.
+   *
+   * @param options - Optional parameters (domain, category, page).
+   * @returns Bestsellers response with ranked products and pagination.
+   */
+  async bestsellers(options = {}) {
+    return this.client.request("/v1/amazon/bestsellers", {
+      params: {
+        domain: options.domain,
+        category: options.category,
+        page: options.page
+      }
+    });
+  }
+  /**
+   * Get the new-releases list for a marketplace / category.
+   *
+   * @param options - Optional parameters (domain, category, page).
+   * @returns New-releases response with ranked products and pagination.
+   */
+  async newReleases(options = {}) {
+    return this.client.request("/v1/amazon/new-releases", {
+      params: {
+        domain: options.domain,
+        category: options.category,
+        page: options.page
+      }
+    });
+  }
+  /**
+   * Get current deals for a marketplace / category.
+   *
+   * @param options - Optional parameters (domain, category, page).
+   * @returns Deals response with deal rows and pagination.
+   */
+  async deals(options = {}) {
+    return this.client.request("/v1/amazon/deals", {
+      params: {
+        domain: options.domain,
+        category: options.category,
+        page: options.page
+      }
+    });
+  }
+  /**
+   * Browse a category / department by browse-node ID.
+   *
+   * @param params - Parameters including the required node ID.
+   * @returns Category response with result rows and pagination.
+   */
+  async category(params) {
+    return this.client.request("/v1/amazon/category", {
+      params: {
+        node: params.node,
+        domain: params.domain,
+        page: params.page,
+        sort_by: params.sort_by
+      }
+    });
+  }
+};
+
+// src/amazon/sellers.ts
+var SellersClient = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get a seller's profile and ratings.
+   *
+   * @param sellerId - The seller ID.
+   * @param options - Optional parameters (domain).
+   * @returns Seller profile response.
+   * @throws NotFoundError - If the seller doesn't exist.
+   */
+  async get(sellerId, options = {}) {
+    return this.client.request(
+      `/v1/amazon/sellers/${sellerId}`,
+      { params: { domain: options.domain } }
+    );
+  }
+  /**
+   * Get a seller's storefront listings.
+   *
+   * @param sellerId - The seller ID.
+   * @param options - Optional parameters (domain, page).
+   * @returns Seller products response with result rows and pagination.
+   */
+  async products(sellerId, options = {}) {
+    return this.client.request(
+      `/v1/amazon/sellers/${sellerId}/products`,
+      { params: { domain: options.domain, page: options.page } }
+    );
+  }
+  /**
+   * Get buyer feedback entries for a seller.
+   *
+   * @param sellerId - The seller ID.
+   * @param options - Optional parameters (domain, page).
+   * @returns Seller feedback response with feedback entries and pagination.
+   */
+  async feedback(sellerId, options = {}) {
+    return this.client.request(
+      `/v1/amazon/sellers/${sellerId}/feedback`,
+      { params: { domain: options.domain, page: options.page } }
+    );
+  }
+};
+
+// src/amazon/reference.ts
+var ReferenceClient2 = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get all supported Amazon marketplaces.
+   *
+   * @returns Markets response with all supported marketplaces.
+   */
+  async markets() {
+    return this.client.request("/v1/amazon/markets");
+  }
+  /**
+   * Get the reference department / category aliases.
+   *
+   * @returns Categories response with all category aliases.
+   */
+  async categories() {
+    return this.client.request("/v1/amazon/categories");
+  }
+};
+
+// src/amazon/client.ts
+var AmazonClient = class {
+  /** Client for keyword search and autocomplete */
+  search;
+  /** Client for product detail, offers, and reviews */
+  products;
+  /** Client for bestsellers, new releases, deals, and category browse */
+  listings;
+  /** Client for seller profile, products, and feedback */
+  sellers;
+  /** Client for reference data (markets, categories) */
+  reference;
+  /**
+   * Create a new Amazon client.
+   *
+   * @param client - The base HTTP client for making requests.
+   */
+  constructor(client) {
+    this.search = new SearchClient4(client);
+    this.products = new ProductsClient2(client);
+    this.listings = new ListingsClient(client);
+    this.sellers = new SellersClient(client);
+    this.reference = new ReferenceClient2(client);
+  }
+};
+
 // src/client.ts
 var ScrapeBadger = class {
   baseClient;
@@ -3915,6 +4196,8 @@ var ScrapeBadger = class {
   google;
   /** Reddit scraper API client */
   reddit;
+  /** Amazon scraper API client — 14 endpoints */
+  amazon;
   /**
    * Create a new ScrapeBadger client.
    *
@@ -3954,9 +4237,10 @@ var ScrapeBadger = class {
     this.vinted = new VintedClient(this.baseClient);
     this.google = new GoogleClient(this.baseClient);
     this.reddit = new RedditClient(this.baseClient);
+    this.amazon = new AmazonClient(this.baseClient);
   }
 };
 
-export { AccountRestrictedError, 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, SpacesClient, StreamClient, 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, 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, SpacesClient, StreamClient, 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