Category Performance

Returns time-series on-site search performance metrics for a category over the selected time period.

Variants:

• Time-series (this endpoint): GET /v5/shopper-on-site-search/categories/performance — data broken down by date for trend analysis.
• Aggregated: GET /v5/shopper-on-site-search/categories/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)
• category_id: Unique identifier of the category
• category_paid_clicks: Total paid clicks in the category
• category_organic_clicks: Total organic clicks in the category
• brand_organic_clicks: Organic clicks attributed to a specific brand in the category
• brand_paid_clicks: Paid clicks attributed to a specific brand in the category
• total_clicks: Total clicks (paid + organic) in the category
• search_volume: Total number of on-site search queries in the category

Constraints:

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

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