API Reference
List aggregated products with statistics
X-API-Key<token>
API Key for programmatic access
In: header
Path Parameters
domainId*string
Query Parameters
startDate?string
Start date filter (ISO 8601)
endDate?string
End date filter (ISO 8601)
sortBy?string
Sort field
Default
"totalAppearances"Value in
- "frequencyPercentage"
- "lastSeenAt"
- "priceChange"
- "totalAppearances"
sortOrder?string
Sort order
Default
"desc"Value in
- "asc"
- "desc"
merchantFilter?string
Filter by merchant name
limit?number
Number of results to return
Default
20skip?number
Number of results to skip
Default
0Response Body
application/json
curl -X GET "https://example.com/api/domains/string/shopping/products"{ "products": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "title": "Sony WH-1000XM5 Wireless Headphones", "merchant": { "name": "Amazon", "url": "https://amazon.com" }, "latestUrl": "https://amazon.com/dp/...", "latestImage": "https://nike.com/air-max", "statistics": { "totalAppearances": 15, "uniqueQueries": 5, "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 }, "firstSeenAt": "2026-05-25T10:30:00.000Z", "lastSeenAt": "2026-05-25T10:30:00.000Z" } ], "totalCount": 150, "dateRange": { "start": "2026-04-25T00:00:00.000Z", "end": "2026-05-25T10:30:00.000Z" }}