Reviews Summary API
      Back to home
      1. Knowledge Base
      2. For Developers
      3. Reviews Summary API

      Reviews API Summary Detail

      The following table lists all parameters available for the https://api.feefo.com/api/version/reviews/summary/ endpoint. 


      If you would like to manage your own display solution, Feefo's Review API allows you to retrieve all the data you need. However, this solution is not suitable as a means of batch retrieving review content if you plan to self-host the data due to network edge caching. If you would like to self-host your review content please contact us to discuss the best options taking your requirements into consideration.

       

      Request parameter

      Brief description 

      Value

      Required or optional

      Default 

      Authentication required 

      merchant_identifier

      Unique identifier for the merchant account.

      string

      Required

      None

      No

      tags

      Filter for reviews with corresponding tags. 

      string

      Optional

      None

      No

      date_time

      Filter reviews to those created on a specified UTC date / time. 

      string

      Optional

      None

      No

      updated_date_time

      Filter reviews to those updated on a specified UTC date / time. 

      string

      Optional

      None

      No 

      since_period

      Filter reviews to those created during the specified period. 

      enum

      Optional

      year

      No

      since_updated_

      period

      Filter reviews to those updated during the specified period. 

      enum

      Optional

      year

      No

      origin

       

      Defines the domain name of the web page calling the Reviews API feed.

      string

      Optional but required when using multiple domains to call the same reviews API feed

      None

      No

      id

      Filter reviews based on the feedback id. 

      string

      Optional

      None

      No 

      parent_product_

      sku

      Filter for product reviews assigned to the specified parent product search code. 

      string

      Optional for:
      mode = all
      mode = service
      mode = nps
      Required for:
       mode = product (if product_sku is not used)

      None

      No


      moderation_status

      Filter reviews to include reviews in a status of moderation

      enum

      Optional

      Year

      Yes

      product_sku

      Filter for product reviews assigned to the specified product search code. 

      string

      Optional for:
      mode = all
      mode = service
      mode = nps
      Required for:
       mode = product (if parent_product_sku is not used)

      None

      No

      customer_reference

      Filter for reviews from a specific customer based on a unique customer reference. 

      string

      Optional

      None

      Yes

      customer_email

      Filter for reviews from a specific customer email. 

      string

      Optional

      None

      Yes 

      order_reference

      Retrieve the feedback relating to a specific order. 

      string

      Optional

      None

      Yes

      rating

      Defines the number of stars or the NPS score that the reviews should have to be included in the feed.

      string

      Optional

      None

      No

      children

      Specified if feedback from child account should be included in the result set. 

      enum

      Optional

      include 

      No 

      media

      Specifies filters applied to feedback with associated media. 

      enum

      Optional

      include

      No 

      empty_product_

      comments

      Specifies how product reviews with no comments should be handled. 

      enum

      Optional

      default

      No 

      Unanswered_feedback

      Specifies the filter to be applied to unanswered feedback rated 1 or 2 stars during the first 48 hours.

      enum

      Optional

      include 

      No 

      enhanced_insight

      Only functional if the account has Smart Themes enabled.
       Specifies if enhanced insight data should be included in the API response.

      enum

      Optional

      exclude

      No

      feature

      Only functional if the account has Smart Themes enabled and the API call includes the enhanced_insight parameter.
      Filter reviews to those that include the associated feature.

      string

      Optional for:
      mode = service
      mode = product
      Unsupported for:
      mode = all
       mode = nps

      None

      No