Skip to main content
Use the Rich Snippets endpoint to add a visible product rating and matching Product JSON-LD to non-Shopify storefronts. Call it from your storefront server so search engines receive both values in the initial response.

​
Prerequisites

Before you start, collect:
  • your workspace publishable key
  • a product reference
  • the product page language
A market is optional when the request includes the product page URL as the referrer.

​
Authenticate requests

Send your publishable key as a bearer token:

​
Render a Rich Snippet

  1. Call the endpoint before returning the product page.
  2. Pass a Cevoid product ID, variant ID, external product reference, or product slug as productRef.
  3. Pass the page language. Pass a market when you know it, or send the product page URL so Cevoid can select the market.
  4. Insert html where the rating should appear.
  5. Serialize jsonLd into the same initial HTML response.
Use productRef=auto only when you also send the product page URL in the referer query parameter or Referer header. A stable product reference is more predictable for server integrations.

​
Keep one rendering snapshot

Use html and jsonLd from the same response so the visible rating matches the structured data. Keep data-cevoid-rich-snippet="ssr" on the JSON-LD script so Cevoid does not add duplicate structured data when its client script loads.
If the endpoint returns 404, omit both outputs. No published rating is available for the request.