> ## Documentation Index
> Fetch the complete documentation index at: https://clair.im/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Trustpilot Reviews API

> Trustpilot Reviews API: live scrape of a company's public Trustpilot profile. Company name, aggregate rating, and one review page per call. Pass page for the next listing.

Live scrape of a company's **public Trustpilot profile**. Returns the displayed
company name, aggregate rating, and the current page of public reviews.

It does not log in, post reviews, or call Trustpilot's private API.

See the [product page](https://clair.im/dashboard/apis/trustpilot) and
[review intelligence use case](https://clair.im/resources/use-cases/review-intelligence).

## Endpoint

`GET /v1/reviews` · **8 credits**

```sh theme={null}
curl -G https://api.clair.im/v1/reviews \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "domain=stripe.com" \
  --data-urlencode "page=1"
```

## Parameters

| Parameter | Required | Contract                                                                     |
| --------- | -------- | ---------------------------------------------------------------------------- |
| `domain`  | yes      | Public hostname, with or without `https://`. IPs and localhost are rejected. |
| `stars`   | no       | Keep reviews with this star rating, 1 through 5.                             |
| `page`    | no       | 1-based Trustpilot listing page. Default 1, max 20. Do not send `limit`.     |

`page` maps to Trustpilot's public `?page=` listing. Each page is a new
8-credit request. Sending `limit` is `400`.

## Response

```json theme={null}
{
  "domain": "stripe.com",
  "url": "https://www.trustpilot.com/review/stripe.com",
  "company": "Stripe",
  "rating": 4.2,
  "stars": 4,
  "review_count": 2145,
  "count": 1,
  "results": [
    {
      "id": "64f1aaaaaaaaaaaaaaaaaaaa",
      "title": "Fast payouts",
      "body": "Stripe settled our payouts the next business day.",
      "rating": 5,
      "author": "Ada L",
      "country": "US",
      "published_at": "2026-08-01T12:00:00.000Z",
      "date_of_experience": "2026-07-28T00:00:00.000Z",
      "url": "https://www.trustpilot.com/reviews/64f1aaaaaaaaaaaaaaaaaaaa"
    }
  ],
  "next_cursor": null
}
```

An unlisted domain returns `404` `not_found`. A WAF wall returns `502`
`scrape_failed`.

## What this API does not do

* It does not export Trustpilot's private review corpus.
* It does not score companies or recommend vendors.
* It does not paginate with `limit` / `cursor`.

Keep author names and Trustpilot URLs where you display a review.

Auth, credits, and error codes: [Authentication](/docs/authentication).