Public Review API

The Appio Reviews Public API allows developers to retrieve reviews from your store programmatically. This is useful if you want to display reviews on another platform or build custom integrations.

For example, another e-commerce platform, custom website, or third-party application can use the API to fetch and display your reviews.

This API is designed for server-side or cached integrations to ensure stable performance.

Base URL

All API requests should use the following production base URL:

https://k8s.appio.pro/production

Authentication

Public API endpoints require the following query parameters for authentication:

• shop_domain – your Shopify store domain
  Example: example.myshopify.com

• api_token – your Appio Reviews public API token

No additional headers are required.

Where to Find Your API Token

You can locate your Public API Token inside the app:

Settings → Integration → Appio API

This token allows external services to retrieve your review data.

Rate Limits

To ensure system stability, API requests are rate-limited.

Endpoint:

GET /api/v1/reviews

Limit:

50 requests per minute per shop

If the limit is exceeded, the API will return:

429 Too many requests

We recommend implementing caching or server-side requests when integrating with the API.

Endpoints

1. Get Reviews

Retrieve a list of reviews from your store.

Endpoint

GET /api/v1/reviews

Required Parameters

Parameter

Description

Optional Parameters

Parameter

Description

Example Request

GET https://k8s.appio.pro/production/api/v1/reviews?shop_domain=example.myshopify.com&api_token=PUBLIC_TOKEN&product_id=123456789&status=published&page=1&per_page=10

Example Response (200)

{
  "current_page": 1,
  "per_page": 10,
  "reviews": [...]
}

2. Count Reviews

Retrieve the total number of reviews based on the provided filters.

Endpoint

GET /api/v1/reviews/count

Parameters

This endpoint uses the same authentication and filtering parameters as /api/v1/reviews.

Example Request

https://k8s.appio.pro/production/api/v1/reviews/count?shop_domain=example.myshopify.com&api_token=PUBLIC_TOKEN&product_id=123456789&status=published

Example Response (200)

42

Common Use Cases

The Public API can be used for:

• Displaying reviews on a custom website

• Syncing reviews to another e-commerce platform

• Building custom review widgets

• Integrating reviews with third-party systems

For most merchants, exporting reviews via CSV may be the simpler option. The API is mainly intended for developers building automated integrations.