Documentation

Merchant setup

Use the Theme Editor to add the Reviews widget and Featured reviews slider on product, home, or collection pages. All styling options are available inside block settings.

Storefront API endpoints

Base proxy path: /apps/purefeedback

Fetch reviews:

GET /apps/purefeedback/reviews
Query params:
- product_id (required unless featured=1)
- featured=1
- limit (default 10, max 50)
- offset
- sort=newest|highest|lowest
- withPhotos=1
- withVideos=1
- verified=1

Star rating summary (count + average):

GET /apps/purefeedback/reviews?product_id=gid://shopify/Product/123&limit=1
Response summary:
{
  "summary": { "count": 48, "averageRating": 4.6 }
}

Create review:

POST /apps/purefeedback/reviews/create
Content-Type: multipart/form-data
Fields:
- rating, title, content, email, orderNumber
- firstName, lastName, productId
- images (up to 3)
- video (optional, 1)

Fetch questions:

GET /apps/purefeedback/questions
Query params:
- product_id (required)
- limit (default 10, max 50)
- offset

Create question:

POST /apps/purefeedback/questions/create
Content-Type: application/x-www-form-urlencoded or multipart/form-data
Fields:
- productId
- question
- firstName (optional)
- lastName (optional)
- email (optional)

Helpful votes (verified purchase required):

POST /apps/purefeedback/reviews/helpful
Content-Type: application/json
Body:
{ reviewId, email, orderNumber }

Example request

fetch('/apps/purefeedback/reviews?product_id=gid://shopify/Product/123&limit=10&offset=0')
  .then((res) => res.json())
  .then((data) => console.log(data));

Need help?

Contact support at support@purefeedback.app