Reviuly logoReviuly
Home

API Reference

Reviuly exposes a set of public API endpoints for retrieving testimonials and form data. These are used internally by the embed widget and wall page — and you can use them in your own apps too.

Public endpoints only

The public API is read-only and does not require authentication. Private endpoints (creating testimonials, updating settings) are managed through the dashboard.

Base URL

https://reviuly.com/api/public

CORS

All public endpoints have CORS enabled and can be called from any domain. No special headers required.

Endpoints

GET/api/public/f/[form-slug]

Get form info

Returns basic form data and the associated user's public info.

Response

{
  "form": {
    "id": "uuid",
    "slug": "my-form",
    "name": "My Collection Form",
    "title": "...",
    "description": "..."
  },
  "user": {
    "business_name": "Acme Inc.",
    ...
  }
}
GET/api/public/f/[form-slug]/testimonials

Get testimonials for a form

Returns approved testimonials with the embed flag enabled. Used by the JS widget. Limited to 50 results.

Response

{
  "testimonials": [
    {
      "id": "uuid",
      "reviewer_name": "Jane Doe",
      "reviewer_role": "CEO, Startup",
      "reviewer_photo_url": null,
      "rating": 5,
      "text": "Amazing product!",
      "created_at": "2026-01-01T00:00:00Z"
    }
    ...
  ]
}

Rate limiting

The testimonial submission endpoint (used by the public form) is rate-limited to prevent spam. The public read endpoints are not rate-limited but should be used responsibly.

Full REST API (coming soon)

A full authenticated REST API for programmatic access to your testimonials, forms, and analytics is planned. This will enable automation, webhooks, and third-party integrations.

If you have a specific API use case, reach out at harshkumar88629@gmail.com