API Documentation
Feedback
Page
Analytics
Product list
Use cases
Here some of the most popular use-cases for retrieving a product list.
To obtain all the product list details associated with a specific SKU, you can use the following endpoint:
The response will include the list of products associated with the specified SKU, along with the product details such as the brand name, image, product division, product category, product type, skus, eans, upcs, asins, product codes, channels, and countries.
{
"total": 123,
"products": [
{
"id": "678e315287a2fa968e84874b",
"name": "One Blade",
"brandName": "Philips",
"image": "https://sample.image.com",
"productDivision": "Male Grooming",
"productCategory": "Shavers",
"productType": "Man Shavers",
"skus": [
"QP2532/20",
"QP2520/30",
"QP2630/30"
],
"eans": [
"871010376114",
"871010389637",
"871010376118"
],
"upcs": [
"075020054128",
"688201434390",
"756336904252"
],
"asins": [
"B07NGTRRPN",
"B06XT3B4QC",
"B078VC1R83"
],
"productCodes": [
"QP2532/20",
"QP2520/30",
"QP2630/30"
],
"channels": [
"amazon.com",
"amazon.fr",
"amazon.ca",
"amazon.co.uk",
"walmart.com"
],
"countries": [
"United States",
"France",
"United Kindom",
"Canada"
]
}, ...
],
"pagination": {
"page": 1,
"limit": 100
}
}
More detailed info and playground in the /products endpoint documentation.
Let’s suppose you are interested in a specific product, like the Philips OneBlade Handles ME that you have on your Wonderboard catalog.
To obtain all the product list details associated with a specific product, you can use the following endpoint:
The response will include the all product details such as the brand name, image, product division, product category, product type, skus, eans, upcs, asins, product codes, channels, and countries.
{
"total": 1,
"products": [
{
"id": "678e315287a2fa968e84874b",
"name": "One Blade",
"brandName": "Philips",
"image": "https://sample.image.com",
"productDivision": "Male Grooming",
"productCategory": "Shavers",
"productType": "Man Shavers",
"skus": [
"QP2532/20",
"QP2520/30",
"QP2630/30"
],
"eans": [
"871010376114",
"871010389637",
"871010376118"
],
"upcs": [
"075020054128",
"688201434390",
"756336904252"
],
"asins": [
"B07NGTRRPN",
"B06XT3B4QC",
"B078VC1R83"
],
"productCodes": [
"QP2532/20",
"QP2520/30",
"QP2630/30"
],
"channels": [
"amazon.com",
"amazon.fr",
"amazon.ca",
"amazon.co.uk",
"walmart.com"
],
"countries": [
"United States",
"France",
"United Kindom",
"Canada"
]
}
],
"pagination": {
"page": 1,
"limit": 100
}
}
More detailed info and playground in the /products endpoint documentation.
To obtain all the feedback associated with a specific Brand, users can follow a two-step process involving querying specific API endpoints.
Query the Brands Endpoint
Begin by querying the Brands endpoint to retrieve a list of available Brands.
More detailed info and playground in the /brands endpoint documentation.
Query the Products Endpoint with the Brand identifier
Once you have obtained the identifiers from the Brands endpoint, use the result to query the Products endpoint.
The response will include the all product details such as the brand name, image, product division, product category, product type, skus, eans, upcs, asins, product codes, channels, and countries.
{
"total": 1,
"products": [
{
"id": "678e315287a2fa968e84874b",
"name": "One Blade",
"brandName": "Philips",
"image": "https://sample.image.com",
"productDivision": "Male Grooming",
"productCategory": "Shavers",
"productType": "Man Shavers",
"skus": [
"QP2532/20",
"QP2520/30",
"QP2630/30"
],
"eans": [
"871010376114",
"871010389637",
"871010376118"
],
"upcs": [
"075020054128",
"688201434390",
"756336904252"
],
"asins": [
"B07NGTRRPN",
"B06XT3B4QC",
"B078VC1R83"
],
"productCodes": [
"QP2532/20",
"QP2520/30",
"QP2630/30"
],
"channels": [
"amazon.com",
"amazon.fr",
"amazon.ca",
"amazon.co.uk",
"walmart.com"
],
"countries": [
"United States",
"France",
"United Kindom",
"Canada"
]
}
],
"pagination": {
"page": 1,
"limit": 100
}
}
More detailed info and playground in the /products endpoint documentation.
Filters
The Products endpoint supports a large variety of filter options to help you narrow down the results to the products you are interested in.
brand: the brand of the productname: the name of the productsku: the SKU of the productean: the EAN of the productupc: the UPC of the productasin: the ASIN of the productproductCode: the generic unique and universal product identifier