ApiShopping
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/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"
}
}