scrapebadger 0.10.0 → 0.12.0

package/dist/index.js

@@ -2772,6 +2772,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 }
@@ -3908,6 +3916,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;
@@ -3921,6 +4202,8 @@ var ScrapeBadger = class {
   google;
   /** Reddit scraper API client */
   reddit;
+  /** Amazon scraper API client — 14 endpoints */
+  amazon;
   /**
    * Create a new ScrapeBadger client.
    *
@@ -3960,10 +4243,17 @@ 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);
   }
 };
 
 exports.AccountRestrictedError = AccountRestrictedError;
+exports.AmazonClient = AmazonClient;
+exports.AmazonListingsClient = ListingsClient;
+exports.AmazonProductsClient = ProductsClient2;
+exports.AmazonReferenceClient = ReferenceClient2;
+exports.AmazonSearchClient = SearchClient4;
+exports.AmazonSellersClient = SellersClient;
 exports.AuthenticationError = AuthenticationError;
 exports.CommunitiesClient = CommunitiesClient;
 exports.ConflictError = ConflictError;