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

# Best Reviews

`POST /v2/{account_id}/best_reviews`

## Request

- Base URL: `https://developers.yotpo.com`
- URL: `https://developers.yotpo.com/v2/{account_id}/best_reviews`
- Auth: API key in header `X-Yotpo-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

## 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
- `401`: Missing or invalid access token. Send a valid token in the `X-Yotpo-Token` header.

## Changes

- **2026-11-03** `5bcae8239b6e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/yotpo/apis/app-developer-api/changes/v2/:account_id/best_reviews/post.md)

---

[API](https://skmtc.dev/yotpo/apis/app-developer-api.md) - [All operations](https://skmtc.dev/yotpo/apis/app-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/yotpo/apis/app-developer-api/revisions/5bcae8239b6e?raw)