Request parameter
Required or optional
Endpoints  Authentication required 
summary, reviews  No

since_period is used to filter the JSON feed to those reviews created during a specified period. Possible values are:

  • 24_hours
    Past 24 hours from the current date / time.
  • week
    Past 7 days from the current date / time. 
  • month
    Past 30 days from the current date / time.
  • year
    Past 365 days from the current date / time.
  • all
    All reviews irrespective of when they were received.

Note: If using since_period in conjunction with other parameters involving date and time, since_period overrides the following:

However since_period is overridden by:

An example Reviews API call using since_period is:


  • 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.
  • since_period = filter by this period. In this example, only reviews created during the past 7 days of this date / time will be passed to the feed.

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

Reviews API Parameter: tagsReviews API Parameter: since_updated_period