Review Infra Docs
Get API Key →
Review Infra Docs
Reviews for Shopify and headless stores.
Install widget → send orders → collect reviews automatically.
1. Install widget
<script
  src="https://review-infra-api-production.up.railway.app/embed/widget.js?storeId=YOUR_STORE_ID">
</script>
Use this for Shopify or custom/headless storefronts.
2. Send orders
POST https://review-infra-api-production.up.railway.app/orders
{
  "storeId": "YOUR_STORE_ID",
  "customerEmail": "customer@example.com",
  "customerName": "Customer Name",
  "productId": "YOUR_PRODUCT_ID",
  "orderRef": "ORDER-1001",
  "externalOrderId": "external-1001"
}
This is the main automation trigger. Orders queue review requests.
3. Submit reviews manually
POST https://review-infra-api-production.up.railway.app/public-reviews/submit
{
  "apiKey": "YOUR_API_KEY",
  "productId": "YOUR_PRODUCT_ID",
  "rating": 5,
  "title": "Amazing",
  "text": "Loved it",
  "authorName": "Customer",
  "authorEmail": "customer@example.com"
}
Optional fallback for manual review submission.
4. Review flow
Order created
  ↓
Review nudge queued
  ↓
Email sent
  ↓
Customer submits review
  ↓
Moderation
  ↓
Approved → widget
This is the full system flow.
5. SDK
pnpm add @review-infra/sdk

import { ReviewInfraClient } from '@review-infra/sdk';

const client = new ReviewInfraClient({
  apiBaseUrl: 'https://review-infra-api-production.up.railway.app',
  apiKey: 'YOUR_API_KEY',
});

const data = await client.getReviews({
  productId: 'prod_1',
});
Use the SDK when you want programmatic access.
6. Core endpoints
POST   /orders
POST   /public-reviews/submit
GET    /reviews/:productId
GET    /review-nudges
POST   /review-nudges/send
GET    /tracking/nudge/open/:id
GET    /tracking/nudge/click/:id
These are the main endpoints developers need first.