---
title: "Best Reviews"
method: POST
path: "/v2/{account_id}/best_reviews?access_token={access_token}"
---

# Best Reviews

`POST /v2/{account_id}/best_reviews?access_token={access_token}`

Leveraging Yotpo's Insights engine, 'Best reviews' are identified, parsed, and extracted based on the number of distinct positive topics and opinions within your reviews. You can define the minimum star-rating score, topics, sentence length, and more. Please note: this endpoint supports English reviews only. For reviews in other languages, you can use the "top reviews" endpoint.

## Path parameters

- `account_id` string, required

## Query parameters

- `access_token` string, required

## Request body

- object
  - `minimum_review_length` integer — The minimum length of reviews to return. Must be less than `maximum_review_length`. Default: 150 characters
  - `maximum_review_length` integer — The maximum length of reviews to return. Must be greater than `minimum_review_length` Default: 500 characters
  - `minimum_title_length` integer — The minimum review title length to return. Default: 20 characters
  - `maximum_title_length` integer — The maximum review title length to return. Default: 100 characters
  - `start_date` string, date — Start date of your request (Default: 12 Months) YYYY-MM-DDT00:00:00.000Z
  - `end_date` string, date — End date of your request (Default: 12 Months). YYYY-MM-DDT00:00:00.000Z
  - `external_product_ids` string[] — Product ID. Supports multiple products. This parameter is also sometimes referred to as `SKU` or `domain_key`
  - `topics` string[] — The name of the topic. Supports multiple topics.
  - `exclude_topics` string[] — Use this param to filter out a certain topic from the response.
  - `max_reviews` integer — The maximum number of reviews to return (Default: 10). Limited to 1000 reviews per request.
  - `minimum_score` integer — Filter by minimum star-rating. Must be an integer between 1 and 5(stars) Default: 4
  - `exclude_unpublished` boolean — Passing this param as `false` will return unpublished reviews. Default: `true`
  - `exclude_syndicated` boolean — Set as `true` to exclude syndicated reviews. Default: `false`
  - `exclude_negative_opinions` boolean — Set as `false` to include reviews with negative opinions. Default: `true`
  - `exclude_grouped_reviews` boolean — Set as `true` to include reviews from grouped products. Default: `false`

## Response `200`

200

- object
  - `status` object
    - `code` integer
    - `message` string
  - `pagination` unknown
  - `best_review` object
    - `best_reviews` object[]
      - `review_id` string
      - `external_product_id` string
      - `topics` string[]

## Other responses

- `400` — 400

---

[API](https://skmtc.net/yotpo/apis/app-developer-api.md) · [All operations](https://skmtc.net/yotpo/apis/app-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yotpo/app-developer-api/revisions/4effe7674a3b/schema)