GetMint API DocApiShopping
Get product rankings by frequency
X-API-Key<token>
API Key for programmatic access
In: header
Path Parameters
domainId*string
Query Parameters
limit?number
Number of rankings to return
Default
20startDate?string
Start date filter (ISO 8601)
endDate?string
End date filter (ISO 8601)
groupId?string
Filter by query group ID
Format
uuidmarket?string
Filter by market country code (e.g., US, FR)
Response Body
application/json
curl -X GET "https://example.com/domains/string/shopping/products/rankings"{
"rankings": [
{
"rank": 1,
"productId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"normalizedKey": "sony-wh-1000xm5",
"title": "Sony WH-1000XM5 Wireless Headphones",
"merchant": "Amazon",
"frequencyPercentage": 85.5,
"totalAppearances": 25,
"averagePosition": 2.5,
"priceRange": {
"min": 99.99,
"max": 129.99,
"currency": "USD"
},
"trend": "down",
"latestImage": "https://nike.com/air-max"
}
],
"totalProducts": 150,
"dateRange": {
"start": "2026-04-25T00:00:00.000Z",
"end": "2026-05-25T10:30:00.000Z"
}
}