---
updatedAt: 2026-10-29T11:54:48.000Z
agentTools:
  projectIndex: https://docs.yotpo.com/llms.txt
---

# Search & Merchandising

This guide details how you can incorporate star ratings and top reviews into product results and search results to increase click-through rates and engagement.

Main use cases covered in this guide:

* [Display star ratings for a product](https://docs.yotpo.com/docs/search-integration#display-star-ratings-for-a-product)
* [Display a top review for a product](https://docs.yotpo.com/docs/search-integration#display-a-top-review-for-a-product)
* [Filter search results or category pages by avg. product rating](https://docs.yotpo.com/docs/search-integration#filter-search-results-by-avg-product-rating)
* [Filter search results or category pages by most reviewed product](https://docs.yotpo.com/docs/search-integration#filter-search-results-by-most-reviewed-product)
* [Include relevant review content in search keyword results](https://docs.yotpo.com/docs/search-integration#include-relevant-review-content-in-search-keyword-results)

> 📘 Have you registered your app yet?
>
> Before you start building your app on top of Yotpo’s App Developer API, you first need to register it with us. If you haven’t done so yet, refer to the steps in our <a href="/docs/welcome" target="_blank">Welcome guide</a>.

> 🚧 Matching Product IDs
>
> To pull the relevant information for a product from Yotpo, you'll need to include the correct product ID for that merchant or platform. <a href="https://support.yotpo.com/docs/finding-product-ids-in-your-e-commerce-platform" target="_blank">Learn more</a>

## Display star ratings for a product

Pull a single product’s star rating in real-time. Use the <a href="/reference/bottomline" target="_blank">product star rating</a> endpoint and display that product’s ‘average\_score’.

## Display a top review for a product

Pull a single product’s top review(s) using Yotpo’s AI layer, or even just the most exciting sentence(s) to keep it short. Use the <a href="/reference/best-reviews" target="_blank">best reviews</a> and <a href="/reference/best-sentences" target="_blank">best sentences</a> endpoints with the relevant product ID. You can create other filters such as review length, sentiment score, and more.

## Filter search results by avg. product rating

Use the <a href="/reference/all-products" target="_blank">retrieve all products</a> endpoint and store the average\_score for each product in your system for filtering.

## Filter search results by most reviewed product

Use the <a href="/reference/all-products" target="_blank">retrieve all products</a> endpoint and store the total\_reviews count for each product in your system to be filtered by.

## Include relevant review content in search keyword results

Syncing review content into product data starts with storing the reviews in the account - <a href="/reference/all-reviews" target="_blank">fetch all reviews</a>. You can store this content and identify topics that are mentioned in the reviews per product such as common descriptions, a name of a material, common purpose of purchase, and more.

# Sibling pages

* [Email Marketing & Communications](https://docs.yotpo.com/docs/email-marketing-communications.md)
* [BI, Analytics, and CDP Best Practice Guide](https://docs.yotpo.com/docs/bi-analytics-and-cdp-best-practice-guide.md)
* [Service Desk & CRM Integrations](https://docs.yotpo.com/docs/service-desk-crm-integrations.md)
* [On-site Engagement & Lead Capture](https://docs.yotpo.com/docs/on-site-engagement-lead-capture.md)
* [Product Recommendations](https://docs.yotpo.com/docs/product-recommendations.md)
* [Mobile Apps](https://docs.yotpo.com/docs/mobile-apps.md)
* [Influencer & Affiliate Marketing](https://docs.yotpo.com/docs/influencer-affiliate-marketing.md)
* [Shipping & Returns Best Practice Guide](https://docs.yotpo.com/docs/shipping-returns-best-practice-guide.md)