Business Units API (public)

Find a business unit

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

Get public business unit

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