/api/v2/shopping/products/topReturn top shopping products.
Return top shopping products.
Requires bearer API key
Parameters
X-Project-Id
header
Required for organization-wide API keys on project-scoped endpoints. Project-scoped keys infer the project automatically.
Schema: string
limit
query
No description provided.
Schema: string
startDate
query
No description provided.
Schema: string:date-time
endDate
query
No description provided.
Schema: string:date-time
range
query
Shortcut for the last 7 or 90 days. Date filters take precedence when present.
Schema: string (7, 90)
q
query
Product-name search. Alias: productSearch.
Schema: string
productSearch
query
Alias for q product-name search.
Schema: string
merchant
query
Single merchant-domain filter used by the workspace UI.
Schema: string
merchantDomains
query
Comma-separated merchant domains are accepted.
Schema: string
response
query
Filter to product cards extracted from one persisted response. Alias: responseId.
Schema: string
responseId
query
Alias for response.
Schema: string
monitorIds
query
Comma-separated values are accepted.
Schema: string
modelIds
query
Comma-separated values are accepted.
Schema: string
Responses
Successful JSON response.
application/json{
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"productName": {
"type": "string"
},
"appearances": {
"type": "integer"
},
"avgPosition": {
"type": "number",
"nullable": true
}
},
"required": [
"productName",
"appearances",
"avgPosition"
]
}
}Try it
Send this request to the local WatchLLM REST handler. Use a key from `/workspace/api`; organization keys can include `X-Project-Id` only when the endpoint documents that header.