Reviews API

Our Reviews API gives you the flexibility and freedom to integrate your Feefo reviews seamlessly with your website, providing you with a fully customisable integration option that lets you display your Feefo feedback however you like, so you can match it to the look and feel of your brand. 

Using Feefo’s Reviews API requires your server to retrieve feedback data from our servers using JavaScript Object Notation (JSON), process that data and then have your trusty team of developers customise it where needed, ready for displaying across your site.

Here’s how to do it. 

How is feedback data downloaded via the API?

You can download your feedback data from our Feefo servers using a secure URL, but the information that the API sends back will depend on what you include. 

Here’s an example:

https://api.feefo.com/api/version/reviews/summary/all?merchant_identifier=example-retail-merchant&p1=v1&p2=v2&p3=v3 ...

You’ll need to manually change certain sections of the URL in order to get the data you need. Here’s what you can select:

Version - You can select which version of our API you want the URL to use by selecting either our ‘Reviews’, ‘Reviews Summary’ or ‘Product Rating’ APIs.  For a full list of current “versions” of our API, click here

There’ll be plenty more on what each of these mean later on. 

merchant_identifier= This is where you’ll need to put your unique merchant identifier given to you when you first set up your account, which in this example is ‘example-retail-merchant’.

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

 What API endpoints do Feefo offer?

Your choice of parameters and values depends on what data you want the API to display. Feefo offers three API endpoints to choose from:
    1. A summary of the review information

The URL you’ll need to use for our Reviews API ‘reviews summary’ is:

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

You might choose this option if, for example, you wanted to display the total number of reviews and average scores. 

You can find a full list of possible parameters and values for this endpoint, here.
    2. A detailed listing of reviews

The URL you’ll need to use for our Reviews API ‘reviews’ is:

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

You might choose this option if, for example, you wanted to display individual ratings and comments left by your customers.

You can find a full list of possible parameters and values for this endpoint, here.
    3. Product Ratings

The URL you’ll need to use for our Product Ratings API is:

https://api.feefo.com/api/version/products/ratings?

You might choose this option if, for example, you wanted to display certain product ratings using specific SKUs.

How is API review data returned?

A successful Review API call returns review data in JSON format. For example, the following request:

https://api.feefo.com/api/version/reviews/summary/all?merchant_identifier=example-retail-merchant 

Would return the following review data from Feefo:

{

  "merchant": {

    "identifier": "example-retail-merchant", 

    "name": "Example Retail Merchant", 

    "url": "http://www.exampleretailmerchant.co.uk", 

    "logo": "example-retail-merchant-logo.png", 

    "review_url": "http://www.feefo.com/en_GB/reviews/example-retail-merchant"

  }, 

  "meta": {

    "count": 3878, 

    "pages": 194, 

    "page_size": 20

  }, 

   "rating": {

     "min": 1, 

     "max": 5, 

     "rating": 4.9, 

     "service": {

       "count": 3878, 

       "1_star": 8, 

       "2_star": 28, 

       "3_star": 0, 

       "4_star": 181, 

       "5_star": 3661

    }, 

     "product": {

       "count": 6240, 

       "1_star": 55, 

       "2_star": 102, 

       "3_star": 0, 

       "4_star": 724, 

       "5_star": 5359

    }

  }

}

 

For full details of all of the possible response parameters for the Feefo API please view Reviews API Request or Reviews API Response.

Showcasing your reviews

Once the API has returned the correct data to your servers, it’s up to you and your developers to create a suitable code that lets you present the results however you’d like.

This is your opportunity give your Feefo reviews the same look and feel as your brand. Seamlessly integrate your reviews onto your web pages safe in the knowledge that your feedback mirrors the rest of your website – creating engaging content that keeps customers on your site for longer!

Optional parameters are:

  • review_count

review_count determines if the data returned includes the number of reviews over which the average is calculated. Default = false. If set to true, review_count is included with the product rating data.

  • since_period

since_period defines the period over which the average rating is calculated. Default = year.
 Values are:

  1. 24_hours
  2. week
  3. month
  4. year
  5. all
  • parent_product_sku

parent_product_sku returns only products with the corresponding parent_product_sku.

  • product_sku
     

product_sku is a filter for product reviews assigned to the specified product search code. More than one product_sku can be provided in one request with each product_sku separated by a comma. The value of the product_sku is case insensitive and supports the use of an asterisk (*) as a wildcard character at the beginning and/or end of the supplied parameter to support partial matching for related/variant products.

  • page_size
     

page_size defines the number of reviews to return per page, the default is 20 and the maximum value is 100.

  • page

page defines the page number to return reviews for, the default is 1.