Reviews API

Manage reviews submitted through BetterReviews AI chat or imported from other platforms (Okendo, Judge.me, Yotpo).

List Reviews

GET /api/v1/reviews

Query Parameters

Param	Type	Description
status	string	pending, approved, rejected
min_rating	integer	Minimum rating (1-5)
max_rating	integer	Maximum rating (1-5)
product_id	string	Filter by product external ID
platform	string	betterreviews, okendo, judgeme, yotpo
is_verified	boolean	Verified buyers only
sort	string	newest, oldest, highest_rated, lowest_rated, most_helpful
limit	integer	Page size (default 20, max 100)
offset	integer	Pagination offset

Response (200)

{
  "reviews": [
    {
      "id": 789,
      "external_review_id": "abc-123",
      "platform": "betterreviews",
      "external_product_id": "shopify-7125386199075",
      "rating": 5,
      "title": "Amazing quality",
      "content": "I love this product, especially the fabric...",
      "reviewer_name": "Jane D.",
      "is_verified_buyer": true,
      "status": "pending",
      "sentiment": "positive",
      "helpful_votes": 3,
      "unhelpful_votes": 0,
      "review_created_at": "2026-03-27T10:00:00Z",
      "tags": ["quality", "fabric"]
    }
  ],
  "total": 42,
  "limit": 10,
  "offset": 0
}

---

Get Single Review

GET /api/v1/reviews/:id

Returns the same shape as a single review from the list.

---

Approve Review

PATCH /api/v1/reviews/:id/approve

Approves a pending review. It becomes visible on the storefront and triggers a Shopify metafield sync.

{"ok": true, "review_id": 789, "status": "approved"}

---

Reject Review

PATCH /api/v1/reviews/:id/reject

{"ok": true, "review_id": 789, "status": "rejected"}

---

Delete Review

DELETE /api/v1/reviews/:id

{"ok": true}

---

Review Statistics

GET /api/v1/reviews/stats

{
  "total_reviews": 307713,
  "pending_count": 12,
  "approved_count": 306000,
  "rejected_count": 1701,
  "average_rating": 4.3,
  "reviews_by_rating": {"1": 5000, "2": 10000, "3": 30000, "4": 80000, "5": 182713},
  "verified_reviews": 250000,
  "verified_percentage": 81.2,
  "total_helpful_votes": 15000,
  "reviews_last_30_days": 4500,
  "reviews_last_7_days": 1100,
  "latest_review_date": "2026-03-27T10:00:00Z"
}

---

Search Reviews

POST /api/v1/reviews/search

{"query": "fabric quality", "limit": 10}