Here we'll take a closer look at the available parameters and values for the Review API endpoint that retrieves summary information such as counts and average scores (no detailed review content is included. The parameters for detailed content can be found further below:


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

Note that in all examples on this page, version should be replaced with the appropriate version number of the API. The current version number for Reviews API can be found in API Versions.

There are four possible modes for this endpoint:

https://api.feefo.com/api/20/reviews/summary/all

mode = all: Creates a summary for both your service and product reviews. Authentication is not required.

https://api.feefo.com/api/20/reviews/summary/service

mode = service: Creates a summary of your service reviews. Authentication is not required. 

https://api.feefo.com/api/20/reviews/summary/product

mode = product: Creates a summary of your product reviews. Authentication is not required.

https://api.feefo.com/api/20/reviews/summary/nps

mode = nps: Creates a summary of your NPS feedback. Authentication is required. See API Authentication for more details.


The following table lists all parameters available for the https://api.feefo.com/api/version/reviews/summary/ endpoint. Click on the parameter name for more details:

 

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

Request parameter

Brief description 

Value

Required or optional

Default 

Authentication required 


moderation_status

Filter reviews to include reviews in a status of moderation

enum

Optional

Year

Yes

Request parameter

Brief description 

Value

Required or optional

Default 

Authentication required 

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 

Request parameter

Brief description 

Value

Required or optional

Default 

Authentication required 

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

Request parameter

Brief description 

Value

Required or optional

Default 

Authentication required 

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

 

Likewise we'll now take a closer look at the available parameters and values for the Review API endpoint that retrieves detailed listing of reviews, for example individual ratings and the comments left by customers. 

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

Note that in all examples on this page, version should be replaced with the appropriate version number of the API. The current version number for Reviews API can be found in API Versions.

There are four possible modes for this endpoint:

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

mode = all: Creates detailed content for both your service and product reviews. Authentication is not required.

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

mode = service: Creates detailed content for your service reviews. Authentication is not required.

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

mode = product: Creates detailed content for your product reviews. Authentication is not required.

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

mode = nps: Creates detailed content for your NPS feedback. Authentication is required. See API Authentication for more details.

The following table lists all parameters available for the https://api.feefo.com/api/version/reviews/ endpoint. Click on the parameter name for more details:

 

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

Request parameter

Brief description  

Value

Required or optional

Default 

Authentication required 

Request parameter

Brief description  

Value

Required or optional

Default 

Authentication required 

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

Request parameter

Brief description  

Value

Required or optional

Default 

Authentication required 

full_thread

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

enum

Optional

exclude

No

Request parameter

Brief description  

Value

Required or optional

Default 

Authentication required 

sort

Dictates the fields upon which sorting can be applied. 

enum 

Optional

updated_date  

No

page_size

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

string

Optional

20

No

page

The page number to return reviews for.

string

Optional

1

No

fields

Limit the response to include certain fields.

string

Optional

None

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