API

Community-Monitor-API

Mentions, Reviews und Discussion-Threads über deine Marke abfragen und filtern.

Der Community Monitor crawlt öffentliche Plattformen (Reddit, Hacker News, Twitter/X, Quora, Trustpilot, YouTube-Kommentare etc.) nach Mentions deiner Marke oder definierter Keywords. Die API liefert die Roh-Mentions plus aggregierte Alerts — perfekt um Reputation-Dashboards oder Slack-Bots an Rankion anzubinden.

Modul-Kontext: Community Monitor.

Mentions

Eine Mention ist eine einzelne Fundstelle: Plattform, Autor, Text-Auszug, Sentiment, Permalink.

Method	Endpoint	Beschreibung	Credits
GET	`/v1/community/mentions`	Liste aller Mentions, paginiert	—
GET	`/v1/community/mentions/{id}`	Detail einer Mention	—

Filter (Query-Parameter):

?platform=reddit|hackernews|twitter|trustpilot|quora|youtube
?sentiment=positive|neutral|negative
?keyword=<string> (Text-Match auf Mention-Body)
?from=YYYY-MM-DD&to=YYYY-MM-DD
?page=1&per_page=25

curl "$BASE/community/mentions?platform=reddit&sentiment=negative&from=2026-04-01" \
  -H "Authorization: Bearer $TOKEN" | jq '.data[] | {id, platform, sentiment, url, snippet}'

Response (gekürzt):

{
  "data": [
    {
      "id": 451,
      "platform": "reddit",
      "author": "u/foo",
      "snippet": "I tried Rankion and the GEO scoring was…",
      "sentiment": "negative",
      "score": -0.42,
      "url": "https://reddit.com/r/seo/comments/…",
      "discovered_at": "2026-04-28T14:21:00Z"
    }
  ],
  "meta": {"current_page": 1, "per_page": 25, "total": 138}
}

Scan dispatchen

Ein Scan triggert einen sofortigen Crawl-Run für ein bestimmtes Keyword über ausgewählte Plattformen — unabhängig vom Auto-Schedule.

Method	Endpoint	Body	Credits
POST	`/v1/community/scan`	`{keyword, platforms[]}`	5

curl -X POST "$BASE/community/scan" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{
    "keyword": "rankion ai",
    "platforms": ["reddit", "hackernews", "trustpilot"]
  }'

Antwort 202 Accepted:

{
  "scan_id": 77,
  "status": "queued",
  "message": "Community scan dispatched"
}

Der Scan läuft im Hintergrund. Neu gefundene Mentions tauchen in der Liste auf, sobald der Job durchläuft (typisch 30–120 s je nach Plattform-Anzahl).

Alerts

Alerts sind aggregierte Signale: Häufungen negativer Mentions, Sentiment-Drops, Review-Score-Einbrüche. Wirft das System pro Tag/Woche zusammen.

Method	Endpoint	Beschreibung	Credits
GET	`/v1/community/alerts`	Aktive + historische Alerts	—

curl "$BASE/community/alerts" -H "Authorization: Bearer $TOKEN" \
  | jq '.data[] | {id, type, severity, message, triggered_at, mentions_count}'

Typische type-Werte:

sentiment_drop — Sentiment-Average ist > 1 SD unter Baseline
negative_burst — Auffällig viele Negativ-Mentions in kurzem Zeitfenster
review_alert — externe Review-Sources melden Score-Einbruch (siehe Review-Sources-API)

Hinweise

Mentions werden dedupliziert über (platform, external_id) — derselbe Reddit-Kommentar wird nie zweimal gespeichert, auch wenn mehrere Scans laufen.
Sentiment ist heuristisch (Modell-basiert). Für rechtliche/Compliance-Zwecke immer Original-URL prüfen, nicht das Score-Label.
Auto-Crawls laufen im Hintergrund (mehrmals täglich) — der manuelle POST /scan ist nur für Ad-hoc-Pulls. Ohne Scan-Call füllt sich die Mention-Liste trotzdem.
Plattform-Verfügbarkeit ändert sich. Twitter/X-Crawl hängt am API-Status — bei Ausfall liefert ein gezielter POST /scan mit platforms:["twitter"] einen 503 oder leeres Resultat.
Public-Webhook-Pattern für Mentions ist (noch) nicht öffentlich exponiert — wenn du Echtzeit-Push brauchst, polle /community/alerts minütlich.

Verwandt: Review-Sources-API · Community Monitor.

Letzte Aktualisierung: 1. Mai 2026