Skip to main content
Use the Storefront API to display public posts, reviews, and ratings in custom storefronts. Authenticate with a publishable key; scopes are not required.

Posts

Fetch posts for product pages, community walls, and galleries.

Product reviews

Read reviews with market-specific text and optional originals.

Company reviews

Read company reviews and their response fields.

Rich Snippets

Fetch product ratings markup and matching JSON-LD.
For implementation steps, see Custom UGC experiences or the Rich Snippets guide.

​
Caching

Successful post and Rich Snippet responses use these cache durations:
  • Browsers can cache a response for 60 seconds.
  • Shared CDNs can cache a response for five minutes.
  • CDNs can serve a stale response for five more minutes while refreshing it.
The complete request URL and publishable key identify the cached response. Rich Snippets also vary by referrer because the page URL can select a product or market. Error responses are not publicly cached. Content removed in Cevoid can remain in a shared cache for up to ten minutes. Review responses use Cache-Control: no-store, including ratings and summaries.

​
Rate limits

All Storefront endpoints share one limit per publishable key: 20 requests per second, with bursts of up to 40 requests. Each request counts once, regardless of page size. For example, after a burst of 40 requests uses the available allowance, one second without requests restores room for 20 more. Two seconds restores the full allowance of 40. When the allowance runs out, the API returns 429. Wait the number of seconds in Retry-After before retrying. RateLimit-Limit is the burst allowance (40), RateLimit-Remaining is the available allowance, and RateLimit-Reset is the retry delay (0 on successful requests). Only requests that reach the API count. Responses served directly from a CDN cache do not.