Category Top Products

Returns list of top products in a category, ranked by selected metrics.

Variants:

• Time-series (this endpoint): GET /v5/shopper-sales/categories/top-products — data broken down by date for trend analysis.
• Aggregated: GET /v5/shopper-sales/categories/top-products/aggregated — a single summary across the entire date range.

Both variants accept the same input parameters. The time-series response includes a date field per record; the aggregated response omits it and returns one consolidated row.

Possible output fields:

• date: Date of the data point (time-series only) (time-series only)
• asin: Amazon Standard Identification Number of the product
• name: Product name
• brand: Brand name of the product
• category_id: Category ID the product belongs to
• category_name: Category name the product belongs to
• views: Number of product page views
• units_sold: Number of units sold
• revenue: Revenue generated (local currency)
• revenue_in_usd: Revenue generated (USD)
• price: Product price as a string
• price_value: Product price as a numeric value
• price_last_scraped_date: Date when the price was last recorded
• average_unit_price: Average selling price per unit
• rating: Product rating score
• reviews: Number of customer reviews
• thumbnail: URL of the product thumbnail image
• best_seller_rank: Product's best seller rank
• best_seller_category_id: Category ID in which the product is a best seller
• best_seller_category_name: Category name in which the product is a best seller
• prime: Whether the product is available with Amazon Prime
• amazon_brand: Whether the product is an Amazon private label brand
• amazon_exclusive: Whether the product is exclusive to Amazon
• amazons_choice_keyword: Keyword for which this product has the "Amazon's Choice" badge
• small_business: Whether the product is from a small business seller
• climate_pledge_friendly: Whether the product has the Climate Pledge Friendly badge

Constraints:

• domain and category are required
• granularity supports monthly or weekly
• Supports pagination (limit, offset, sort, asc)

This endpoint uses data credits. See the data credits guide to estimate costs.

Request

Endpoint: GET /v5/shopper-sales/categories/top-products

Query parameters

• domain (string, required): Amazon domain. Supported domains: amazon.com, amazon.co.uk, amazon.it, amazon.fr, amazon.de, amazon.ca. All category IDs, brands, and ASINs are domain-specific and must match the selected domain
• granularity (string): Time granularity for the returned values Allowed: monthly, weekly.
• start_date (string): Start date in 'YYYY-MM' or 'YYYY-MM-DD' format. For weekly granularity, automatically adjusted to the first Sunday of the specified month.
• end_date (string): End date in 'YYYY-MM' or 'YYYY-MM-DD' format. For weekly granularity with MTD=true, automatically set to the latest available Saturday. For weekly granularity with MTD=false, automatically adjusted to the last Saturday of the specified month.
• metrics (array): Comma-separated list of metrics: amazon_brand, amazon_exclusive, amazons_choice_keyword, asin, average_unit_price, best_seller_category_id, best_seller_category_name, best_seller_rank, brand, category_id, category_name, climate_pledge_friendly, name, price, price_value, price_last_scraped_date, prime, rating, revenue, revenue_in_usd, reviews, small_business, thumbnail, units_sold, views Allowed: amazon_brand, amazon_exclusive, amazons_choice_keyword, asin, average_unit_price, best_seller_category_id, best_seller_category_name, best_seller_rank, brand, category_id, category_name, climate_pledge_friendly, name, price, price_value, price_last_scraped_date, prime, rating, revenue, revenue_in_usd, reviews, small_business, thumbnail, units_sold, views.
• mtd (boolean): When true with weekly granularity, end_date is set to the latest available Saturday. NOT supported for monthly granularity.
• category (string, required): Amazon category ID (numeric string, e.g., '679182011'). Category IDs are domain-specific and cannot be used across different Amazon domains. Use the category search endpoint to find valid IDs for your domain
• format (string): Format in which the reply should be returned Allowed: json, xml.
• limit (integer): Sets how many results to return.
• offset (integer): Defines the number of results to skip
• asc (boolean): Orders the results by ascending or descending
• sort (string): Selects a specific metric to order results by

Header: api-key (string) — your API key.

Example request

curl --location 'https://api.similarweb.com/v5/shopper-sales/categories/top-products?domain=YOUR_VALUE&category=YOUR_VALUE' --header 'api-key: YOUR_API_KEY'

Response — 200

Returns a data array, each item with:

• date: Date of the requested data in 'YYYY-MM' or 'YYYY-MM-DD' format
• amazon_brand: Amazon brand name
• amazon_exclusive: Whether the product is Amazon exclusive
• amazons_choice_keyword: Amazon's Choice keyword
• asin: Amazon Standard Identification Number
• average_unit_price: Average unit price
• best_seller_category_id: Best seller category ID
• best_seller_category_name: Best seller category name
• best_seller_rank: Best seller rank
• brand: Product brand name
• category_id: Amazon category ID
• category_name: Category name
• climate_pledge_friendly: Whether the product is Climate Pledge Friendly
• name: Product name
• price: Product price, snapshot taken at price_last_scraped_date (formatted with currency symbol).
• price_value: Product price, snapshot taken at price_last_scraped_date (numeric value without currency symbol).
• price_last_scraped_date: The specific timestamp when the price and price_value fields were captured.
• prime: Whether the product is Prime eligible
• rating: Average product rating (out of 5)
• revenue: Sum of revenue over the requested time period.
• revenue_in_usd: Revenue in USD
• reviews: Total accumulated review count for the product (snapshot).
• small_business: Whether the product is from a small business
• thumbnail: Product thumbnail image URL
• units_sold: Sum of units sold over the requested time period.
• views: Total product page views