Go To Top

Private Products API

Batch upsert products
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
Request
{
  "products": [
    {
      "sku": "Prod123",
      "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 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}
perPage, Optional Integer
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
skus, Optional Array
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
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"
    }
  ]
}