Trustpilot Reviews API reference

Live scrape of Trustpilot’s public pages. Company profiles include trust score, rating distribution, claim status, and one review page. Search and category listings find businesses. A review id returns one review and any company reply. It does not log in, post reviews, or call Trustpilot’s private API. See the Trustpilot Reviews API: overview, pricing, and free tier and review intelligence use case.

Company reviews

GET /v1/trustpilot/reviews · 1 request

curl -G https://api.clair.im/v1/trustpilot/reviews \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "domain=stripe.com" \
  --data-urlencode "page=1"

Parameter	Required	Contract
`domain`	yes	Public hostname, with or without `https://`. IPs and localhost are rejected.
`stars`	no	`5`, `1,2`, or repeated `stars=1&stars=2`.
`language`	no	ISO 639-1/3, or `all`. `.com` defaults to English.
`sort`	no	`recency` (Trustpilot default) or `relevance`.
`date`	no	`last30days`, `last3months`, `last6months`, `last12months`.
`verified`	no	`true` to keep verified reviews.
`replies`	no	`true` to keep reviews with a company reply.
`query`	no	Keyword Trustpilot already exposes as `search=`.
`topic`	no	Topic id such as `customer_service`.
`page`	no	1-based listing. Default 1, max 10. Do not send `limit`.

Anonymous review lists redirect to login after page 10. Use pagination.next_page (next_cursor stays null). Each page is a new billed request. The payload keeps company, rating, stars, review_count, and results[], and adds business (trust score, distribution, claim, contact, reply behaviour), filters, pagination, languages, and similar_businesses.

Company search

GET /v1/trustpilot/search · 1 request query is required. Optional: claimed, min_trust_score (3.0, 4.0, 4.5), min_reviews (100, 250, 500), page (max 100).

Category listing

GET /v1/trustpilot/categories · 1 request category is required (for example bank). Optional: country (ISO-2, UK becomes GB), sort (recommended, latest_review, reviews_count), claimed, min_trust_score, page (max 500).

One review

GET /v1/trustpilot/review · 1 request id is the 24-character hex id from results[].id or the public review URL.

Errors

An unlisted domain, category, or review returns 404 not_found. A review page past 10 returns 400 page_limit. A WAF wall returns 502 scrape_failed. Sending limit or cursor is 400.

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 review lists with limit / cursor.
It does not read locale subdomains such as uk.trustpilot.com.

Keep author names and Trustpilot URLs where you display a review. Auth, plans, rate limits, and error codes: Authentication.

​Company reviews

​Company search

​Category listing

​One review

​Errors

​What this API does not do