Log in to see full request history

Welcome to our comprehensive guide on utilising the Reviews API endpoint, designed to empower you with the ability to retrieve detailed insights into customer feedback. In this article, we delve into the various parameters and values associated with the Review API endpoint, which facilitates the extraction of comprehensive data encompassing individual ratings and customer comments.

📘

Note

If you would like to manage your own display solution Feefo's Reviews API allows you to retrieve all the data you need.

This option 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.

The Reviews API endpoint offers four distinct modes, each tailored to meet specific requirements and preferences:

EndpointDescription
https://api.feefo.com/api/20/reviews/allCreates detailed content for both your service and product reviews. Authentication is not required.
https://api.feefo.com/api/20/reviews/serviceCreates detailed content for your service reviews. Authentication is not required.
https://api.feefo.com/api/20/reviews/productCreates detailed content for your product reviews. Authentication is not required.
https://api.feefo.com/api/20/reviews/npsCreates detailed content for your NPS feedback. Authentication is required. See API Authentication for more details.
Path Params
string
required
Defaults to all
Query Params
string

Unique identifier for the merchant account.

Body Params
string

Filter for reviews with corresponding tags.

string

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

string

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

string
Defaults to year

Filter reviews to those created during the specified period.

string
Defaults to year

Filter reviews to those updated during the specified period.

string

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

string

Filter reviews based on the feedback id.

string

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

string
Defaults to all

Filter reviews to include reviews in a status of moderation

string

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

string

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

string

Filter for reviews from a specific customer email.

string

Retrieve the feedback relating to a specific order.

string

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

string
Defaults to Include

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

string
Defaults to include

Specifies filters applied to feedback with associated media.

string
Defaults to include

Specifies how product reviews with no comments should be handled.

string
Defaults to include

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

string
Defaults to exclude

Specifies whether subsequent exchanges between the customer and merchant should be included in the response.

string
Defaults to updated_date

Dictates the fields upon which sorting can be applied.

string
Defaults to 20

The number of reviews to return per page, limited to 100.

string
Defaults to 1

The page number to return reviews for.

string

Limit the response to include certain fields.

string
Defaults to exclude

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

string

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.

Responses

Response body
json

Language
Credentials
OAuth2
Click Try It! to start a request and see the response here!