Review Sources

Review Sources is Rankion's inventory of all external review platforms that influence your brand — Google Business, Trustpilot, Yelp, Trusted Shops, ProvenExpert, and similar. Each source is connected to Rankion via webhook and delivers incoming reviews, star averages, and volume directly into your platform. From there, you can derive citations for AI Visibility Tracking, identify weak sources, and nominate new platforms via the waitlist. Authentication runs per source through a rotatable API key; all endpoints are team-scoped.

What it can do

• Connect sources — create a source per platform, generate the webhook URL plus secret key, and register it with the provider.
• Webhook receive — POST /webhooks/reviews/{source} is public (key auth) and accepts incoming reviews, parses stars, author, body, date.
• Key rotation — secret compromised? rotate-key retires the old key without loss and issues a new one.
• Disconnect / reconnect — pause the source without deleting it (e.g. during temporary provider outages).
• Waitlist — platform missing? waitlist registers your request — prioritized for the next roadmap round.
• Citation feed — reviews from these sources can be referenced as citation signals by Community Monitor and AI Visibility Tracking.

When to use

• You want every review platform that lists your brand managed in one place.
• You use AI Visibility Tracking and want to see which review sources actually get cited by ChatGPT, Perplexity & co.
• You want to rotate / disconnect without going through the provider dashboard.
• You need a source Rankion doesn't yet support — the waitlist is your lever.

Workflow

1. Create source — POST /review-sources/webhook with {source: "trustpilot"|"google"|...} creates a new entry incl. webhook secret.
2. Register webhook with the provider — the response returns webhook_url and secret. Configure those in the provider.
3. Reviews flow in — the provider posts to /webhooks/reviews/{source}. Rankion validates by secret, stores the review, normalizes stars 1–5.
4. Check status — GET /review-sources/{id} shows reviews count, last webhook hit, average stars.
5. Rotate on suspicion — POST /review-sources/{id}/rotate-key → new secret, old one immediately invalid.
6. Pause / resume — disconnect sets status to paused, reconnect re-activates.

API

Example — create source.

curl -X POST $BASE/review-sources/webhook \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"source":"trustpilot"}'

Response.

{
  "id": 7,
  "source": "trustpilot",
  "webhook_url": "https://rankion.ai/api/v1/webhooks/reviews/trustpilot",
  "secret": "rs_live_...",
  "status": "active"
}

Credits & Limits

• Connection & management: free. Webhook receive is free.
• Citation correlation with AI Visibility runs in the tracking run, where credits are billed — not here.
• Webhook receive rate limit: typically 10 req/sec per source. On burst, events are queued.
• Cross-team isolation: sources are team-scoped, another team doesn't see your reviews.

Related modules

• Community Monitor — external mentions + reviews as a combined brand-mention feed.
• AI Visibility Tracking — uses review citations as a trust signal for the AVI score.
• Google Integrations — Google Reviews status as an indicator for the Google reviews connection.