Category Sales Performance

Returns time-series sales performance data for a specific category on Amazon.

Variants:

• Time-series (this endpoint): GET /v5/shopper-sales/categories/sales-performance — data broken down by date for trend analysis.
• Aggregated: GET /v5/shopper-sales/categories/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)
• conversion: Conversion rate (units sold per view) for the category
• num_asins: Number of distinct ASINs in the category
• parent_category_id: Unique identifier of the parent category
• parent_category_name: Display name of the parent category
• parent_category_revenue: Revenue of the parent category (local currency)
• parent_category_revenue_in_usd: Revenue of the parent category (USD)
• parent_category_total_views: Total views in the parent category
• parent_category_units_sold: Total units sold in the parent category
• revenue: Total revenue for the category (local currency)
• total_views: Total product page views in the category
• units_sold: Total units sold in the category
• revenue_in_usd: Total revenue for the category (USD)

Constraints:

• domain and category are required
• granularity supports monthly or weekly

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

Request

Endpoint: GET /v5/shopper-sales/categories/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: conversion, num_asins, parent_category_id, parent_category_name, parent_category_revenue, parent_category_revenue_in_usd, parent_category_total_views, parent_category_units_sold, revenue, total_views, units_sold, revenue_in_usd Allowed: conversion, num_asins, parent_category_id, parent_category_name, parent_category_revenue, parent_category_revenue_in_usd, parent_category_total_views, parent_category_units_sold, revenue, total_views, units_sold, revenue_in_usd.
• 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.

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

Example request

curl --location 'https://api.similarweb.com/v5/shopper-sales/categories/sales-performance?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
• conversion: Conversion rate (percentage)
• num_asins: Number of ASINs in the category
• parent_category_id: Parent category ID
• parent_category_name: Parent category name
• parent_category_revenue: Parent category revenue
• parent_category_revenue_in_usd: Parent category revenue in USD
• parent_category_total_views: Parent category total views
• parent_category_units_sold: Parent category units sold
• revenue: Category revenue
• total_views: Total product page views
• units_sold: Total units sold
• revenue_in_usd: Revenue in USD