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

# Best Sentences

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

This endpoint automatically retrieves the very best sentences from your Yotpo reviews, so you can leverage the social proof of top customer testimonials at key conversion points throughout the buyer journey! You define the star-rating score, sentence length, and more!

## Path parameters

- `account_id` string, required

## Query parameters

- `access_token` string, required

## Request body

- object
  - `minimum_sentence_length` integer — Define the minimum length of best sentences by character count. Must be less than the `maximum_sentence_length`. Default: 20 chars
  - `maximum_sentence_length` integer — Define the maximum length of best sentences by character count. Must be greater than the `minimum_sentence_length`. Default: 100 chars
  - `maximum_number_of_sentences` integer — Define the maximum number of sentences to return for this request. Default: 3 sentences
  - `start_date` string, date — Start date and time of your request. YYYY-MM-DDT00:00:00.000Z
  - `end_date` string, date — End date and time of your request. 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`
  - `product_groups` string — The name of a product group.
  - `product_collections` string — The name of a product collection
  - `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 `true` will only return best sentences from published reviews.

## Response `200`

200

- object
  - `review_sentences` object[]
    - `review_id` integer
    - `sentence` 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)