---
updatedAt: 2026-11-03T16:05:35.000Z
agentTools:
  projectIndex: https://docs.yotpo.com/llms.txt
---

# Retrieve product data

Retrieves product-level data used for storefront review experiences.

> 👍 How to use this endpoint
>
> * No access token is needed. This is a public endpoint served from Yotpo's CDN (`api-cdn.yotpo.com`).
> * Data is returned with a delay of up to 3 hours, so new or updated reviews can take up to 3 hours to appear.

Use `include` to choose the blocks you need. Values are case-sensitive:

* `topics`: Smart Topics, shown as smart filters in the reviews widget.
* `reviewsSummary`: the AI review summary and its highlights from top reviews.
* `countries`: countries the product was reviewed from.
* `customQuestions`: custom questions, shown as filters.
* `metadata`: order metadata, shown as filters.
* `productVariants`: variants, shown as variant filters.

An unknown `productId` returns `200` with `null` fields, not `404`. Requests are limited to 30,000 per minute per IP address.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Reviews storefront API V3",
    "version": "3.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"
    }
  ],
  "security": [],
  "paths": {
    "/v3/storefront/stores/{storeId}/products/{productId}/productData": {
      "get": {
        "summary": "Retrieve product data",
        "description": "Retrieves product-level data used for storefront review experiences.",
        "operationId": "storefront-product-data",
        "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": "include",
            "in": "query",
            "required": true,
            "description": "Data blocks to include in the response. Required: requests without `include` return `400`.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "topics",
                  "reviewsSummary",
                  "metadata",
                  "customQuestions",
                  "countries",
                  "productVariants"
                ]
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "integer",
                          "description": "HTTP status code."
                        },
                        "message": {
                          "type": "string",
                          "description": "Status message."
                        }
                      },
                      "description": "Response status."
                    },
                    "response": {
                      "type": "object",
                      "properties": {
                        "storeId": {
                          "type": "string",
                          "description": "Your store ID."
                        },
                        "productId": {
                          "type": "string",
                          "description": "Product ID (domain key) in your store."
                        },
                        "externalId": {
                          "type": "string",
                          "description": "Product ID (domain key) in your store."
                        },
                        "topics": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Topics mentioned in the product's reviews."
                        },
                        "customQuestions": {},
                        "syndicatedCustomQuestions": {},
                        "productVariants": {},
                        "metadata": {
                          "type": "array",
                          "items": {}
                        },
                        "summaryTopics": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "displayTopic": {
                                "type": "string"
                              },
                              "topic": {
                                "type": "string"
                              },
                              "summary": {
                                "type": "string"
                              },
                              "coverage": {
                                "type": "string"
                              },
                              "avgSentiment": {
                                "type": "number"
                              }
                            }
                          }
                        },
                        "summaryHighlights": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "reviewId": {
                                "type": "integer"
                              },
                              "reviewerName": {
                                "type": "string"
                              },
                              "highlight": {
                                "type": "string"
                              }
                            }
                          }
                        },
                        "paragraphSummary": {
                          "type": "string"
                        },
                        "countries": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string",
                                "description": "HTTP status code."
                              },
                              "label": {
                                "type": "string",
                                "description": "Display label."
                              },
                              "count": {
                                "type": "integer",
                                "description": "Number of reviews."
                              }
                            }
                          },
                          "description": "Countries reviewers are from, with review counts."
                        },
                        "bundledProductsData": {}
                      },
                      "description": "Response payload."
                    }
                  }
                },
                "examples": {
                  "Result": {
                    "value": {
                      "status": {
                        "code": 200,
                        "message": "OK"
                      },
                      "response": {
                        "storeId": "YOUR_STORE_ID",
                        "productId": "94562870",
                        "externalId": "2063374417974",
                        "topics": [
                          "bag",
                          "quality"
                        ],
                        "customQuestions": null,
                        "syndicatedCustomQuestions": null,
                        "productVariants": null,
                        "metadata": [],
                        "summaryTopics": [
                          {
                            "displayTopic": "Gift Quality",
                            "topic": "gift",
                            "summary": "Customers raved about the gift, describing it as perfect, great, beautiful, and wonderful.",
                            "coverage": "4",
                            "avgSentiment": 0.97818667
                          },
                          {
                            "displayTopic": "Product Quality",
                            "topic": "quality",
                            "summary": "A significant amount of customers expressed appreciation for the high quality of the product, with many describing it as excellent, fantastic, and amazing.",
                            "coverage": "26",
                            "avgSentiment": 0.97924423
                          }
                        ],
                        "summaryHighlights": [
                          {
                            "reviewId": 85987914,
                            "reviewerName": "Jane D.",
                            "highlight": "beautiful leather, nice workmanship, good size and design."
                          },
                          {
                            "reviewId": 85988098,
                            "reviewerName": "Jane D.",
                            "highlight": "Smart looking leather, solid hardware, perfect color, comfortable strap, comfortable handle."
                          }
                        ],
                        "paragraphSummary": "This Thin Front Pocket Leather Backpack is praised for its exceptional quality, beautiful leather, and timeless design. Customers appreciate its perfect size and the functionality of its pockets and zippered compartments. The adjustable straps add to its comfort and practicality.",
                        "countries": [
                          {
                            "code": "IL",
                            "label": "🇮🇱 Israel",
                            "count": 4
                          },
                          {
                            "code": "US",
                            "label": "🇺🇸 United States",
                            "count": 748
                          }
                        ],
                        "bundledProductsData": null
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "A required query parameter is missing."
          },
          "404": {
            "description": "Unknown store ID. The body is the plain string `Account not found`. An unknown product ID returns `200` with no data instead.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "examples": {
                  "Unknown store": {
                    "value": "Account not found"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```

# Sibling pages

* [Retrieve product reviews](https://docs.yotpo.com/reference/storefront-product-reviews.md)
* [Search product reviews](https://docs.yotpo.com/reference/storefront-product-reviews-search.md)
* [Retrieve product filters](https://docs.yotpo.com/reference/storefront-product-filters.md)
* [Retrieve reviews media](https://docs.yotpo.com/reference/storefront-reviews-media.md)
* [Retrieve top product reviews](https://docs.yotpo.com/reference/storefront-top-reviews.md)
* [Retrieve top store reviews](https://docs.yotpo.com/reference/storefront-store-top-reviews.md)
* [Retrieve store reviews](https://docs.yotpo.com/reference/storefront-store-reviews.md)
* [Search store reviews](https://docs.yotpo.com/reference/storefront-store-reviews-search.md)
* [Retrieve bottomline scores](https://docs.yotpo.com/reference/storefront-all-bottomlines.md)
* [Retrieve product rating bottomline](https://docs.yotpo.com/reference/storefront-product-ratings.md)
* [Retrieve promoted products for a store](https://docs.yotpo.com/reference/storefront-store-promoted-products.md)
* [Retrieve promoted products for a product page](https://docs.yotpo.com/reference/storefront-product-promoted-products.md)
* [Retrieve gallery media](https://docs.yotpo.com/reference/storefront-gallery-media.md)
* [Retrieve a gallery media item](https://docs.yotpo.com/reference/storefront-gallery-media-item.md)
* [Retrieve AI review summary](https://docs.yotpo.com/reference/reviews-ai-summary.md)
* [List Syndicated Retailers](https://docs.yotpo.com/reference/list-syndicated-retailers.md)