---
title: "Top Reviews"
method: GET
path: "/v2/{account_id}/top_reviews"
---

# Top Reviews

`GET /v2/{account_id}/top_reviews`

## Request

- Base URL: `https://developers.yotpo.com`
- URL: `https://developers.yotpo.com/v2/{account_id}/top_reviews`
- Auth: API key in header `X-Yotpo-Token`

This endpoint automatically retrieves the top reviews from your Yotpo reviews based on the star rating.

## Path parameters

- `account_id` string, required

## Query parameters

- `external_product_id` string

## Response `200`

200

- object
  - `status` object
    - `code` integer
    - `message` string
  - `pagination` unknown
  - `top_reviews` object
    - `reviews` object[]
      - `image_url` string
      - `score` integer
      - `title` string
      - `content` string
      - `product_url` string
      - `created_at` 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/top_reviews/get.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)