Go To Top

Business Units API (public)

Returns the business unit given by the provided name

GET
Authentication: API Key
https://api.trustpilot.com/v1/business-units/find
Parameters
name, Required String

Example: ?name={name}

Response
{
  "status": "active",
  "badFit": true,
  "displayName": "Trustpilot",
  "name": {
    "referring": [
      "trustpilot.com",
      "www.trustpilot.com"
    ],
    "identifying": "trustpilot.com"
  },
  "links": [
    {
      "href": "<Url for the resource>",
      "method": "<Http method for the resource>",
      "rel": "<Description of the relation>"
    }
  ],
  "country": "DK",
  "websiteUrl": "http://www.trustpilot.com",
  "score": {
    "trustScore": 4.6,
    "stars": 4.5
  },
  "numberOfReviews": {
    "threeStars": 2,
    "oneStar": 2,
    "twoStars": 3,
    "fiveStars": 2,
    "total": 14,
    "fourStars": 5,
    "usedForTrustScoreCalculation": 12
  },
  "id": "507f191e810c19729de860ea"
}

Page all business units, including the ones without reviews.

GET
Authentication: API Key
https://api.trustpilot.com/v1/business-units/all
Parameters
country, Optional Array
Filter by specific countries using ISO 3166-1-alpha-2.
Example: ?country={country}
* provide multiple values using comma seperation

perPage, Optional Integer
The number of business units to retrieve per page.
Constraints: The allowed range is minimum: 1, maximum: 1000
Default value: 1000
Example: ?perPage=0

page, Optional Integer
The page to retrieve. If the page number requested is higher than the available number of pages an empty array will be returned.
Constraints: The allowed range is minimum: 1, maximum: 2147483647
Default value: 1
Example: ?page=0

Response
{
  "businessUnits": [
    {
      "displayName": "Trustpilot",
      "id": "507f191e810c19729de860ea",
      "links": [
        {
          "href": "<Url for the resource>",
          "method": "<Http method for the resource>",
          "rel": "<Description of the relation>"
        }
      ],
      "name": {
        "referring": [
          "trustpilot.com",
          "www.trustpilot.com"
        ],
        "identifying": "trustpilot.com"
      }
    }
  ],
  "links": [
    {
      "href": "<Url for the resource>",
      "method": "<Http method for the resource>",
      "rel": "<Description of the relation>"
    }
  ]
}

Get the company's Guarantee Box information for a specific business unit.

GET
Authentication: API Key
https://api.trustpilot.com/v1/business-units/{businessUnitId}/customerguarantee
Parameters
businessUnitId, Required String
The id of the business unit.
Example: …/v1/business-units/{businessUnitId}/customerguarantee

Response
{
  "body": "We will do our best to deliver quality service.",
  "links": [
    {
      "href": "<Url for the resource>",
      "method": "<Http method for the resource>",
      "rel": "<Description of the relation>"
    }
  ],
  "image": {
    "image184x0": {
      "url": "<Url for the image>",
      "width": "<Image width>"
    }
  },
  "header": "Guarantee box",
  "teaser": "This is what we promise",
  "display": true
}

Get the company's Promotion Box information for a specific business unit.

GET
Authentication: API Key
https://api.trustpilot.com/v1/business-units/{businessUnitId}/profilepromotion
Parameters
businessUnitId, Required String
The id of the business unit.
Example: …/v1/business-units/{businessUnitId}/profilepromotion

Response
{
  "contactInfoTitle": "Trustpilot Support Team",
  "description": {
    "header": "About Trustpilot",
    "text": "Trustpilot is a review platform."
  },
  "links": [
    {
      "href": "<Url for the resource>",
      "method": "<Http method for the resource>",
      "rel": "<Description of the relation>"
    }
  ],
  "title": "Trustpilot",
  "image": {
    "url": "<Url for the image>",
    "width": "<Image width>"
  },
  "sellingPoints": [
    {
      "header": "Trustpilot's commitment",
      "text": "Trustpilot is committed to ensuring better online shopping experiences for everyone."
    }
  ]
}

This method gets the business unit's basic public information (name, URL, reviews, etc.).

GET
Authentication: API Key
https://api.trustpilot.com/v1/business-units/{businessUnitId}
Parameters
businessUnitId, Required String

Example: …/v1/business-units/{businessUnitId}

Response
{
  "status": "active",
  "badFit": true,
  "displayName": "Trustpilot",
  "name": {
    "referring": [
      "trustpilot.com",
      "www.trustpilot.com"
    ],
    "identifying": "trustpilot.com"
  },
  "links": [
    {
      "href": "<Url for the resource>",
      "method": "<Http method for the resource>",
      "rel": "<Description of the relation>"
    }
  ],
  "country": "DK",
  "websiteUrl": "http://www.trustpilot.com",
  "score": {
    "trustScore": 4.6,
    "stars": 4.5
  },
  "numberOfReviews": {
    "threeStars": 2,
    "oneStar": 2,
    "twoStars": 3,
    "fiveStars": 2,
    "total": 14,
    "fourStars": 5,
    "usedForTrustScoreCalculation": 12
  },
  "id": "507f191e810c19729de860ea"
}