scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTReviews

Trustpilot Reviews

1 credit

Get reviews for a business from Trustpilot.

POST/api/v1/tools/trustpilot/reviews

Parameters

businessstringrequired

Business domain or Trustpilot URL. Accepts a plain domain like "example.com" or a full URL like "https://www.trustpilot.com/review/example.com".

maxReviewsnumber

Maximum number of reviews to return. Must be a positive integer. Defaults to 20. Upper bound is determined by your plan.

sortstring

Sort order for reviews. One of "createdAt:desc" (newest first) or "relevancy:desc" (most relevant first). Defaults to "createdAt:desc". Relevancy sort has a server-enforced limit of roughly 200 reviews.

starsstring[]

Filter by star rating. Array of values from "1" through "5". Defaults to [] (all ratings).

languagestring

Filter reviews by language code. Defaults to "all" (no language filter).

datestring

Date range filter. One of "all", "last30days", "last3months", "last6months", "last12months". Defaults to "all".

searchstring

Keyword search within review text. Omit or leave empty to skip keyword filtering.

onlyVerifiedboolean

Only return verified reviews. Defaults to false.

onlyWithRepliesboolean

Only return reviews that have a business reply. Defaults to false.

includeBusinessProfileboolean

Include the full business profile object in the response. Defaults to false.

fieldsstring[]

Fields to include per review. Omit for defaults: title, text, stars, createdAt, consumer, reply, isVerified, numberOfLikes. Use ["*"] for all fields. Available fields: title, text, stars, createdAt, updatedAt, id, language, isVerified, numberOfLikes, consumer, reply, nlpData, source, experiencedAt, verificationLabel, isLikedByCurrentConsumer, status, businessUnitId, reviewVerificationLevel, isLatestByConsumerOnBusinessUnit, isLatestByConsumerOnLocation, consumersReviewCountOnSameDomain, consumersReviewCountOnSameLocation, filtered.

Response Schema

dataobject

Trustpilot reviews result

businessobject

Business information

reviewsobject[]

Array of review objects. Fields depend on the fields parameter. Default fields: title, text, stars, createdAt, consumer, reply, isVerified, numberOfLikes.

countnumber

Number of reviews returned

truncatedboolean

True if results were cut short due to a timeout or server limit. Only present when truncation occurred.

metaobject

Request metadata

toolstring

Tool name (trustpilot-reviews)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/trustpilot/reviews \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "business": "https://www.trustpilot.com/review/example.com",
    "maxReviews": 10,
    "stars": ["4", "5"],
    "sort": "createdAt:desc"
  }'

Response Example

{
  "data": {
    "business": {
      "id": "46a7e93b00006400050544ef",
      "displayName": "Example Corp"
    },
    "reviews": [
      {
        "title": "Great customer service",
        "text": "Had an issue with my order and the support team resolved it within hours. Very impressed with the follow-up.",
        "stars": 5,
        "createdAt": "2026-04-08T14:22:00.000Z",
        "consumer": {
          "displayName": "John D.",
          "countryCode": "US"
        },
        "reply": {
          "text": "Thank you for your kind words, John! We are glad we could help.",
          "createdAt": "2026-04-09T09:15:00.000Z"
        },
        "isVerified": true,
        "numberOfLikes": 3
      },
      {
        "title": "Solid product, fast shipping",
        "text": "Ordered on Monday, arrived Wednesday. Product quality matches the description.",
        "stars": 4,
        "createdAt": "2026-04-05T08:10:00.000Z",
        "consumer": {
          "displayName": "Sarah M.",
          "countryCode": "GB"
        },
        "reply": null,
        "isVerified": true,
        "numberOfLikes": 1
      }
    ],
    "count": 2
  },
  "meta": {
    "tool": "trustpilot-reviews",
    "creditsUsed": 1,
    "requestId": "req_abc123"
  }
}