Product Top Keywords

Returns list of top on-site search keywords for a product (ASIN), ranked by selected metrics.

Variants:

• Time-series (this endpoint): GET /v5/shopper-on-site-search/products/top-keywords — data broken down by date for trend analysis.
• Aggregated: GET /v5/shopper-on-site-search/products/top-keywords/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)
• keyword: The search keyword
• associated_brand: The brand most associated with this keyword
• branded_type: Whether the keyword is branded or non-branded
• organic_rank: Organic search rank of the product for this keyword
• relevancy: Relevancy score of the product for this keyword
• share_of_clicks: Product's share of total clicks for this keyword
• keyword_clicks: Total clicks across all products for this keyword
• product_organic_clicks: Organic clicks on this product for this keyword
• product_paid_clicks: Paid clicks on this product for this keyword
• search_volume: Total number of searches for this keyword
• reach: Estimated number of unique users reached by this keyword
• product_clicks: Total clicks on this product for this keyword

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
• Supports pagination (limit, offset, sort, asc)

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