Pro

Ranqa API

Send review invites after delivery or purchase. Use verifiedPurchase only when there is a documented customer relationship.

Authentication

Create a key in the dashboard and send it as a Bearer token. Keys start with rnq_.

Authorization: Bearer rnq_…

Manage API keys →

Create invites

Send one or more recipients. Set sendEmail to false if you deliver the link yourself.

POST https://ranqa.vercel.app/api/v1/invites
Content-Type: application/json
Authorization: Bearer rnq_…

{
  "recipients": [
    {
      "email": "customer@example.com",
      "orderId": "ORD-123",
      "verifiedPurchase": true
    }
  ],
  "sendEmail": true
}

verifiedPurchase: true applies the Verified customer badge. Misuse may lead to key revocation.

Organization

GET https://ranqa.vercel.app/api/v1/organization
Authorization: Bearer rnq_…

Webhooks

POST https://ranqa.vercel.app/api/organizations/webhooks
Content-Type: application/json

{
  "organizationId": "…",
  "url": "https://your.app/webhooks/ranqa",
  "events": ["review.created", "review.flagged", "invite.completed"]
}

Each delivery includes X-Ranqa-Signature: HMAC-SHA256 of the raw JSON body with your secret.

Manage webhooks →

Invite a clear share of customers. Ranqa shows publicly how many reviews come from invites.

How badges work →