Private Products API
Insert or update (if they already exist) a batch of products
POST
Authentication: Business user OAuth Token
https://api.trustpilot.com/v1/private/business-units/{businessUnitId}/products
Parameters
businessUnitId,
Required
String
The BusinessUnitId that owns the products.
Example: …/v1/private/business-units/{businessUnitId}/products
The BusinessUnitId that owns the products.
Example: …/v1/private/business-units/{businessUnitId}/products
Request
{ "products": [ { "sku": "Prod123", "productCategoryGoogleId": "1267", "description": "A very soft shoe built for walking long distances.", "title": "Toy car", "mpn": "HSC0424PP", "price": "99.95 EUR", "googleMerchantCenterProductId": "Product_DK_1007653571_2874605123", "currency": "USD", "imageLink": "http://myshop.com/products/images/toy-car.jpg", "link": "http://myshop.com/products/toy-car", "gtin": "3200000003774", "brand": "ToyProducer" } ], "skuSameAsGoogleMerchantCenterProductId": true }
Response
{ "products": [ { "sku": "Prod123", "title": "Toy car", "mpn": "HSC0424PP", "price": "99.95 EUR", "brand": "ToyProducer", "googleMerchantCenterProductId": "Product_DK_1007653571_2874605123", "processedImages": [ { "url": "https://product-reviews-images.trustpilot.com/5837640412df3f0aabf9989a_100pxWide.png", "type": "100pxWide" } ], "imageLink": "http://myshop.com/products/images/toy-car.jpg", "link": "http://myshop.com/products/toy-car", "gtin": "3200000003774", "id": "507f191e810c19729de860ea" } ] }
Get products
GET
Authentication: Business user OAuth Token
https://api.trustpilot.com/v1/private/business-units/{businessUnitId}/products
Parameters
locale,
Optional
String
The language in which the attributes attached to the products, if any, are returned
Example: ?locale={locale}
The language in which the attributes attached to the products, if any, are returned
Example: ?locale={locale}
perPage,
Optional
Integer
The number of products to retrieve per page.
Default value: 10000
Example: ?perPage=0
The number of products to retrieve per page.
Default value: 10000
Example: ?perPage=0
businessUnitId,
Required
String
The BusinessUnitId that owns the products.
Example: …/v1/private/business-units/{businessUnitId}/products
The BusinessUnitId that owns the products.
Example: …/v1/private/business-units/{businessUnitId}/products
skus,
Optional
Array
Optional sku filter for products.
Example: ?skus={skus}
* provide multiple values using comma seperation
Optional sku filter for products.
Example: ?skus={skus}
* provide multiple values using comma seperation
page,
Optional
Integer
The page to retrieve.
Default value: 1
Example: ?page=0
The page to retrieve.
Default value: 1
Example: ?page=0
Response
{ "isLastPage": false, "products": [ { "sku": "Prod123", "description": "A metal toy car", "title": "Toy car", "mpn": "HSC0424PP", "price": "99.95", "brand": "ToyProducer", "googleMerchantCenterProductId": "Product_DK_1007653571_2874605123", "productCategory": { "id": "507f191e810c19729de860ea", "name": "Clothing" }, "processedImages": [ { "url": "https://product-reviews-images.trustpilot.com/5837640412df3f0aabf9989a_100pxWide.png", "type": "100pxWide" } ], "currency": "EUR", "imageLink": "http://myshop.com/products/images/toy-car.jpg", "link": "http://myshop.com/products/toy-car", "attributes": [ { "id": "attributes-default-comfort", "name": "Comfort" } ], "gtin": "3200000003774", "id": "507f191e810c19729de860ea" } ] }