Consumer API

Get a consumer's reviews

This method gets the reviews written by the individual consumer.

HTTP method: GET

Authentication: API Key

URL: https://api.trustpilot.com/v1/consumers/{consumerId}/reviews

Parameters

consumerId, Required string

The id of the consumer.

Example: .../v1/consumers/507f191e810c19729de860ea/reviews

stars, Optional array

Filter by reviews with a specific number of stars.

Example: ?stars=5

language, Optional array

Filter by reviews with only a specific language.

Example: ?language=en

internalLocationId, Optional string

Filter by reviews with only a specific location.

Example: ?internalLocationId=f994ac75-2f51-456a-9be9-ec30eadae778

businessUnitId, Optional string

Filter reviews for a specific business unit.

Example: ?businessUnitId=507f191e810c19729de860ea

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.

Example: ?page=1

perPage, Optional integer

The number of reviews to retrieve per page.

Example: ?perPage=3

orderBy, Optional array

The order in which the results should be sorted.

Example: ?orderBy=createdat.asc

includeReportedReviews, Optional boolean

Include reported reviews.

Example: ?includeReportedReviews=true

CURL

curl -X GET "https://api.trustpilot.com/v1/consumers/{consumerId}/reviews" \
  -H "apikey: YOUR-API-KEY-HERE"

Response

{
  "reviews": [
    {
      "status": "active",
      "reportData": {
        "source": "Trustpilot",
        "publicComment": "This review contains sensitive information.",
        "createdAt": "2013-09-07T13:37:00.000Z",
        "reasons": [
          "sensitiveInformation",
          "consumerIsCompetitor"
        ],
        "reason": "consumer_is_competitor",
        "reviewVisibility": "hidden"
      },
      "language": "da",
      "links": [
        {
          "href": "<Url for the resource>",
          "method": "<Http method for the resource>",
          "rel": "<Description of the relation>"
        }
      ],
      "title": "My review",
      "businessUnit": {
        "identifyingName": "trustpilot.com",
        "displayName": "Trustpilot",
        "id": "507f191e810c19729de860ea",
        "links": [
          {
            "href": "<Url for the resource>",
            "method": "<Http method for the resource>",
            "rel": "<Description of the relation>"
          }
        ]
      },
      "location": {
        "id": "43f51215-a1fc-4c60-b6dd-e4afb6d7b831",
        "name": "Pilestraede 58",
        "urlFormattedName": "Pilestraede58"
      },
      "text": "This shop is great.",
      "companyReply": {
        "text": "This is our reply.",
        "createdAt": "2013-09-07T13:37:00.000Z",
        "updatedAt": "2013-09-07T13:37:00.000Z"
      },
      "isVerified": true,
      "stars": 5,
      "experiencedAt": "2013-09-07T13:37:00.000Z",
      "updatedAt": "2013-09-07T13:37:00.000Z",
      "numberOfLikes": 10,
      "consumer": {
        "displayLocation": "Frederiksberg, DK",
        "numberOfReviews": 1,
        "displayName": "John Doe",
        "id": "507f191e810c19729de860ea",
        "links": [
          {
            "href": "<Url for the resource>",
            "method": "<Http method for the resource>",
            "rel": "<Description of the relation>"
          }
        ]
      },
      "id": "507f191e810c19729de860ea",
      "createdAt": "2013-09-07T13:37:00.000Z",
      "countsTowardsTrustScore": false,
      "countsTowardsLocationTrustScore": false,
      "invitation": {
        "businessUnitId": "507f191e810c19729de860ea"
      },
      "businessUnitHistory": [
        {
          "businessUnitId": "507f191e810c19729de860ea",
          "identifyingName": "example.com",
          "displayName": "Example Inc.",
          "changeDate": "2013-09-07T13:37:00.000Z"
        }
      ],
      "reviewVerificationLevel": "invited",
      "complianceLabels": [
        null
      ]
    }
  ],
  "links": [
    {
      "href": "<Url for the resource>",
      "method": "<Http method for the resource>",
      "rel": "<Description of the relation>"
    }
  ]
}