Erste Schritte mit der RedReplier API

Die RedReplier API verbindet externe Tools, Automationen und KI-Agenten mit deinem Mention-Monitoring über Reddit, Hacker News, X und Bluesky. Du kannst Websites erstellen, Keywords verwalten, KI-bewertete Mentions prüfen, Abrechnungsänderungen vorab prüfen und E-Mail-Alerts konfigurieren.

Basis-URL: https://ai.redreplier.com/ai-app/api/v1

Sende bei jeder Anfrage ein RedReplier-API-Token als Bearer-Token. Tokens beginnen mit redreplier_; RedReplier ermittelt das Konto aus dem Token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Das Konto wird aus dem API-Token abgeleitet. Übergib keine Account-, Organisations- oder Workspace-IDs. Starte mit Websites auflisten, um Website- und Keyword-IDs zu finden.

Zentrale Ressourcen:

• Website: Produkt, Domain oder Marke, die überwacht wird.
• Keyword: Phrase, die für eine Website mit Reddit, Hacker News, X und Bluesky abgeglichen wird.
• Mention: Gefundener Post oder Kommentar aus Reddit, Hacker News, X oder Bluesky mit relevanceScore von 0 bis 100.
• Alert settings: E-Mail-Kadenz für neue relevante Mentions.

Keyword-Statuswerte: PENDING, ACTIVE, DISABLED, SUSPENDED. Mention-Statuswerte: NEW, APPROVED, REJECTED.

REST-Endpoints

• GET Websites auflisten - /websites
• GET Website abrufen - /websites/{websiteId}
• POST Website erstellen - /websites
• PATCH Website aktualisieren - /websites/{websiteId}
• DELETE Website löschen - /websites/{websiteId}
• POST Website-Beschreibung analysieren - /websites/analyze-description
• POST Keywords hinzufügen - /websites/{websiteId}/keywords
• PATCH Keyword bearbeiten - /keywords/{keywordId}
• POST Keyword deaktivieren - /keywords/{keywordId}/disable
• POST Keyword aktivieren - /keywords/{keywordId}/enable
• DELETE Keyword löschen - /keywords/{keywordId}
• POST Ausstehende Keywords aktivieren - /keywords/activate-pending
• GET Aktivierung ausstehender Keywords vorab prüfen - /keywords/activate-pending/preview
• GET Keyword-Abrechnung vorab prüfen - /keywords/billing-preview
• GET Keyword-Edit-Nutzung - /keywords/change-usage
• GET Mentions auflisten - /mentions
• GET Mentions zählen - /mentions/count
• PATCH Mention-Status aktualisieren - /mentions/{mentionId}/status
• POST Mention erklären - /mentions/{mentionId}/explain
• GET Alert-Einstellungen abrufen - /alert-settings
• PUT Alert-Einstellungen aktualisieren - /alert-settings

Fehler

• 400 Bad Request: Ungültige Eingabe, URL, UUID, Enum, Query-Parameter oder Body.
• 401 Unauthorized: Fehlendes oder ungültiges Bearer-Token.
• 404 Not Found: Die Ressource existiert nicht für das Token-Konto.
• 500 Internal Server Error: Unerwarteter Serverfehler.