scrapebadger 0.10.0 → 0.12.0

package/dist/index.d.cts

@@ -406,7 +406,7 @@ interface VintedPagination {
 /**
  * Response from the search endpoint.
  */
-interface SearchResponse {
+interface SearchResponse$1 {
     /** List of matching items */
     items: VintedItemSummary[];
     /** Pagination metadata */
@@ -469,7 +469,7 @@ interface StatusesResponse {
 /**
  * Response from the markets endpoint.
  */
-interface MarketsResponse {
+interface MarketsResponse$1 {
     /** List of available markets */
     markets: VintedMarket[];
 }
@@ -528,7 +528,7 @@ interface VintedSearchParams {
  * });
  * ```
  */
-declare class SearchClient$2 {
+declare class SearchClient$3 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -551,7 +551,7 @@ declare class SearchClient$2 {
      * console.log(`Found ${results.pagination.total_entries} items`);
      * ```
      */
-    search(params: VintedSearchParams): Promise<SearchResponse>;
+    search(params: VintedSearchParams): Promise<SearchResponse$1>;
 }
 
 /**
@@ -706,7 +706,7 @@ declare class UsersClient$1 {
  * }
  * ```
  */
-declare class ReferenceClient {
+declare class ReferenceClient$1 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -784,7 +784,7 @@ declare class ReferenceClient {
      * }
      * ```
      */
-    markets(): Promise<MarketsResponse>;
+    markets(): Promise<MarketsResponse$1>;
 }
 
 /**
@@ -821,13 +821,13 @@ declare class ReferenceClient {
  */
 declare class VintedClient {
     /** Client for item search operations */
-    readonly search: SearchClient$2;
+    readonly search: SearchClient$3;
     /** Client for individual item operations */
     readonly items: ItemsClient;
     /** Client for user operations */
     readonly users: UsersClient$1;
     /** Client for reference data (brands, colors, statuses, markets) */
-    readonly reference: ReferenceClient;
+    readonly reference: ReferenceClient$1;
     /**
      * Create a new Vinted client.
      *
@@ -1232,6 +1232,65 @@ interface AiModeSearchParams {
     q: string;
     gl?: string;
     hl?: string;
+    /**
+     * Include the raw `answer_html` body in the response (can be 100s of
+     * KB). Defaults to true; set false when you only need `text_blocks` /
+     * `markdown`.
+     */
+    include_html?: boolean;
+}
+/** A source cited by an AI Mode / AI Overview answer. */
+interface AiReference {
+    title?: string | null;
+    link?: string | null;
+    snippet?: string | null;
+    source?: string | null;
+    favicon?: string | null;
+    thumbnail?: string | null;
+    index?: number | null;
+}
+/** One item inside a `list` text block. */
+interface AiListItem {
+    type?: string;
+    snippet?: string | null;
+    links?: Array<Record<string, unknown>>;
+}
+/** One row of a `table` text block (ordered cell values). */
+interface AiTableRow {
+    cells: string[];
+}
+/**
+ * A single block of the AI-generated answer. `type` is one of
+ * `paragraph` | `heading` | `list` | `table`. A `table` block carries
+ * `header` + `rows`; a `list` block carries `items`.
+ */
+interface AiTextBlock {
+    type?: string | null;
+    snippet?: string | null;
+    text?: string | null;
+    level?: number | null;
+    items?: AiListItem[];
+    citation_links?: AiReference[];
+    links?: Array<Record<string, unknown>>;
+    header?: string[];
+    rows?: AiTableRow[];
+}
+/**
+ * Response for `/v1/google/ai-mode/search`. `markdown` is a compact
+ * rendering of the whole answer; `answer_html` is the raw answer body
+ * (present unless `include_html: false`).
+ */
+interface AiModeResponse {
+    text_blocks: AiTextBlock[];
+    references: AiReference[];
+    shopping_results?: Array<Record<string, unknown>>;
+    inline_images?: Array<Record<string, unknown>>;
+    local_results?: Array<Record<string, unknown>>;
+    markdown?: string | null;
+    answer_html?: string | null;
+    query: string;
+    language: string;
+    country: string;
 }
 /**
  * Params for `/v1/google/lens/search`. Response carries `lens_results`
@@ -1344,7 +1403,15 @@ interface FlightsSearchParams {
 declare class AiModeClient {
     private readonly client;
     constructor(client: BaseClient);
-    search(params: AiModeSearchParams): Promise<GoogleResponse>;
+    /**
+     * 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.
+     */
+    search(params: AiModeSearchParams): Promise<AiModeResponse>;
 }
 
 /**
@@ -1668,7 +1735,7 @@ declare class PatentsClient {
 /**
  * Client for Google's immersive product detail endpoint.
  */
-declare class ProductsClient {
+declare class ProductsClient$1 {
     private readonly client;
     constructor(client: BaseClient);
     detail(params: ProductsDetailParams): Promise<GoogleResponse>;
@@ -1746,7 +1813,7 @@ declare class ScholarClient {
  * }
  * ```
  */
-declare class SearchClient$1 {
+declare class SearchClient$2 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -1942,7 +2009,7 @@ declare class VideosClient {
  */
 declare class GoogleClient {
     /** Google Web Search (SERP) — with optional deferred AI Overview follow-up. */
-    readonly search: SearchClient$1;
+    readonly search: SearchClient$2;
     /** Google Maps — places, reviews, photos, posts. */
     readonly maps: MapsClient;
     /** Google News — articles, topics, trending. */
@@ -1976,7 +2043,7 @@ declare class GoogleClient {
     /** Google Flights — one-way, round-trip, and multi-city itineraries. */
     readonly flights: FlightsClient;
     /** Google Products — immersive product detail. */
-    readonly products: ProductsClient;
+    readonly products: ProductsClient$1;
     constructor(client: BaseClient);
 }
 
@@ -2773,7 +2840,7 @@ interface DomainPostsResponse {
  * const domainPosts = await client.reddit.search.domainPosts({ domain: "github.com" });
  * ```
  */
-declare class SearchClient {
+declare class SearchClient$1 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -3382,7 +3449,7 @@ declare class UsersClient {
  */
 declare class RedditClient {
     /** Client for search operations (posts, subreddits, users, domain posts) */
-    readonly search: SearchClient;
+    readonly search: SearchClient$1;
     /** Client for post operations (trending, details, comments, duplicates) */
     readonly posts: PostsClient;
     /** Client for subreddit operations (details, posts, rules, moderators, wiki) */
@@ -3397,6 +3464,883 @@ declare class RedditClient {
     constructor(client: BaseClient);
 }
 
+/**
+ * TypeScript types for Amazon API responses.
+ *
+ * These interfaces mirror the backend `amazon_scraper` response schema
+ * field-for-field. Optional / nullable backend fields are typed as
+ * `Type | null`; backend list fields default to `[]` and are typed as arrays.
+ * Every datetime field ships in BOTH `*_utc` (number) and `*_at` (string) form.
+ */
+/**
+ * A parsed price with both the numeric value and its raw rendering.
+ */
+interface AmazonPrice {
+    /** Numeric price value */
+    value: number | null;
+    /** ISO currency code (e.g. "USD") */
+    currency: string | null;
+    /** Currency symbol (e.g. "$") */
+    symbol: string | null;
+    /** Raw rendered price string (e.g. "$29.99") */
+    raw: string | null;
+}
+/**
+ * Page-number pagination (Amazon listings use 1-based page numbers).
+ */
+interface Pagination {
+    /** Current page number (1-indexed) */
+    current_page: number;
+    /** Total number of pages, if known */
+    total_pages: number | null;
+    /** Total number of results, if known */
+    total_results: number | null;
+}
+/**
+ * A single supported marketplace (for /markets).
+ */
+interface MarketInfo {
+    /** Market code (e.g. "US", "UK", "DE") */
+    code: string;
+    /** Amazon domain suffix (e.g. "com", "co.uk") */
+    domain: string;
+    /** Country name */
+    country: string;
+    /** Currency code (e.g. "USD") */
+    currency: string;
+    /** Locale (e.g. "en-US") */
+    locale: string;
+    /** Market display name */
+    name: string;
+}
+/**
+ * A reference category / department alias (for /categories).
+ */
+interface CategoryInfo {
+    /** Category display name */
+    name: string;
+    /** Category alias */
+    alias: string;
+    /** Search alias used in /search `category` param */
+    search_alias: string | null;
+    /** Bestsellers browse-node ID */
+    bestseller_node: string | null;
+}
+/**
+ * Per-star rating distribution (percentages 0-100).
+ */
+interface RatingBreakdown {
+    five_star: number | null;
+    four_star: number | null;
+    three_star: number | null;
+    two_star: number | null;
+    one_star: number | null;
+}
+/**
+ * A single bestsellers-rank entry for a product.
+ */
+interface BestsellersRankEntry {
+    rank: number | null;
+    category: string | null;
+    link: string | null;
+}
+/**
+ * A buying option / variation of a product.
+ */
+interface ProductVariant {
+    asin: string;
+    attributes: Record<string, string>;
+    price: AmazonPrice | null;
+    is_current: boolean;
+}
+/**
+ * The featured-offer (buybox) winner shown on the product page.
+ */
+interface Buybox {
+    seller_name: string | null;
+    seller_id: string | null;
+    price: AmazonPrice | null;
+    fulfillment: string | null;
+}
+/**
+ * Promotional badges attached to a product.
+ */
+interface ProductBadges {
+    amazons_choice: boolean;
+    amazons_choice_keyword: string | null;
+    best_seller: boolean;
+    prime: boolean;
+    climate_pledge_friendly: boolean;
+}
+/**
+ * A clippable coupon on the product page.
+ */
+interface Coupon {
+    text: string | null;
+    discount: string | null;
+}
+/**
+ * A deal active on the product page.
+ */
+interface ProductDeal {
+    type: string | null;
+    price: AmazonPrice | null;
+    ends_at: string | null;
+}
+/**
+ * Delivery information shown on the product page.
+ */
+interface Delivery {
+    message: string | null;
+    date: string | null;
+    is_free: boolean | null;
+}
+/**
+ * A related product (frequently-bought-together / also-bought).
+ */
+interface RelatedProduct {
+    asin: string;
+    title: string | null;
+    link: string | null;
+    image: string | null;
+    price: AmazonPrice | null;
+}
+/**
+ * Full product detail (PDP).
+ */
+interface Product {
+    asin: string;
+    parent_asin: string | null;
+    title: string | null;
+    link: string | null;
+    brand: string | null;
+    brand_url: string | null;
+    manufacturer: string | null;
+    model_number: string | null;
+    price: AmazonPrice | null;
+    list_price: AmazonPrice | null;
+    savings_amount: AmazonPrice | null;
+    discount_percent: number | null;
+    rating: number | null;
+    ratings_total: number | null;
+    rating_breakdown: RatingBreakdown | null;
+    bought_past_month: string | null;
+    in_stock: boolean | null;
+    availability: string | null;
+    feature_bullets: string[];
+    description: string | null;
+    main_image: string | null;
+    images: string[];
+    images_count: number;
+    videos: string[];
+    videos_count: number;
+    has_aplus_content: boolean;
+    variants: ProductVariant[];
+    variant_asins: string[];
+    categories: string[];
+    bestsellers_rank: BestsellersRankEntry[];
+    attributes: Record<string, string>;
+    specifications: Record<string, string>;
+    dimensions: string | null;
+    weight: string | null;
+    first_available: string | null;
+    country_of_origin: string | null;
+    buybox: Buybox | null;
+    sold_by: string | null;
+    ships_from: string | null;
+    fulfilled_by: string | null;
+    is_amazon_seller: boolean | null;
+    badges: ProductBadges;
+    coupon: Coupon | null;
+    deal: ProductDeal | null;
+    delivery: Delivery | null;
+    frequently_bought_together: RelatedProduct[];
+    also_bought: RelatedProduct[];
+    answered_questions: number | null;
+    /** The product page's embedded featured reviews (max 8). */
+    top_reviews: Review[];
+    scraped_utc: number | null;
+    scraped_at: string | null;
+}
+/**
+ * A single search / category-browse result row.
+ */
+interface SearchResult {
+    position: number;
+    asin: string;
+    title: string | null;
+    link: string | null;
+    image: string | null;
+    price: AmazonPrice | null;
+    list_price: AmazonPrice | null;
+    unit_price: string | null;
+    rating: number | null;
+    ratings_total: number | null;
+    is_prime: boolean;
+    is_sponsored: boolean;
+    is_amazons_choice: boolean;
+    is_best_seller: boolean;
+    bought_past_month: string | null;
+    coupon: string | null;
+    availability: string | null;
+}
+/**
+ * The seller behind a specific offer.
+ */
+interface OfferSeller {
+    name: string | null;
+    id: string | null;
+    link: string | null;
+    rating: number | null;
+    ratings_total: number | null;
+    ratings_percentage_positive: number | null;
+}
+/**
+ * The condition of an offered item.
+ */
+interface OfferCondition {
+    is_new: boolean | null;
+    title: string | null;
+    comments: string | null;
+}
+/**
+ * Delivery terms for a specific offer.
+ */
+interface OfferDelivery {
+    is_free: boolean | null;
+    fulfilled_by_amazon: boolean | null;
+    date: string | null;
+    price: AmazonPrice | null;
+}
+/**
+ * A single seller offer for a product.
+ */
+interface Offer {
+    position: number;
+    seller: OfferSeller | null;
+    price: AmazonPrice | null;
+    condition: OfferCondition | null;
+    delivery: OfferDelivery | null;
+    buybox_winner: boolean;
+    is_prime: boolean;
+    minimum_order_quantity: number | null;
+    maximum_order_quantity: number | null;
+}
+/**
+ * The reviewer's public profile.
+ */
+interface ReviewProfile {
+    name: string | null;
+    link: string | null;
+    id: string | null;
+    image: string | null;
+}
+/**
+ * A single product review.
+ */
+interface Review {
+    id: string | null;
+    title: string | null;
+    body: string | null;
+    rating: number | null;
+    date_raw: string | null;
+    date_utc: number | null;
+    date_at: string | null;
+    review_country: string | null;
+    is_global_review: boolean;
+    profile: ReviewProfile | null;
+    verified_purchase: boolean;
+    vine_program: boolean;
+    helpful_votes: number | null;
+    variant: string | null;
+    images: string[];
+}
+/**
+ * A single bestseller / new-release row.
+ */
+interface Bestseller {
+    rank: number | null;
+    position: number;
+    asin: string;
+    title: string | null;
+    link: string | null;
+    image: string | null;
+    rating: number | null;
+    ratings_total: number | null;
+    price: AmazonPrice | null;
+}
+/**
+ * A single deal row.
+ */
+interface Deal {
+    position: number;
+    asin: string;
+    title: string | null;
+    link: string | null;
+    image: string | null;
+    deal_price: AmazonPrice | null;
+    list_price: AmazonPrice | null;
+    discount_percent: number | null;
+    deal_type: string | null;
+    is_lightning_deal: boolean;
+    badge: string | null;
+    ends_at_utc: number | null;
+    ends_at: string | null;
+}
+/**
+ * Feedback counts for a single rolling window.
+ */
+interface FeedbackWindow {
+    positive: number | null;
+    neutral: number | null;
+    negative: number | null;
+    count: number | null;
+}
+/**
+ * Seller feedback summary across rolling windows.
+ *
+ * Note: the 12-month / 90-day / 30-day windows ship on the wire under the
+ * keys `12mo`, `90d` and `30d`.
+ */
+interface SellerFeedbackSummary {
+    lifetime: FeedbackWindow | null;
+    /** 12-month feedback window */
+    "12mo": FeedbackWindow | null;
+    /** 90-day feedback window */
+    "90d": FeedbackWindow | null;
+    /** 30-day feedback window */
+    "30d": FeedbackWindow | null;
+}
+/**
+ * A seller profile.
+ */
+interface Seller {
+    seller_id: string;
+    name: string | null;
+    link: string | null;
+    rating: number | null;
+    ratings_total: number | null;
+    ratings_percentage_positive: number | null;
+    feedback: SellerFeedbackSummary | null;
+    business_name: string | null;
+    business_address: string | null;
+    member_since: string | null;
+}
+/**
+ * A single buyer-feedback entry for a seller.
+ */
+interface SellerFeedbackEntry {
+    rating: number | null;
+    comment: string | null;
+    rater: string | null;
+    date_raw: string | null;
+    date_utc: number | null;
+    date_at: string | null;
+}
+/**
+ * A single keyword suggestion.
+ */
+interface AutocompleteSuggestion {
+    value: string;
+    alias: string | null;
+}
+/** Response from the /search endpoint. */
+interface SearchResponse {
+    query: string;
+    domain: string;
+    results: SearchResult[];
+    pagination: Pagination;
+    scraped_utc: number | null;
+    scraped_at: string | null;
+}
+/** Response from the /products/{asin} endpoint. */
+interface ProductDetailResponse {
+    domain: string;
+    product: Product;
+}
+/** Response from the /products/{asin}/offers endpoint. */
+interface OffersResponse {
+    asin: string;
+    domain: string;
+    buybox: Offer | null;
+    offers: Offer[];
+    total_offers: number | null;
+    scraped_utc: number | null;
+    scraped_at: string | null;
+}
+/** Response from the /products/{asin}/reviews endpoint. */
+interface ReviewsResponse {
+    asin: string;
+    domain: string;
+    reviews: Review[];
+    rating: number | null;
+    ratings_total: number | null;
+    rating_breakdown: RatingBreakdown | null;
+    pagination: Pagination;
+    scraped_utc: number | null;
+    scraped_at: string | null;
+}
+/** Response from the /bestsellers endpoint. */
+interface BestsellersResponse {
+    domain: string;
+    category: string | null;
+    bestsellers: Bestseller[];
+    pagination: Pagination;
+    scraped_utc: number | null;
+    scraped_at: string | null;
+}
+/** Response from the /new-releases endpoint. */
+interface NewReleasesResponse {
+    domain: string;
+    category: string | null;
+    new_releases: Bestseller[];
+    pagination: Pagination;
+    scraped_utc: number | null;
+    scraped_at: string | null;
+}
+/** Response from the /deals endpoint. */
+interface DealsResponse {
+    domain: string;
+    category: string | null;
+    deals: Deal[];
+    pagination: Pagination;
+    scraped_utc: number | null;
+    scraped_at: string | null;
+}
+/** Response from the /category endpoint. */
+interface CategoryResponse {
+    domain: string;
+    node: string;
+    results: SearchResult[];
+    pagination: Pagination;
+    scraped_utc: number | null;
+    scraped_at: string | null;
+}
+/** Response from the /sellers/{seller_id} endpoint. */
+interface SellerProfileResponse {
+    domain: string;
+    seller: Seller;
+}
+/** Response from the /sellers/{seller_id}/products endpoint. */
+interface SellerProductsResponse {
+    domain: string;
+    seller_id: string;
+    products: SearchResult[];
+    pagination: Pagination;
+    scraped_utc: number | null;
+    scraped_at: string | null;
+}
+/** Response from the /sellers/{seller_id}/feedback endpoint. */
+interface SellerFeedbackResponse {
+    domain: string;
+    seller_id: string;
+    feedback: SellerFeedbackEntry[];
+    pagination: Pagination;
+    scraped_utc: number | null;
+    scraped_at: string | null;
+}
+/** Response from the /autocomplete endpoint. */
+interface AutocompleteResponse {
+    query: string;
+    domain: string;
+    suggestions: AutocompleteSuggestion[];
+}
+/** Response from the /markets endpoint. */
+interface MarketsResponse {
+    markets: MarketInfo[];
+}
+/** Response from the /categories endpoint. */
+interface CategoriesResponse {
+    categories: CategoryInfo[];
+}
+/** Parameters for searching Amazon products. */
+interface AmazonSearchParams {
+    /** Search query string */
+    query: string;
+    /** Amazon marketplace domain (default: "com") */
+    domain?: string;
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Sort order (e.g. "price_low_to_high", "featured", "review_rank") */
+    sort_by?: string;
+    /** Category / department alias to scope the search */
+    category?: string;
+    /** Minimum price filter */
+    min_price?: number;
+    /** Maximum price filter */
+    max_price?: number;
+    /** Delivery ZIP / postal code for localized price & availability */
+    zip?: string;
+    /** Preferred content language / locale (e.g. "en_US") */
+    language?: string;
+}
+/** Options for fetching product detail. */
+interface AmazonProductParams {
+    /** Amazon marketplace domain (default: "com") */
+    domain?: string;
+    /** Delivery ZIP / postal code */
+    zip?: string;
+    /** Preferred content language (e.g. "en_US") */
+    language?: string;
+}
+/** Options for fetching product offers. */
+interface AmazonOffersParams {
+    /** Amazon marketplace domain (default: "com") */
+    domain?: string;
+    /** Delivery ZIP / postal code */
+    zip?: string;
+}
+/** Options for fetching product reviews. */
+interface AmazonReviewsParams {
+    /** Amazon marketplace domain (default: "com") */
+    domain?: string;
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Sort order ("helpful" or "recent") */
+    sort_by?: "helpful" | "recent";
+    /** Filter by star rating (e.g. "five_star", "one_star") */
+    star?: string;
+    /** Restrict to verified-purchase reviews */
+    verified_only?: boolean;
+    /** Restrict to reviews containing images / video */
+    media_only?: boolean;
+}
+/** Options for the bestsellers / new-releases endpoints. */
+interface AmazonListingsParams {
+    /** Amazon marketplace domain (default: "com") */
+    domain?: string;
+    /** Bestsellers / new-releases node or category alias */
+    category?: string;
+    /** Page number (1-indexed) */
+    page?: number;
+}
+/** Options for the deals endpoint. */
+interface AmazonDealsParams {
+    /** Amazon marketplace domain (default: "com") */
+    domain?: string;
+    /** Deals category filter */
+    category?: string;
+    /** Page number (1-indexed) */
+    page?: number;
+}
+/** Options for the category-browse endpoint. */
+interface AmazonCategoryParams {
+    /** Browse-node ID (required) */
+    node: string;
+    /** Amazon marketplace domain (default: "com") */
+    domain?: string;
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Sort order */
+    sort_by?: string;
+}
+/** Options for seller storefront products / feedback endpoints. */
+interface AmazonSellerListParams {
+    /** Amazon marketplace domain (default: "com") */
+    domain?: string;
+    /** Page number (1-indexed) */
+    page?: number;
+}
+/** Options for the seller profile endpoint. */
+interface AmazonSellerParams {
+    /** Amazon marketplace domain (default: "com") */
+    domain?: string;
+}
+/** Options for the autocomplete endpoint. */
+interface AmazonAutocompleteParams {
+    /** Amazon marketplace domain (default: "com") */
+    domain?: string;
+}
+
+/**
+ * Amazon Search API client.
+ *
+ * Provides methods for keyword search and keyword autocomplete suggestions.
+ */
+
+/**
+ * Client for Amazon search and autocomplete endpoints.
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const results = await client.amazon.search.search({ query: "wireless headphones" });
+ * for (const item of results.results) {
+ *   console.log(`${item.position}. ${item.title}`);
+ * }
+ *
+ * const suggestions = await client.amazon.search.autocomplete("lapt");
+ * ```
+ */
+declare class SearchClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * 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.
+     */
+    search(params: AmazonSearchParams): Promise<SearchResponse>;
+    /**
+     * Get Amazon keyword autocomplete suggestions.
+     *
+     * @param query - Partial search query string.
+     * @param options - Optional parameters (domain).
+     * @returns Autocomplete suggestions.
+     */
+    autocomplete(query: string, options?: AmazonAutocompleteParams): Promise<AutocompleteResponse>;
+}
+
+/**
+ * Amazon Products API client.
+ *
+ * Provides methods for fetching product detail, offers, and reviews by ASIN.
+ */
+
+/**
+ * Client for Amazon product endpoints (detail, offers, reviews).
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const detail = await client.amazon.products.get("B08N5WRWNW");
+ * console.log(detail.product.title);
+ *
+ * const offers = await client.amazon.products.offers("B08N5WRWNW");
+ * console.log(`${offers.total_offers} offers`);
+ *
+ * const reviews = await client.amazon.products.reviews("B08N5WRWNW");
+ * ```
+ */
+declare class ProductsClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * 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.
+     */
+    get(asin: string, options?: AmazonProductParams): Promise<ProductDetailResponse>;
+    /**
+     * 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.
+     */
+    offers(asin: string, options?: AmazonOffersParams): Promise<OffersResponse>;
+    /**
+     * 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.
+     */
+    reviews(asin: string, options?: AmazonReviewsParams): Promise<ReviewsResponse>;
+}
+
+/**
+ * Amazon Listings API client.
+ *
+ * Provides methods for bestsellers, new releases, deals, and category browse.
+ */
+
+/**
+ * Client for Amazon listing endpoints (bestsellers, new releases, deals, category).
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const top = await client.amazon.listings.bestsellers({ category: "electronics" });
+ * for (const item of top.bestsellers) {
+ *   console.log(`#${item.rank}: ${item.title}`);
+ * }
+ * ```
+ */
+declare class ListingsClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Get the bestsellers list for a marketplace / category.
+     *
+     * @param options - Optional parameters (domain, category, page).
+     * @returns Bestsellers response with ranked products and pagination.
+     */
+    bestsellers(options?: AmazonListingsParams): Promise<BestsellersResponse>;
+    /**
+     * 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.
+     */
+    newReleases(options?: AmazonListingsParams): Promise<NewReleasesResponse>;
+    /**
+     * Get current deals for a marketplace / category.
+     *
+     * @param options - Optional parameters (domain, category, page).
+     * @returns Deals response with deal rows and pagination.
+     */
+    deals(options?: AmazonDealsParams): Promise<DealsResponse>;
+    /**
+     * Browse a category / department by browse-node ID.
+     *
+     * @param params - Parameters including the required node ID.
+     * @returns Category response with result rows and pagination.
+     */
+    category(params: AmazonCategoryParams): Promise<CategoryResponse>;
+}
+
+/**
+ * Amazon Sellers API client.
+ *
+ * Provides methods for seller profile, storefront products, and buyer feedback.
+ */
+
+/**
+ * Client for Amazon seller endpoints (profile, products, feedback).
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const profile = await client.amazon.sellers.get("A2L77EE7U53NWQ");
+ * console.log(profile.seller.name);
+ *
+ * const products = await client.amazon.sellers.products("A2L77EE7U53NWQ");
+ * ```
+ */
+declare class SellersClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * 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.
+     */
+    get(sellerId: string, options?: AmazonSellerParams): Promise<SellerProfileResponse>;
+    /**
+     * 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.
+     */
+    products(sellerId: string, options?: AmazonSellerListParams): Promise<SellerProductsResponse>;
+    /**
+     * 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.
+     */
+    feedback(sellerId: string, options?: AmazonSellerListParams): Promise<SellerFeedbackResponse>;
+}
+
+/**
+ * Amazon Reference Data API client.
+ *
+ * Provides methods for fetching the static marketplace and category lists.
+ */
+
+/**
+ * Client for Amazon reference data endpoints (markets, categories).
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const markets = await client.amazon.reference.markets();
+ * for (const m of markets.markets) {
+ *   console.log(`${m.code}: ${m.domain} (${m.currency})`);
+ * }
+ *
+ * const categories = await client.amazon.reference.categories();
+ * ```
+ */
+declare class ReferenceClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Get all supported Amazon marketplaces.
+     *
+     * @returns Markets response with all supported marketplaces.
+     */
+    markets(): Promise<MarketsResponse>;
+    /**
+     * Get the reference department / category aliases.
+     *
+     * @returns Categories response with all category aliases.
+     */
+    categories(): Promise<CategoriesResponse>;
+}
+
+/**
+ * Amazon API client.
+ *
+ * Provides access to all Amazon API endpoints through specialized sub-clients.
+ */
+
+/**
+ * Amazon API client with access to all Amazon endpoints.
+ *
+ * Provides sub-clients for different resource types:
+ * - `search` - Keyword search and autocomplete
+ * - `products` - Product detail, offers, and reviews
+ * - `listings` - Bestsellers, new releases, deals, and category browse
+ * - `sellers` - Seller profile, storefront products, and feedback
+ * - `reference` - Reference data (markets, categories)
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * // Search products
+ * const results = await client.amazon.search.search({ query: "wireless headphones" });
+ *
+ * // Get product detail
+ * const detail = await client.amazon.products.get("B08N5WRWNW");
+ *
+ * // Get bestsellers
+ * const top = await client.amazon.listings.bestsellers({ category: "electronics" });
+ *
+ * // Get a seller profile
+ * const seller = await client.amazon.sellers.get("A2L77EE7U53NWQ");
+ *
+ * // Get reference data
+ * const markets = await client.amazon.reference.markets();
+ * ```
+ */
+declare class AmazonClient {
+    /** Client for keyword search and autocomplete */
+    readonly search: SearchClient;
+    /** Client for product detail, offers, and reviews */
+    readonly products: ProductsClient;
+    /** Client for bestsellers, new releases, deals, and category browse */
+    readonly listings: ListingsClient;
+    /** Client for seller profile, products, and feedback */
+    readonly sellers: SellersClient;
+    /** Client for reference data (markets, categories) */
+    readonly reference: ReferenceClient;
+    /**
+     * Create a new Amazon client.
+     *
+     * @param client - The base HTTP client for making requests.
+     */
+    constructor(client: BaseClient);
+}
+
 /**
  * Main ScrapeBadger client.
  *
@@ -3447,6 +4391,8 @@ declare class ScrapeBadger {
     readonly google: GoogleClient;
     /** Reddit scraper API client */
     readonly reddit: RedditClient;
+    /** Amazon scraper API client — 14 endpoints */
+    readonly amazon: AmazonClient;
     /**
      * Create a new ScrapeBadger client.
      *
@@ -3475,4 +4421,4 @@ declare class ScrapeBadger {
     constructor(config?: Partial<ScrapeBadgerConfig>);
 }
 
-export { type AiModeSearchParams, type AutocompleteParams, type DetectOptions, type DetectResult, type DomainPostsResponse, type FinanceQuoteParams, type FlightsSearchParams, type FlightsStopsFilter, type FlightsTravelClass, type FlightsTripType, 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, type GoogleResponse, ScholarClient as GoogleScholarClient, SearchClient$1 as GoogleSearchClient, type GoogleSearchParams, ShoppingClient as GoogleShoppingClient, ShortsClient as GoogleShortsClient, TrendsClient as GoogleTrendsClient, VideosClient as GoogleVideosClient, type HotelsDetailsParams, type HotelsSearchParams, type ImagesSearchParams, type JobsSearchParams, type LensSearchParams, type MapsPhotosParams, type MapsPlaceParams, type MapsPostsParams, type MapsReviewsParams, type MapsSearchParams, type NewsSearchParams, type NewsTopicsParams, type NewsTrendingParams, type PatentsDetailParams, type PatentsSearchParams, type PopularSubredditsResponse, type PostCommentsResponse, type PostDetailResponse, type PostDuplicatesResponse, type ProductsDetailParams, type RedditAward, RedditClient, type RedditComment, type RedditModeratedSubreddit, type RedditPagination, type RedditPost, PostsClient as RedditPostsClient, type RedditRule, SearchClient as RedditSearchClient, type RedditSubreddit, SubredditsClient as RedditSubredditsClient, type RedditTrophy, type RedditUser, type UserProfileResponse as RedditUserProfileResponse, type RedditUserSubreddit, UsersClient as RedditUsersClient, type RedditWikiPage, type ScholarAuthorCitationParams, type ScholarAuthorParams, type ScholarCiteParams, type ScholarProfilesParams, type ScholarSearchParams, ScrapeBadger, ScrapeBadgerConfig, type ScrapeOptions, type ScrapeResult, type SearchPostsResponse, type SearchSubredditsResponse, type SearchUsersResponse, type ShoppingClickParams, type ShoppingProductParams, type ShoppingSearchParams, type ShortsSearchParams, type SubredditDetailResponse, type SubredditPostsResponse, type SubredditRulesResponse, type SubredditWikiPagesResponse, type TrendingPostsResponse, type TrendsAutocompleteParams, type TrendsInterestParams, type TrendsRegionsParams, type TrendsRelatedParams, type TrendsTrendingParams, TwitterClient, type UserCommentsResponse, type UserModeratedResponse, type UserPostsResponse, type UserTrophiesResponse, type VideosSearchParams, type VintedBrand, type BrandsResponse as VintedBrandsResponse, VintedClient, type VintedColor, type ColorsResponse as VintedColorsResponse, type VintedItemDetail, type ItemDetailResponse as VintedItemDetailResponse, type VintedItemSummary, ItemsClient as VintedItemsClient, type VintedMarket, type MarketsResponse as VintedMarketsResponse, type VintedPagination, type VintedPhoto, type VintedPrice, ReferenceClient as VintedReferenceClient, SearchClient$2 as VintedSearchClient, type VintedSearchParams, type SearchResponse as VintedSearchResponse, type VintedSellerSummary, type VintedStatus, type StatusesResponse as VintedStatusesResponse, type UserItemsResponse as VintedUserItemsResponse, type VintedUserProfile, type UserProfileResponse$1 as VintedUserProfileResponse, type VintedUserSummary, UsersClient$1 as VintedUsersClient, WebClient, type WikiPageResponse };
+export { type AiListItem, type AiModeResponse, type AiModeSearchParams, type AiReference, type AiTableRow, type AiTextBlock, type AmazonAutocompleteParams, type AutocompleteResponse as AmazonAutocompleteResponse, type AutocompleteSuggestion as AmazonAutocompleteSuggestion, type Bestseller as AmazonBestseller, type BestsellersRankEntry as AmazonBestsellersRankEntry, type BestsellersResponse as AmazonBestsellersResponse, type Buybox as AmazonBuybox, type CategoriesResponse as AmazonCategoriesResponse, type CategoryInfo as AmazonCategoryInfo, type AmazonCategoryParams, type CategoryResponse as AmazonCategoryResponse, AmazonClient, type Coupon as AmazonCoupon, type Deal as AmazonDeal, type AmazonDealsParams, type DealsResponse as AmazonDealsResponse, type Delivery as AmazonDelivery, type FeedbackWindow as AmazonFeedbackWindow, ListingsClient as AmazonListingsClient, type AmazonListingsParams, type MarketInfo as AmazonMarketInfo, type MarketsResponse as AmazonMarketsResponse, type NewReleasesResponse as AmazonNewReleasesResponse, type Offer as AmazonOffer, type OfferCondition as AmazonOfferCondition, type OfferDelivery as AmazonOfferDelivery, type OfferSeller as AmazonOfferSeller, type AmazonOffersParams, type OffersResponse as AmazonOffersResponse, type Pagination as AmazonPagination, type AmazonPrice, type Product as AmazonProduct, type ProductBadges as AmazonProductBadges, type ProductDeal as AmazonProductDeal, type ProductDetailResponse as AmazonProductDetailResponse, type AmazonProductParams, type ProductVariant as AmazonProductVariant, ProductsClient as AmazonProductsClient, type RatingBreakdown as AmazonRatingBreakdown, ReferenceClient as AmazonReferenceClient, type RelatedProduct as AmazonRelatedProduct, type Review as AmazonReview, type ReviewProfile as AmazonReviewProfile, type AmazonReviewsParams, type ReviewsResponse as AmazonReviewsResponse, SearchClient as AmazonSearchClient, type AmazonSearchParams, type SearchResponse as AmazonSearchResponse, type SearchResult as AmazonSearchResult, type Seller as AmazonSeller, type SellerFeedbackEntry as AmazonSellerFeedbackEntry, type SellerFeedbackResponse as AmazonSellerFeedbackResponse, type SellerFeedbackSummary as AmazonSellerFeedbackSummary, type AmazonSellerListParams, type AmazonSellerParams, type SellerProductsResponse as AmazonSellerProductsResponse, type SellerProfileResponse as AmazonSellerProfileResponse, SellersClient as AmazonSellersClient, type AutocompleteParams, type DetectOptions, type DetectResult, type DomainPostsResponse, type FinanceQuoteParams, type FlightsSearchParams, type FlightsStopsFilter, type FlightsTravelClass, type FlightsTripType, 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$1 as GoogleProductsClient, type GoogleResponse, ScholarClient as GoogleScholarClient, SearchClient$2 as GoogleSearchClient, type GoogleSearchParams, ShoppingClient as GoogleShoppingClient, ShortsClient as GoogleShortsClient, TrendsClient as GoogleTrendsClient, VideosClient as GoogleVideosClient, type HotelsDetailsParams, type HotelsSearchParams, type ImagesSearchParams, type JobsSearchParams, type LensSearchParams, type MapsPhotosParams, type MapsPlaceParams, type MapsPostsParams, type MapsReviewsParams, type MapsSearchParams, type NewsSearchParams, type NewsTopicsParams, type NewsTrendingParams, type PatentsDetailParams, type PatentsSearchParams, type PopularSubredditsResponse, type PostCommentsResponse, type PostDetailResponse, type PostDuplicatesResponse, type ProductsDetailParams, type RedditAward, RedditClient, type RedditComment, type RedditModeratedSubreddit, type RedditPagination, type RedditPost, PostsClient as RedditPostsClient, type RedditRule, SearchClient$1 as RedditSearchClient, type RedditSubreddit, SubredditsClient as RedditSubredditsClient, type RedditTrophy, type RedditUser, type UserProfileResponse as RedditUserProfileResponse, type RedditUserSubreddit, UsersClient as RedditUsersClient, type RedditWikiPage, type ScholarAuthorCitationParams, type ScholarAuthorParams, type ScholarCiteParams, type ScholarProfilesParams, type ScholarSearchParams, ScrapeBadger, ScrapeBadgerConfig, type ScrapeOptions, type ScrapeResult, type SearchPostsResponse, type SearchSubredditsResponse, type SearchUsersResponse, type ShoppingClickParams, type ShoppingProductParams, type ShoppingSearchParams, type ShortsSearchParams, type SubredditDetailResponse, type SubredditPostsResponse, type SubredditRulesResponse, type SubredditWikiPagesResponse, type TrendingPostsResponse, type TrendsAutocompleteParams, type TrendsInterestParams, type TrendsRegionsParams, type TrendsRelatedParams, type TrendsTrendingParams, TwitterClient, type UserCommentsResponse, type UserModeratedResponse, type UserPostsResponse, type UserTrophiesResponse, type VideosSearchParams, type VintedBrand, type BrandsResponse as VintedBrandsResponse, VintedClient, type VintedColor, type ColorsResponse as VintedColorsResponse, type VintedItemDetail, type ItemDetailResponse as VintedItemDetailResponse, type VintedItemSummary, ItemsClient as VintedItemsClient, type VintedMarket, type MarketsResponse$1 as VintedMarketsResponse, type VintedPagination, type VintedPhoto, type VintedPrice, ReferenceClient$1 as VintedReferenceClient, SearchClient$3 as VintedSearchClient, type VintedSearchParams, type SearchResponse$1 as VintedSearchResponse, type VintedSellerSummary, type VintedStatus, type StatusesResponse as VintedStatusesResponse, type UserItemsResponse as VintedUserItemsResponse, type VintedUserProfile, type UserProfileResponse$1 as VintedUserProfileResponse, type VintedUserSummary, UsersClient$1 as VintedUsersClient, WebClient, type WikiPageResponse };