Category Top Brands

Returns list of top-performing brands within a category, ranked by selected metrics.

Variants:

• Time-series (this endpoint): GET /v5/shopper-sales/categories/top-brands — data broken down by date for trend analysis.
• Aggregated: GET /v5/shopper-sales/categories/top-brands/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)
• brand: Name of the brand
• total_views: Total product page views for the brand in the category
• total_views_share: Brand's share of total views in the category
• units_sold: Total units sold by the brand in the category
• units_sold_share: Brand's share of total units sold in the category
• revenue: Total revenue generated by the brand (local currency)
• revenue_in_usd: Total revenue generated by the brand (USD)
• revenue_share: Brand's share of total revenue in the category
• conversion: Conversion rate for the brand (units sold per view)

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-brands

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, total_views_share, units_sold, units_sold_share, revenue, revenue_in_usd, revenue_share, conversion Allowed: total_views, total_views_share, units_sold, units_sold_share, revenue, revenue_in_usd, revenue_share, conversion.
• 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-brands?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
• brand: Brand name
• total_views: Total product page views for the brand
• total_views_share: Brand's share of total views in the category, percentage (0-100).
• units_sold: Total units sold for the brand
• units_sold_share: Brand's share of units sold in the category, percentage (0-100).
• revenue: Total revenue for the brand
• revenue_in_usd: Revenue in USD
• revenue_share: Brand's share of revenue in the category, percentage (0-100).
• conversion: Conversion rate (percentage)