---
title: "Retrieve store reviews"
method: GET
path: "/v3/storefront/store/{storeId}/reviews"
---

# Retrieve store reviews

`GET /v3/storefront/store/{storeId}/reviews`

## Request

- Base URL: `https://api-cdn.yotpo.com`
- URL: `https://api-cdn.yotpo.com/v3/storefront/store/{storeId}/reviews`
- Auth: none required

Retrieves storefront reviews for a specific store.

## Path parameters

- `storeId` string, required

## Query parameters

- `page` integer
- `perPage` integer
- `sort` 'smart' | 'date' | 'badge' | 'images' | 'rating'
- `direction` 'asc' | 'desc'
- `lang` string

## Response `200`

OK

- object
  - `pagination` object: Pagination details.
    - `page` integer: Current page number.
    - `perPage` integer: Results per page.
    - `total` integer: Total number of results.
  - `bottomline` object: Review summary.
    - `starDistribution` object: Number of reviews per star rating, keyed by star (1 to 5).
    - `totalReview` integer: Number of published reviews.
    - `averageScore` number: Average star rating (0 to 5).
    - `totalOrganicReviews` integer: Number of organic (non-incentivized, non-imported) reviews.
    - `organicAverageScore` number: Average star rating of organic reviews.
  - `products` object[]
    - `id` integer
    - `domainKey` string
    - `name` string
    - `socialLinks` object
      - `linkedin` string
      - `facebook` string
      - `twitter` string
      - `googleOauth2` string
    - `embeddedWidgetLink` string
    - `testimonialsProductLink` string
    - `productLink` string
    - `imageUrl` unknown
  - `reviews` object[]: Reviews on this page.
    - `id` integer
    - `score` integer: Star rating, 1 to 5.
    - `votes_up` integer
    - `votes_down` integer
    - `content` string: Review text.
    - `title` string: Review title.
    - `created_at` string, date-time
    - `deleted` boolean
    - `verified_buyer` boolean
    - `source_review_id` unknown
    - `sentiment` number
    - `custom_fields` unknown
    - `videos_data` unknown
    - `images_data` unknown
    - `comment` unknown
    - `product_id` integer
    - `user` object
      - `user_id` integer
      - `social_image` unknown
      - `user_type` string
      - `is_social_connected` integer
      - `display_name` string
    - `isShop` boolean
    - `language` string
    - `translatedLanguage` unknown

## Other responses

- `400`: Bad request
- `404`: Unknown store ID. The body is the plain string `Account not found`. An unknown product ID returns `200` with no data instead.

---

[API](https://skmtc.dev/yotpo/apis/ugc-storefront-api.md) - [All operations](https://skmtc.dev/yotpo/apis/ugc-storefront-api/llms.txt) - [OpenAPI document](https://skmtc.dev/yotpo/apis/ugc-storefront-api/revisions/09189726cf4b?raw)