Returns time-series data of competitor brands with the highest audience overlap, ranked by affinity to a given brand within a category.

Request parameters

• asc query · optional

  Orders the results by ascending or descending

• brand query · required

  Brand name. Use brand search or top brands endpoints to discover available brands for your domain. Example: "Nike"

• category query · 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. Example: "679182011"

• domain query · 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. Example: "amazon.com"

• end_date query · optional

  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. Example: "2025-03-01"

• format query · optional

  Format in which the reply should be returned

• granularity query · optional

  Time granularity for the returned values. Example: "Monthly"

• limit query · optional

  Sets how many results to return.

• metrics query · optional

  Comma-separated list of metrics: competitor_brand, affinity, views, units_sold, revenue, revenue_in_usd, competitive_overlap, brand_share_of_competition

• mtd query · optional

  When true with weekly granularity, end_date is set to the latest available Saturday. NOT supported for monthly granularity.

• offset query · optional

  Defines the number of results to skip

• sort query · optional

  Selects a specific metric to order results by

• start_date query · optional

  Start date in 'YYYY-MM' or 'YYYY-MM-DD' format. For weekly granularity, automatically adjusted to the first Sunday of the specified month. Example: "2025-01-01"