Go To Top

Introduction

Welcome to the documentation for Trustpilot Public and Customer APIs. Here you will find all required details on our APIs, including technical concepts and formats, authentication methods, error codes and FAQs. The Public API provides you access to content available to the public on trustpilot.com. The Customer API provides access to features of our Business product available to merchants using Trustpilot. We use the exact same APIs for building our public website and business product, meaning that the APIs are highly available and that we are committed to their continued improvement and evolution.
Trustpilot uses the business unit concept as the collection point for all Trustpilot content for a website. The business unit hosts a company's rating, its reviews, and the company responses. A business unit has a unique ID, and is used throughout the APIs. A business unit refers to one main domain name (primary name), and it can be associated with other domain names or sub-domains (referral names).

Trustpilot uses the business unit concept as the collection point for all Trustpilot content for a website; it hosts a company's rating, its reviews, and the company responses.

A business user can access one or many business units.

For almost any integration, the first step is getting your Business Unit ID. The Business Unit ID is a unique key to your domain. If you collect reviews under multiple domains, each one will have its own Business Unit ID. To find your Business Unit ID(s) please use the Find Business Unit API.
The Public API does not require authentication, as you simply need to pass your API key for each request. This key must be added to all calls:
  • either as a query parameter, i.e.: ?apikey={key}
  • or an HTTP header, i.e.: apikey:{key}
The Customer API uses OAuth v2 with refresh. See the Authentication page for full details.
All API requests must be made over HTTPS. Empty values are included as null rather than omitted. All date/time responses are returned using ISO 8601 format using UTC.
The API currently supports JSON as request and response format, and Cross-Origin Resource Sharing policy is enabled for Get requests. As an alternative solution to same origin policy limitations, requests can be made to return JSONP, by adding a query parameter called callback with the name of the JavaScript function to wrap the data, e.g.: ?callback=execute
Some results are cached on our API servers. Cached results will also include HTTP header information about client cacheability.