← Back to home

Review Reacher API

Programmatically add customers, pull reviews, and read analytics. Available on the Agency plan.

Authentication

All requests require a Bearer token in the Authorization header. Generate a key from API keys.

curl https://api.reviewreacher.com/v1/customers \
  -H "Authorization: Bearer rr_live_xxxxxxxxxxxxxxxx"

Base URL

https://reviewreacher.com/api/public/v1
POST/customers

Create a customer and (optionally) enroll them in your review sequence.

Request
curl -X POST https://reviewreacher.com/api/public/v1/customers \
  -H "Authorization: Bearer rr_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Sarah",
    "email": "sarah@example.com",
    "visited": true
  }'
Response
{ "id": "uuid", "status": "active", "sequences_scheduled": 3 }
GET/reviews

List captured reviews for your business. Supports ?since=ISO_DATE and ?limit=100.

Request
curl "https://reviewreacher.com/api/public/v1/reviews?limit=50" \
  -H "Authorization: Bearer rr_live_..."
Response
{
  "reviews": [
    { "id": "uuid", "rating": 5, "author_name": "Sarah", "body": "…", "posted_at": "…" }
  ]
}
GET/analytics/summary

Snapshot of KPIs: sent count, open rate, click rate, avg rating.

Request
curl "https://reviewreacher.com/api/public/v1/analytics/summary?days=30" \
  -H "Authorization: Bearer rr_live_..."
Response
{
  "sent": 342, "open_rate": 0.62, "click_rate": 0.18,
  "reviews_captured": 47, "avg_rating": 4.6
}

Rate limits

60 requests per minute per API key. Responses include X-RateLimit-Remaining.