Hello! How can we help?

Browse the Trustpilot Support Center to find info on Google Seller Ratings, Rich Snippets, TrustBoxes, Product reviews, plus how-to guides for editing your reviews and account settings

Trustpilot APIs - Service Review Integration Guidelines

Version 2.4, March 3rd 2017
Trustpilot’s integration guidelines apply to everyone who is permitted to use our APIs.

Do you want to build an integration using Trustpilot data? This article will walk you through our integration guidelines, so you know how to implement content and display the Trustpilot logo and images correctly. Please be aware that Trustpilot reserves the right to revoke your API access if you violate our guidelines.

If you want a quick and simple solution, we recommend implementing one or more of our TrustBoxes. They’re easy to implement, and you’ll always be in line with our guidelines.

Content requirements

Follow Trustpilot’s content requirements when using our APIs, e.g. to display service reviews in a customized widget.

Always do this:

  • Pull review content directly from our APIs, so the content is always up-to-date
  • Display your accurate overall score either as a star rating (star image), TrustScore (number) or star label (text)
  • Display your total number of reviews
  • Unless displaying all reviews, indicate that you’re only showing a selection
  • Link back to Trustpilot so that customers can read your reviews in full

Don’t do this:

  • Edit the content of a review, including TrustScore, text, author, date, etc.
  • Publicly display sensitive information, e.g. customer emails, reference numbers
  • Display information in a libelous or defamatory, obscene, malicious, or discriminatory manner
  • Index the reviews to get Rich Snippets or display them as your own content
  • Share your API key with 3rd parties who are not a part of your API development
Note: you don’t have to show your category ranking, but if you do, make sure it’s accurate.

These are the words we use at Trustpilot:

Here’s an example of how to display your overall TrustScore correctly:

SEO requirements

Follow Trustpilot’s SEO requirements to avoid duplicate content penalties and damage to your search engine rankings.

You can do this:

  • Dynamically load the data with JavaScript from a site where the robots.txt prevents search engines from crawling the JavaScript (e.g. dynamically load client-side through the Trustpilot APIs - developers.trustpilot.com.)
  • Use an Iframe where the framed page isn’t crawlable by search engines. For example, you can “no-index” the framed page or remote load the framed page from a website where robots.txt prevent search engines from crawling it.

Don’t do this:

  • Include Trustpilot reviews directly in your source code

Do at your own risk:

  • It’s possible to mark up your TrustScore with Rich Snippets using Aggregate Rating, however it is important to ensure you are fully compliant with Google’s structured data guidelines, as any breach of these policies could result in losing all your Rich Snippets. Trustpilot recommends using one of our TrustBox widgets which are optimized for SEO.

Branding requirements

Following Trustpilot’s branding requirements establishes credibility in your reviews, by demonstrating that they originated from a trusted and independent third party source.

Always do this:

  • Include at least one Trustpilot logo on every page displaying reviews or ratings
  • Place the logo close to the overall TrustScore or reviews

Don’t do this:

  • Display the review content as your own without mentioning Trustpilot

For more details on how to display the Trustpilot logo and star images, visit our Brand Style Guide.

Here’s an example of how to display the Trustpilot logo correctly:

Here's an example of how partners can give credit to Trustpilot when displaying reviews:

API documentation

Now that you’ve read our guidelines, you’re ready to build your API integration with Trustpilot. Our API documentation has everything your developer needs to know.



Please sign in to leave a comment.