Decide your approach

Use the table below to identify the correct Authentic Discovery API approach for your site. Implementing duplicate markup can confuse search engines and negatively impact your SEO performance. It is highly recommended that you consult with Bazaarvoice Support to ensure a clean JSON-LD integration and avoid SEO conflicts.

Current Client Setup	Implementation Approach
Client using SEO	When a search engine or AI crawler visits your product webpage, implement logic to call the Bazaarvoice Authentic Discovery API. Embed the returned JSON-LD markup in the HTML or before the page renders. Continue using your existing API display solution for visual rendering. It is best practice to include all your json-ld schemas along with Bazaaroice schemas from the server side.
Client not using SEO	When a search engine or AI crawler visits your product webpage, implement logic to call the Bazaarvoice Authentic Discovery API. Replace custom schema markup logic for ratings, reviews, and Q&A with the direct embedding of the JSON-LD markup in the HTML or before the page renders. Continue using your existing API display solution for visual rendering.
Client using BVSEO SDK	Remove the BVSEO SDK from the application. When a search engine or AI crawler visits your product webpage, implement logic to call the Bazaarvoice Authentic Discovery API. Embed the returned JSON-LD markup in the HTML or before the page renders.

2## Prerequisites

Before you implement, complete the following steps:

Check your Bazaarvoice platform: Your account must use the current Bazaarvoice Conversations Ratings & Reviews (R&R) platform. The legacy PRR platform is not supported.
Client ID: Your Client ID appears as the client-id path parameter in all API requests. Confirm this value with your Bazaarvoice account team if you are unsure.
Product ID: Confirm that the product IDs you use on your PDPs match the product catalog registered in the Bazaarvoice system. A mismatch causes the API to return empty or incorrect markup.
Check your current SEO setup: If you currently use BVSEO, BVSEO SDK or any other SEO solution, replace your existing custom SEO markup logic for ratings, reviews, and questions by directly embedding the server-side Authentic Discovery API response into your HTML. You should continue using your current API display solution for all visual rendering.
ℹ️
Note:
If you face any issues during implementation, please contact Bazaarvoice Support for assistance.