---
title: "List Shopping Demand"
method: POST
path: "/products/demand"
tags: ["Products"]
---

# List Shopping Demand

`POST /products/demand`

List top shopping queries, web-search fan-out queries, or query terms over a date range.

## Request body

- object
  - `project_id` string — Required if using a company api key
  - `start_date` string, date — full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21
  - `end_date` string, date — full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21
  - `category_ids` string[] — Filter by shopping categories. Parent categories include descendants.
  - `country_codes` string[]
  - `model_channel_ids` string[]
  - `topic_ids` string[]
  - `tag_ids` string[]
  - `tag_operator` 'and' | 'or'
  - `previous_start_date` string, date — Start of an explicit comparison window for deltas. Provide together with previous_end_date, or omit both to auto-derive an equal-length window immediately before [start_date, end_date].
  - `previous_end_date` string, date — End of the explicit comparison window. Provide together with previous_start_date, or omit both to auto-derive.
  - `kind` 'shopping_query' | 'fanout_query' | 'query_term', required — shopping_query = product fan-out queries; fanout_query = web-search fan-out queries; query_term = n-grams across shopping queries.
  - `mode` 'top' | 'trending' | 'losing' | 'new' — top = highest now; trending = gainers; losing = losers; new = appeared this window only.
  - `limit` integer
  - `n` integer — n-gram width for kind=query_term (default 2 = bigrams).

## Response `200`

Success

- object — Success
  - `data` object[], required
    - `kind` 'shopping_query' | 'fanout_query' | 'query_term', required
    - `text` string, required
    - `distinct_chat_count` number, required
    - `distinct_chat_count_previous` number, required
    - `delta` number, nullable, required
  - `total_count` number, required

---

[API](https://skmtc.net/peec/apis/peec-ai-customer-api.md) · [All operations](https://skmtc.net/peec/apis/peec-ai-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/peec/peec-ai-customer-api/revisions/92840a1bffa7/schema)