Go To Top

Business Units Legacy API

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
The name of the business unit to match.
Example: ?name={name}

Response
{
  "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"
  }
}

This method gets links to the business unit's public profile page on Trustpilot.

GET
Authentication: API Key
https://api.trustpilot.com/v1/business-units/{businessUnitId}/web-links
Parameters
locale, Required String
The locale to use when generating web links.
Example: ?locale={locale}

businessUnitId, Required String
The id of the business unit.
Example: …/v1/business-units/{businessUnitId}/web-links

Response
{
  "locale": "da-DK",
  "profileUrl": "http://www.trustpilot.dk/review/www.trustpilot.com",
  "evaluateEmbedUrl": "http://www.trustpilot.dk/evaluate/embed/www.trustpilot.com",
  "links": [
    {
      "href": "<Url for the resource>",
      "method": "<Http method for the resource>",
      "rel": "<Description of the relation>"
    }
  ],
  "evaluateUrl": "http://www.trustpilot.dk/evaluate/www.trustpilot.com"
}

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>"
    }
  ]
}

This method gets a list of all the business units with minimum one review.

GET
Authentication: API Key
https://api.trustpilot.com/v1/business-units
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>"
    }
  ]
}

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",
  "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
  },
  "warning": null,
  "id": "507f191e810c19729de860ea"
}