Product Sales Performance

Returns time-series sales performance data for a specific product (ASIN) on Amazon.

Variants:

• Time-series (this endpoint): GET /v5/shopper-sales/products/sales-performance — data broken down by date for trend analysis.
• Aggregated: GET /v5/shopper-sales/products/sales-performance/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
• total_views: Total product page views
• units_sold: Number of units sold
• revenue: Revenue generated (local currency)
• price: Product price
• rating: Product rating score
• reviews: Number of customer reviews
• related_asins: List of related ASINs (variants or complementary products)
• brand: Brand name of the product
• category_name: Category name the product belongs to
• revenue_in_usd: Revenue generated (USD)

Constraints:

• domain and asin are required
• ASIN must be exactly 10 uppercase alphanumeric characters (e.g., B0DLFVP6YM)
• ASINs are domain-specific and cannot be used across different Amazon domains
• granularity supports monthly or weekly

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

Request

Endpoint: GET /v5/shopper-sales/products/sales-performance

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: total_views, units_sold, revenue, price, rating, reviews, related_asins, brand, category_name, revenue_in_usd Allowed: total_views, units_sold, revenue, price, rating, reviews, related_asins, brand, category_name, revenue_in_usd.
• mtd (boolean): When true with weekly granularity, end_date is set to the latest available Saturday. NOT supported for monthly granularity.
• asin (string, required): Amazon Standard Identification Number. Must be exactly 10 characters (uppercase alphanumeric only). Format: 10 uppercase letters and/or numbers (e.g., 'B0DLFVP6YM'). ASINs are Amazon-specific and cannot be used across different Amazon domains
• format (string): Format in which the reply should be returned Allowed: json, xml.

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

Example request

curl --location 'https://api.similarweb.com/v5/shopper-sales/products/sales-performance?domain=YOUR_VALUE&asin=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
• asin: Amazon Standard Identification Number
• total_views: Total product page views
• units_sold: Total units sold
• revenue: Total revenue
• price: Product price
• rating: Average product rating (out of 5)
• reviews: Number of product reviews
• related_asins: Array of related ASINs
• brand: Product brand name
• category_name: Category name
• revenue_in_usd: Revenue in USD