API Reference
Get products aggregated by query group
X-API-Key<token>
API Key for programmatic access
In: header
Path Parameters
domainId*string
groupId*string
Query Parameters
queryIds?array<string>
Filter by specific query IDs within the group (comma-separated)
sortBy?string
Sort field
Default
"frequency"Value in
- "frequency"
- "lastSeen"
- "avgPosition"
sortOrder?string
Sort order
Default
"desc"Value in
- "asc"
- "desc"
limit?number
Number of products to return
Default
20skip?number
Number of products to skip
Default
0Response Body
application/json
curl -X GET "https://example.com/api/domains/string/shopping/products/groups/string"{ "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "groupName": "Running Shoes", "products": [ { "product": { "id": "sony-wh-1000xm5", "title": "Sony WH-1000XM5 Wireless Headphones", "merchant": { "name": "Amazon", "url": "https://amazon.com" }, "url": "https://amazon.com/dp/B09XS7JWHH", "image": "https://nike.com/air-max", "price": { "current": 109.99, "currency": "USD" } }, "stats": { "totalAppearances": 15, "uniqueResults": 15, "frequencyPercentage": 75.5, "totalExecutions": 20, "averagePosition": 3.2, "priceMin": 99.99, "priceMax": 129.99, "priceAverage": 114.99, "priceCurrent": 109.99, "priceCurrency": "USD", "priceChange7d": -5.5, "priceChange30d": 2.3, "trend": "down" }, "key": "sony-wh-1000xm5", "lastSeenAt": "2026-05-25T10:30:00.000Z", "queryIds": [ "3fa85f64-5717-4562-b3fc-2c963f66afa6", "7c9e6679-7425-40de-944b-e07fc1f90ae7" ] } ], "totalProducts": 50, "validExecutions": 25}