API

The GoodRevyu API

Embed reply generation and review management right into your tools.

A clean, versioned, documented REST API. Authenticate with an API key, generate replies, fetch your reviews, receive signed webhooks on every event.

What you can do

Generate a reply

Send a review's text, get an AI-written, moderated reply ready to publish.

List and reply to reviews

Fetch your reviews, trigger a reply, publish it on the source platform.

Track your usage

Check your AI reply and API call consumption in real time.

Receive webhooks

Get notified on every new review or sent reply, with a verifiable HMAC signature.

Example: generate a reply

Authentication

Every request carries your API key in the Authorization header. Keys have limited scopes and are shown only once.

The API is included in the Pro and Agency plans.

request

curl -X POST https://app.goodrevyu.com/api/v1/generate \
  -H "Authorization: Bearer rw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Great welcome, I will be back!",
    "rating": 5,
    "tone": "warm"
  }'

200 OK

{
  "data": {
    "reply": "Thank you so much for your visit! We look forward to seeing you again very soon.",
    "lang": "en",
    "sentiment": "positive",
    "safe": true,
    "model": "claude-sonnet-4-6"
  }
}

Main endpoints

GET /api/v1/reviews List your reviews

POST /api/v1/reviews/:id/reply Generate (and publish) a reply

POST /api/v1/generate Generate a reply from text

GET /api/v1/usage Check your usage