Community-Monitor-API

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.

rankion.aiMentions

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

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}
}

rankion.aiScan dispatchen

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

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).

rankion.aiAlerts

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

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)

rankion.aiHinweise

• 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.