Request parameter
Value
Required or optional
Default
Endpoints Authentication required 
tags
string
Optional
None
summary, reviews No

tags are used to filter reviews so that the JSON feed only contains data that has the defined tags. More details about sale/product tags can be found at Sales File Field: tags.

Tags can be combined to create complex filters. Where multiple tags are supplied they will be filtered on an “AND” basis. Each tag is supplied as a key/value pair separated by a colon (:) with a comma (,) between each tag and set up to use sale, product or insight tags.

A simple example Reviews API call using tags is:

https://api.feefo.com/api/version/reviews/all?merchant_identifier=example-retail-merchant&tags=saleschannel:Mobile,region:UK

Where:

  • version = the version of the API associated with the URL. See API Versions for the version number.
  • all = returns both service and product reviews.
  • merchant_identifier = the merchant's unique Feefo identifier, which in this example is example-retail-merchant.
  • tags = filter by these tag values. In this example only reviews with sales tags of 'saleschannel = Mobile' and 'region = UK' will be passed to the feed.

This example contains spaces and a comma in the values and therefore the Reviews API call becomes:

https://api.feefo.com/api/version/reviews/all?merchant_identifier=example-retail-merchant&tags=[category:CDs,%20Vinyl%20%26%20Tapes],[department:Music%20%26%20Entertainment]

Where:

  • version = the version of the API associated with the URL. See API Versions for the version number.
  • all = returns both service and product reviews.
  • merchant_identifier = the merchant's unique Feefo identifier, which in this example is example-retail-merchant.
  • tags = filter by these tag values. In this example, the square brackets are placed around 'category' and 'department' as their values contain commas and other encoding. The example also highlights how spaces and other characters should be included, so rather than using literal characters, the ASCII code equivalent is used instead with spaces identified by %20 and ampersand by %26. Only reviews with tags of these values will be passed to the feed.

Full details about the API can be found at Reviews API (Customisable Integration).

Reviews API Parameter: merchant_identifierReviews API Parameter: date_time