# Storefront API

> Display public posts, reviews and ratings in custom storefronts with a publishable key.

Breadcrumb: Storefront API › Overview · Updated: 2026-10-19
Docs index: https://docs.cevoid.com/developers/llms.txt

Use the Storefront API to display public posts, reviews and ratings in custom storefronts. Authenticate with a [publishable key](https://docs.cevoid.com/developers/storefront-api/authentication.md); scopes are not required.

```bash
curl "https://api.widget.cevoid.com/v1/posts?market=mar_sweden&product_ref=gid%3A%2F%2Fshopify%2FProduct%2F123&limit=12" \
  -H "Authorization: Bearer ${CEVOID_PUBLISHABLE_KEY}"
```

> [!NOTE]
> Storefront API paths on `api.widget.cevoid.com` start with `/v1`. They are current and unrelated to the legacy [API v1](https://docs.cevoid.com/developers/api/v1.md) on `api.cevoid.com/v1`.

- [Posts](https://docs.cevoid.com/developers/storefront-api/storefront-ugc/list-posts.md): Fetch posts for product pages, community walls, and galleries.
- [Product reviews](https://docs.cevoid.com/developers/storefront-api/reviews/list-product-reviews.md): Read product reviews with market-specific text and optional originals.
- [Company reviews](https://docs.cevoid.com/developers/storefront-api/reviews/list-company-reviews.md): Read company reviews and their public replies.
- [Rich snippets](https://docs.cevoid.com/developers/storefront-api/rich-snippets.md): Fetch product ratings markup and matching JSON-LD.

For implementation steps, see [Custom UGC experiences](https://docs.cevoid.com/developers/storefront-api/custom-ugc.md) or the [rich snippets guide](https://docs.cevoid.com/developers/storefront-api/rich-snippets.md). To render post images at the right size, see [Image optimization](https://docs.cevoid.com/developers/storefront-api/images.md).

The review endpoints and rich snippets need Reviews in your workspace's plan. Without it, they return `403`.

Browsers and CDNs can cache successful post and rich snippet responses; review responses are never cached. All Storefront endpoints share one rate limit per publishable key. See [Caching](https://docs.cevoid.com/developers/storefront-api/caching-and-rate-limits.md#caching) and [Rate limits](https://docs.cevoid.com/developers/storefront-api/caching-and-rate-limits.md#rate-limits) for the durations, limits and headers.

## OpenAPI specification

The reference is generated from the [OpenAPI specification](https://docs.cevoid.com/developers/openapi/storefront.json). Download it to generate a client or import the API into your HTTP tool.

**Recent changes**

- [Storefront reviews and rich snippets need Reviews in the workspace plan](https://docs.cevoid.com/developers/changelog.md#2026-10-13-rich-snippets-reviews-plan) (Changed, 2026-10-13): The Storefront API's review endpoints and GET /v1/products/{productRef}/rich-snippet return 403 when the workspace's plan does not include Reviews, with the message that Reviews is not included in the plan.
- [Storefront API posts](https://docs.cevoid.com/developers/changelog.md#2026-10-02-storefront-posts) (Added, 2026-10-02): GET /v1/posts and GET /v1/posts/{post_id} on the Storefront API return a workspace's public posts for custom storefronts, called with a publishable key.
- [Storefront API reviews](https://docs.cevoid.com/developers/changelog.md#2026-09-20-storefront-api-reviews) (Added, 2026-09-20): The Storefront API reads a workspace's public product and company reviews, their ratings and summaries, for custom storefronts, called with a publishable key.

[All Storefront API changes in the changelog](https://docs.cevoid.com/developers/changelog.md)

---

Canonical: https://docs.cevoid.com/developers/storefront-api