Reviews API (Customisable Integration)

Modified on: Mon, Jan 15, 2018

Reviews API provides a fully flexible method for integrating Feefo reviews into a merchant's website and is known as a Customisable Integration. This method involves the merchant's server retrieving feedback data from Feefo's servers using JavaScript Object Notation (JSON), processing the returned data and customising it where needed ready for displaying within specific pages of the merchant's website. This process is known as ‘transformation’.

Feedback data is downloaded from the Feefo servers using a secure URL in the form of:

version is the version of the API associated with the URL. The current version number for Reviews API can be found in API Versions. Unless otherwise noted in the parameter/value descriptions, all parameters and values documented are supported in this version.

merchant_identifier = the merchant’s unique Feefo identifier, which in this example is example-retail-merchant. To find your merchant identifier, see Where to find my merchant identifier.

p1=v1, p2=v2 and p3=v3 are parameter/value pairs used to configure the content of the returned JSON data.

The choice of parameters and values depends on the type of API endpoint required. Feefo offers two possible Review API endpoints:

A summary of the review information, for example, the total counts and average scores. A full list of possible parameters and values can be found at Reviews API Request Parameters (Summary). The Reviews API URL for a summary is:

https://api.feefo.com/api/version/reviews/summary/

A detailed listing of reviews, for example, individual ratings and the comments left by customers. A full list of possible parameters and values can be found at Reviews API Request Parameters (Reviews).The Reviews API URL for a detailed listing is:

Once the API has returned the correct data to your servers, your developers can create suitable code to present the results exactly as you would like them. This offers you the opportunity to integrate Feefo reviews onto your web pages using the same look and feel as the rest of your website, creating engaging content to keep prospective customers on your site.