# UGC Documentation Documentation

> All the endpoints you need to leverage UGC data from Yotpo throughout your store. Yotpo's core API endpoints allow you to retrieve data on reviews, products, users, and much much more.

## Guides
- [Yotpo Headless Integration Guide (API-Based)](https://apidocs.yotpo.com/docs/yotpo-headless-integration-guide-api-based.md)

## API Reference
- [Welcome](https://apidocs.yotpo.com/reference/welcome.md): Introduction to the Yotpo UGC API — access reviews, photos, insights, and more.
- [Store ID and API Secret](https://apidocs.yotpo.com/reference/finding-your-app-key-and-api-secret.md): Learn where to find the credentials required for authenticating with the Yotpo API.
- [Guidelines & Conventions](https://apidocs.yotpo.com/reference/guidelines-and-conventions.md): A quick overview of base URLs, formats, status codes, pagination, and best practices when using the Yotpo API.
- [Create review](https://apidocs.yotpo.com/reference/create-review.md): This is the asynchronous method and is recommended for general use.
- [Upload Images With Reviews Via API](https://apidocs.yotpo.com/reference/upload-images-with-reviews.md): Upload images to associate with a review using the image_upload_token received from the Create Reviews endpoint.
- [Retrieve all reviews](https://apidocs.yotpo.com/reference/retrieve-all-reviews.md)
- [Update incentivized reviews by review ID](https://apidocs.yotpo.com/reference/update-incentive-by-review-id-1.md): Use this endpoint to update the review IDs of reviews that have been given incentives.
- [Retrieve bottom line (total reviews and average score) for all products](https://apidocs.yotpo.com/reference/retrieve-bottom-line-total-reviews-and-average-score-for-all-products.md): A request to retrieve all bottomlines (average score and review count of an account). The request is paginated and limited for a maximum of 100 items per page.  Product grouping and/or syndication may result in two bottom line scores for each product:  * The first score represents all grouped reviews and syndicated reviews * The second score represents the organic score
- [Retrieve bottom line (total reviews and average score) for a specific product](https://apidocs.yotpo.com/reference/retrieve-bottom-line-total-reviews-and-average-score-for-specific-product.md)
- [Search reviews](https://apidocs.yotpo.com/reference/search-reviews.md): This endpoint acts as a flexible search that can be used to retrieve reviews with various metadata or with top\_mentioned\_topics.
- [Product-Level Data](https://apidocs.yotpo.com/reference/product-level-data.md): This endpoint Retrieves Product-level data for a given product by product ID (domain_key). Product-level data can be used within your reviews widget.
- [All-Bottomline](https://apidocs.yotpo.com/reference/all-bottomline.md): Retrieve bottomline scores for each product. These scores help track product feedback across different categories.  **Total Reviews and Scores** - Includes all reviews from all sources. **Total Organic Reviews and Scores** - Includes reviews from the domestic store only (No syndication, No Shop Reviews).  For example, you can use it to: - Retrieve the bottom line (total reviews and average score) for all products - Total Reviews - Including all other sources - Average Score - Including all other sources - Total Organic Reviews (Domestic Store only reviews) - Organic Average Score (Domestic Store only reviews)  **Pagination:** The endpoint is limited to returning a maximum of 10 items per page, so multiple calls are needed to retrieve more data.
- [Retrieve LLM schema HTML for a product](https://apidocs.yotpo.com/reference/retrieve-llm-schema.md): Retrieve user-generated content as HTML optimized for server-side embedding on Product Detail Pages so LLM crawlers can index review content from page source.
- [About reviews metadata](https://apidocs.yotpo.com/reference/about-reviews-metadata.md)
- [Create an answer to a question](https://apidocs.yotpo.com/reference/create-answer-for-question.md): Create a public or private Answer to a specific Question per `question_id`.
- [Create question (with confirmation email)](https://apidocs.yotpo.com/reference/send-question-confirmation-mail.md): Create and send a Question which requires email confirmation.

## Changelog
- [Changelog](https://apidocs.yotpo.com/changelog/welcome-to-yotpo.md)