Skip to content
Trustpilot

Data Solutions API

  • Get business unit details

    Get business unit details including TrustScore and review statistics.

    HTTP method: GET

    Authentication: API Key

    URL: https://api.trustpilot.com/data-solutions/v1/business-units/{businessUnitId}

    Parameters

    • businessUnitId, Required string

      The business unit identifier

      Example: .../v1/business-units/507f191e810c19729de860ea

    curl -X GET "https://api.trustpilot.com/data-solutions/v1/business-units/{businessUnitId}" \
      -H "apikey: YOUR-API-KEY-HERE"

    Response

    {
      "id": "46d6a890000064000500e0c3",
      "name": {
        "display": "Trustpilot",
        "identifying": "www.trustpilot.com",
        "referring": [
          "trustpilot.com",
          "trustpilot.net",
          "www.trustpilot.com"
        ]
      },
      "categories": [
        {
          "categoryId": "review_site",
          "isPrimary": true
        }
      ],
      "isClaimed": true,
      "status": "active",
      "isSubscriber": true,
      "address": {
        "street": "Pilestraede 58, 5th floor",
        "city": "Copenhagen",
        "state": "California",
        "country": "Denmark",
        "countryCode": "DK",
        "postcode": "1112"
      },
      "score": {
        "stars": 4,
        "trustScore": 4.5
      },
      "numberOfReviews": {
        "total": 10,
        "usedForTrustScoreCalculation": 8,
        "oneStar": 1,
        "twoStars": 2,
        "threeStars": 3,
        "fourStars": 2,
        "fiveStars": 2
      },
      "description": {
        "header": "Trustpilot",
        "text": "<div style=\"height: 190px;\">Business text</div>"
      },
      "contactEmail": "https://help.trustpilot.com/s/contact-us",
      "contactPhoneNumber": "70237020",
      "socialMedia": {
        "facebook": "https://www.facebook.com/Trustpilot",
        "linkedin": "https://www.linkedin.com/company/trustpilot",
        "twitter": "https://www.twitter.com/trustpilot",
        "youtube": "https://www.youtube.com/trustpilot",
        "instagram": "https://www.instagram.com/trustpilot"
      },
      "websiteUrl": "https://www.trustpilot.com"
    }

  • Find business units

    Get all business units or search by domain.

    HTTP method: GET

    Authentication: API Key

    URL: https://api.trustpilot.com/data-solutions/v1/business-units

    Parameters

    • domain, Optional string

      Domain you want to search for. For example, trustpilot.com

      Example: ?domain=trustpilot.com

    • perPage, Optional number

      Number of results per page (1-1000)

      Example: ?perPage=20

    • page, Optional number

      Page number for pagination (must be positive)

      Example: ?page=1

    curl -X GET "https://api.trustpilot.com/data-solutions/v1/business-units" \
      -H "apikey: YOUR-API-KEY-HERE"

    Response

    {
      "businessUnits": [
        {
          "id": "507f191e810c19729de860ea",
          "displayName": "Trustpilot",
          "name": {
            "referring": [
              "Trustpilot"
            ],
            "identifying": "Trustpilot"
          }
        }
      ]
    }

  • Get latest reviews for business unit

    Get the latest reviews for a specific business unit.

    HTTP method: GET

    Authentication: API Key

    URL: https://api.trustpilot.com/data-solutions/v1/business-units/{businessUnitId}/reviews/latest

    Parameters

    • limit, Optional number

      Number of latest reviews to return (1-5)

      Example: ?limit=3

    • businessUnitId, Required string

      The business unit identifier

      Example: .../v1/business-units/507f191e810c19729de860ea/reviews/latest

    curl -X GET "https://api.trustpilot.com/data-solutions/v1/business-units/{businessUnitId}/reviews/latest" \
      -H "apikey: YOUR-API-KEY-HERE"

    Response

    {
      "reviews": [
        {
          "id": "64f1b2e4a7c8d9e0f1a2b3c4",
          "stars": 5,
          "title": "Excellent service!",
          "text": "I had a wonderful experience with this company. Highly recommended!",
          "language": "en",
          "isVerified": true,
          "createdAt": "2023-12-15T10:30:00.000Z",
          "consumer": {
            "id": "consumer123",
            "displayName": "John Doe"
          }
        }
      ]
    }

  • Get service reviews

    Get service reviews for a specific business unit.

    HTTP method: GET

    Authentication: API Key

    URL: https://api.trustpilot.com/data-solutions/v1/business-units/{businessUnitId}/reviews

    Parameters

    • startDate, Optional string

      Start date for filtering reviews (ISO 8601 format)

      Example: ?startDate=2023-12-31

    • endDate, Optional string

      End date for filtering reviews (ISO 8601 format)

      Example: ?endDate=2023-12-31

    • nextToken, Optional string

      Token for pagination to get the next set of reviews (base64 encoded JSON)

      Example: ?nextToken=eyJ0b2tlbiI6ICJzYW1wbGVUb2tlbiIsICJwYWdlIjogMSwgInBlclBhZ2UiOiAyfQ==

    • businessUnitId, Required string

      The business unit identifier

      Example: .../v1/business-units/507f191e810c19729de861ea/reviews

    curl -X GET "https://api.trustpilot.com/data-solutions/v1/business-units/{businessUnitId}/reviews" \
      -H "apikey: YOUR-API-KEY-HERE"

    Response

    {
      "reviews": [
        {
          "id": "507f191e810c19729de860ea",
          "stars": 4,
          "title": "Great Service!",
          "text": "I had a wonderful experience.",
          "language": "en",
          "isVerified": true,
          "createdAt": "2023-12-31T12:00:00Z",
          "updatedAt": "2023-12-31T12:00:00Z",
          "experiencedAt": "2023-12-31T12:00:00Z",
          "source": "organic",
          "reviewedLocationName": "Pilestraede 58"
        }
      ],
      "nextToken": "eyJ0b2tlbiI6ICJzYW1wbGVUb2tlbiIsICJwYWdlIjogMSwgInBlclBhZ2UiOiAyfQ=="
    }

  • Get categories

    Get categories with optional filtering by country and parent category.

    HTTP method: GET

    Authentication: API Key

    URL: https://api.trustpilot.com/data-solutions/v1/categories

    Parameters

    • countryCode, Optional string

      Country code for filtering categories (ISO 3166-1 alpha-2)

      Example: ?countryCode=US

    • parentId, Optional string

      Parent category identifier for filtering subcategories

      Example: ?parentId=restaurants_bars

    curl -X GET "https://api.trustpilot.com/data-solutions/v1/categories" \
      -H "apikey: YOUR-API-KEY-HERE"

    Response

    {
      "totalNumberOfCategories": 150,
      "categories": [
        {
          "categoryId": "restaurant",
          "parentId": "restaurants_bars",
          "childrenCategories": [
            "italian_restaurant",
            "pizza_restaurant"
          ],
          "numberOfBusinessUnits": 1234
        }
      ]
    }