01 / THE USE CASE
Watch public reputation without a scraper farm
Support, competitive research, and vendor diligence often need the rating and review text a company already shows on Trustpilot. The Trustpilot Reviews API returns company, aggregate rating, review_count, and results[] from the public profile.
Treat the payload as source material, not a verdict. Star ratings are not Clair's opinion of the business.
02 / HOW TO CALL IT
Domain in, profile out
Call GET /v1/reviews?domain=example.com. Optional page selects the Trustpilot listing page (default 1). Optional stars keeps a single rating band Trustpilot already exposes. Do not send limit. See the Trustpilot Reviews API for the full contract.
Each call costs 8 credits.
03 / BOUNDARIES
Public listing, not a private export
Do not republish the review corpus as a competing reviews product. Keep author names and Trustpilot URLs where you display a review. For contacts published on the company's own site, use website contact enrichment.
04 / FAQ
Questions from research teams
Is this Trustpilot's official API?
No. Clair reads the public profile page. It does not log in, post reviews, or call Trustpilot's private API.
Can I page through every historical review?
Pass page for the next Trustpilot listing (default 1). Each page is a new request. Optional stars=1..5 filters that page. Do not send limit.
Are star ratings a recommendation?
No. They are the values Trustpilot displayed. Clair does not score companies or advise customers.