---
updatedAt: 2026-10-29T08:22:22.000Z
agentTools:
  projectIndex: https://docs.yotpo.com/llms.txt
---

# Retrieve product filters

Retrieves product-level filters 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.

# 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/store/{storeId}/product/{productId}/productFilters": {
      "get": {
        "summary": "Retrieve product filters",
        "description": "Retrieves product-level filters used for storefront review experiences.",
        "operationId": "storefront-product-filters",
        "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"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "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": {
                      "type": "array",
                      "items": {}
                    },
                    "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": {}
                  }
                },
                "examples": {
                  "Result": {
                    "value": {
                      "storeId": "YOUR_STORE_ID",
                      "productId": "94562870",
                      "externalId": "2063374417974",
                      "topics": [
                        "bag",
                        "quality"
                      ],
                      "customQuestions": [],
                      "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
                    }
                  }
                }
              }
            }
          },
          "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 data](https://docs.yotpo.com/reference/storefront-product-data.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)