Get Shopping Timeseries
Per collection date and engine: distinct product count (unified), results_count (raw product rows), distinct brand count (from offers), merchant count (from offers), and share of shelf. share_of_shelf = results_count / total_results_for_that_day × 100.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Start of the date range (YYYY-MM-DD).
End of the date range (YYYY-MM-DD, inclusive).
Restrict results to products whose catalogue brand matches one of these brand names.
Restrict results to products linked to one of these product catalogue IDs.
Restrict results to products offered by one of these merchant brand names.
Bing, BingAIO, ChatGPT, Perplexity, Google, GoogleAIO, GoogleAIMode, Claude, Gemini, AmazonRufus Filter by a list of thematic IDs
Filter by a list of keyword types
Generic, Brand Filter by a list of Funnel Stages
ToFu, MoFu, BoFu Filter by a list of persona IDs
Filter by a list of topic IDs
Filter by to get results related to neutral prompts, without weakness or strength
Filter by a list of strength IDs
Filter by a list of weakness IDs
Response
Successful Response
Collection date in YYYY-MM-DD format.
Search engine source.
Number of distinct unified products.
Total product rows across all tracked keywords and sources.
Number of distinct brands from merchant offers.
Number of distinct merchants from offers.
Share of total shopping result rows for this day, expressed as a percentage. Computed as (results_count / day_total_results) × 100.