Review Sources

Review Sources ist Rankions Inventar aller externen Bewertungsplattformen, die deine Marke beeinflussen — Google Business, Trustpilot, Yelp, Trusted Shops, ProvenExpert, ähnliche. Jede Quelle wird per Webhook an Rankion angebunden und liefert eingehende Bewertungen, Sterne-Schnitte und Volumen direkt in deine Plattform. Daraus lassen sich Citations für AI-Visibility-Tracking ableiten, schwächelnde Quellen identifizieren und neue Plattformen über die Waitlist nominieren. Die Authentifizierung läuft pro Quelle über einen rotierbaren API-Key, alle Endpoints sind team-scoped.

Was es kann

• Quellen verbinden — pro Plattform eine Source anlegen, die Webhook-URL plus Secret-Key generieren und beim Provider hinterlegen.
• Webhook-Empfang — POST /webhooks/reviews/{source} ist public (key-auth) und nimmt eingehende Reviews entgegen, parsed Sterne, Author, Body, Datum.
• Key-Rotation — Secret kompromittiert? rotate-key zieht ohne Verlust den alten Key zurück und liefert einen neuen.
• Disconnect / Reconnect — pausiert die Quelle ohne sie zu löschen (z.B. bei temporären Provider-Outages).
• Waitlist — Plattform fehlt? waitlist registriert deinen Wunsch — wird priorisiert für die nächste Roadmap-Runde.
• Citation-Feed — Reviews aus diesen Quellen können von Community Monitor und AI-Visibility Tracking als Citation-Signale referenziert werden.

Wann nutzen

• Du willst alle Bewertungsplattformen, auf denen deine Marke gelistet ist, an einer Stelle verwalten.
• Du nutzt AI-Visibility-Tracking und willst sehen, welche Review-Quellen tatsächlich von ChatGPT, Perplexity & Co. zitiert werden.
• Du willst rotieren / disconnecten ohne über das Provider-Dashboard zu gehen.
• Du brauchst eine Source, die Rankion noch nicht supported — Waitlist ist dein Hebel.

Workflow

1. Source anlegen — POST /review-sources/webhook mit {source: "trustpilot"|"google"|...} legt einen neuen Eintrag inkl. Webhook-Secret an.
2. Webhook beim Provider hinterlegen — die Response liefert webhook_url und secret. Beim Provider eintragen.
3. Reviews fließen — Provider posted an /webhooks/reviews/{source}. Rankion validiert per Secret, speichert die Review, normalisiert Sterne 1–5.
4. Status prüfen — GET /review-sources/{id} zeigt Reviews-Count, letzten Webhook-Hit, durchschnittliche Sterne.
5. Bei Verdacht rotieren — POST /review-sources/{id}/rotate-key → neuer Secret, alter sofort ungültig.
6. Pausieren / fortsetzen — disconnect setzt Status auf paused, reconnect aktiviert wieder.

API

Beispiel — Source anlegen.

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

• Verbindung & Verwaltung: kostenfrei. Webhook-Receive ist kostenfrei.
• Citation-Korrelation mit AI-Visibility läuft im Tracking-Run, dort werden Credits gezählt — nicht hier.
• Rate-Limit Webhook-Receive: typischerweise 10 req/sec pro Source. Bei Burst werden Events gequeued.
• Cross-Team-Isolation: Sources sind team-scoped, ein anderes Team sieht deine Reviews nicht.

Verwandte Module

• Community Monitor — externe Erwähnungen + Reviews als kombinierter Brand-Mention-Feed.
• AI-Visibility Tracking — nutzt Review-Citations als Trust-Signal für AVI-Score.
• Google Integrationen — Google-Reviews-Status als Indikator für die Google-Review-Anbindung.