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/allmode = 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.
| 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 |
| 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 |
| 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.
| 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 |
| 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 |
| 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 |