---
updatedAt: 2026-08-25T15:49:42.000Z
agentTools:
  projectIndex: https://apidocs.yotpo.com/v3.0/llms.txt
---

# Retrieve product reviews

Retrieves storefront reviews for a specific product.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Storefront API (CDN)",
    "version": "1.0",
    "description": "CDN-backed endpoints for storefront display. Base URL https://api-cdn.yotpo.com"
  },
  "servers": [
    {
      "url": "https://api-cdn.yotpo.com",
      "description": "CDN-backed API server for storefront access"
    }
  ],
  "components": {
    "securitySchemes": {
      "X-Yotpo-Token": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Yotpo-Token",
        "description": "Access token used to authenticate storefront requests."
      }
    }
  },
  "security": [
    {
      "X-Yotpo-Token": []
    }
  ],
  "paths": {
    "/v3/storefront/store/{storeId}/product/{productId}/reviews": {
      "get": {
        "summary": "Retrieve product reviews",
        "description": "Retrieves storefront reviews for a specific product.",
        "operationId": "storefront-product-reviews",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "description": "Store identifier",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "productId",
            "in": "path",
            "required": true,
            "description": "Product identifier",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "smart",
                "date",
                "badge",
                "images",
                "rating"
              ]
            }
          },
          {
            "name": "direction",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "prefilterFields",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "presortingFields",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "description": "Language code used to localize review content.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": {
                      "pagination": {
                        "page": 0,
                        "perPage": 0,
                        "total": 0
                      },
                      "bottomline": {
                        "totalReview": 0,
                        "averageScore": 5,
                        "totalOrganicReviews": 0,
                        "organicAverageScore": 5,
                        "starDistribution": {
                          "1": 0,
                          "2": 0,
                          "3": 0,
                          "4": 0,
                          "5": 0
                        },
                        "customFieldsBottomline": {
                          "additionalProp1": {
                            "title": "string",
                            "type": "string",
                            "averageScore": 5,
                            "score": 5
                          },
                          "additionalProp2": {
                            "title": "string",
                            "type": "string",
                            "averageScore": 5,
                            "score": 5
                          },
                          "additionalProp3": {
                            "title": "string",
                            "type": "string",
                            "averageScore": 5,
                            "score": 5
                          }
                        }
                      },
                      "products": [
                        {
                          "id": 0,
                          "domainKey": "string",
                          "name": "string",
                          "socialLinks": {
                            "linkedin": "string",
                            "facebook": "string",
                            "twitter": "string",
                            "googleOauth2": "string"
                          },
                          "embeddedWidgetLink": "string",
                          "testimonialsProductLink": "string",
                          "productLink": "string",
                          "imageUrl": "string",
                          "productTags": [
                            {
                              "id": 0,
                              "tag": "string"
                            }
                          ]
                        }
                      ],
                      "reviews": [
                        {
                          "id": 0,
                          "score": 0,
                          "votesUp": 0,
                          "votesDown": 0,
                          "content": "string",
                          "title": "string",
                          "createdAt": "2026-05-06T07:28:21.117Z",
                          "verifiedBuyer": true,
                          "sentiment": 0,
                          "isIncentivized": true,
                          "incentiveType": "string",
                          "isShop": true,
                          "topics": {
                            "additionalProp1": {
                              "name": "string",
                              "sentence": "string"
                            },
                            "additionalProp2": {
                              "name": "string",
                              "sentence": "string"
                            },
                            "additionalProp3": {
                              "name": "string",
                              "sentence": "string"
                            }
                          },
                          "fieldsHighlights": {
                            "additionalProp1": [
                              "string"
                            ],
                            "additionalProp2": [
                              "string"
                            ],
                            "additionalProp3": [
                              "string"
                            ]
                          },
                          "customFields": {
                            "additionalProp1": {
                              "title": "string",
                              "formId": 0,
                              "fieldType": "string",
                              "value": {}
                            },
                            "additionalProp2": {
                              "title": "string",
                              "formId": 0,
                              "fieldType": "string",
                              "value": {}
                            },
                            "additionalProp3": {
                              "title": "string",
                              "formId": 0,
                              "fieldType": "string",
                              "value": {}
                            }
                          },
                          "metadata": [
                            {
                              "title": "string",
                              "fieldType": "string",
                              "value": "string"
                            }
                          ],
                          "videosData": [
                            {
                              "id": 0,
                              "entryId": "string",
                              "thumbnailUrl": "string",
                              "galleryMediaId": "string",
                              "syndication": {
                                "partnerId": "string",
                                "playerId": "string"
                              }
                            }
                          ],
                          "imagesData": [
                            {
                              "id": 0,
                              "thumbUrl": "string",
                              "originalUrl": "string",
                              "imageWidth": 0,
                              "imageHeight": 0
                            }
                          ],
                          "comment": {
                            "id": 0,
                            "content": "string",
                            "createdAt": "2026-05-06T07:28:21.117Z",
                            "displayName": "string",
                            "commentsAvatar": "string"
                          },
                          "user": {
                            "userId": 0,
                            "socialImage": "string",
                            "userType": "string",
                            "isSocialConnected": 0,
                            "displayName": "string"
                          },
                          "sourceReviewId": 0,
                          "syndicationData": {
                            "productUrl": "string",
                            "productAppKey": "string",
                            "productName": "string"
                          },
                          "groupingData": {
                            "productUrl": "string",
                            "productName": "string"
                          },
                          "country": {
                            "code": "string",
                            "label": "string"
                          },
                          "productVariants": {
                            "additionalProp1": "string",
                            "additionalProp2": "string",
                            "additionalProp3": "string"
                          }
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "x-internal": false
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```

# Sibling pages

* [Search product reviews](https://apidocs.yotpo.com/v3.0/reference/storefront-product-reviews-search.md)
* [Retrieve product filters](https://apidocs.yotpo.com/v3.0/reference/storefront-product-filters.md)
* [Retrieve product data](https://apidocs.yotpo.com/v3.0/reference/storefront-product-data.md)
* [Retrieve reviews media](https://apidocs.yotpo.com/v3.0/reference/storefront-reviews-media.md)
* [Retrieve top product reviews](https://apidocs.yotpo.com/v3.0/reference/storefront-top-reviews.md)
* [Retrieve top store reviews](https://apidocs.yotpo.com/v3.0/reference/storefront-store-top-reviews.md)
* [Retrieve store reviews](https://apidocs.yotpo.com/v3.0/reference/storefront-store-reviews.md)
* [Search store reviews](https://apidocs.yotpo.com/v3.0/reference/storefront-store-reviews-search.md)
* [Retrieve bottomline scores](https://apidocs.yotpo.com/v3.0/reference/storefront-all-bottomlines.md)
* [Retrieve product rating bottomline](https://apidocs.yotpo.com/v3.0/reference/storefront-product-ratings.md)