Mentions auflisten

Parameter

• websiteId (Query, UUID, optional): Filtert auf eine Website.
• statuses (Query, wiederholbar, optional): Mention-Statuswerte: NEW, APPROVED, REJECTED.
• scoreBuckets (Query, wiederholbar, optional): Relevanz-Buckets: VERY_LOW, LOW, MEDIUM, HIGH, VERY_HIGH.
• includeLowRelevance (Query, Boolean, optional): Schließt Mentions unter dem Mindestscore der Website ein (standardmäßig 30).
• minScore (Query, Integer, optional, 0-100): Nur Mentions mit mindestens diesem Score. Mentions ohne Score fallen weg. Der Mindestscore der Website gilt weiterhin, außer includeLowRelevance ist true.
• keywords (Query, wiederholbar, optional): Filtert nach Keyword-Werten.
• sources (Query, wiederholbar, optional): Mention-Quellen: REDDIT_POST, REDDIT_COMMENT, TWITTER (X), BLUESKY, HACKERNEWS, FACEBOOK, FACEBOOK_GROUP.
• sort (Query, optional): Sortierung: RELEVANCE oder RECENT.
• from, to (Query, ISO-String, optional): Ingestion-Zeitraum.
• limit (Query, Integer, optional, 1-500, Standard 50): Seitengröße.
• offset (Query, Integer, optional, min. 0, Standard 0): Pagination-Offset.

Request-Body

Dieser Endpoint benötigt keinen JSON-Body.

Antwort

Gibt paginierte öffentliche Mention-Objekte zurück.

• mentions (Mention[]): Mentions auf der aktuellen Seite.
• total (number): Gesamtzahl passender Mentions.
• limit (number): Von der Antwort verwendete Seitengröße.
• offset (number): Von der Antwort verwendeter Pagination-Offset.

Mention-Objekt

• id (string): Mention-UUID.
• websiteId (string | null): Website-UUID.
• source (string): REDDIT_POST, REDDIT_COMMENT, TWITTER (X), BLUESKY, HACKERNEWS, FACEBOOK oder FACEBOOK_GROUP.
• keyword (string | null): Keyword-Wert, der gepasst hat.
• title, contentText, url, author, subreddit (string | null): Kontext für Titel, Inhalt und Link. subreddit enthält den Subreddit für Reddit-Quellen und die Gruppen-ID für FACEBOOK_GROUP und ist für die anderen Quellen null.
• status (string): NEW, APPROVED oder REJECTED.
• relevanceScore (number | null): KI-Relevanzscore von 0 bis 100 oder null.
• relevanceReason (string | null): KI-Erklärung für den Treffer oder null.
• aiReplySuggestion (string | null): KI-Entwurf einer Antwort, den eine Person vor dem Posten prüft, oder null.
• tags (string[]): KI-generierte Relevanz-Tags.
• publishedAt, ingestedAt, reviewedAt, createdAt, updatedAt (ISO string | null): Zeitpunkte für Veröffentlichung, Ingestion, Review, Erstellung und Aktualisierung im ISO-8601-Format oder null.

Hinweise

Standardmäßig werden REJECTED Mentions ausgeschlossen und Mentions unter dem Mindestscore der Website (standardmäßig 30) ausgeblendet. minScore filtert zusätzlich und senkt diese Schwelle nie allein. Buckets: VERY_LOW <10, LOW 10-29, MEDIUM 30-49, HIGH 50-74, VERY_HIGH >=75.

Fehler

• 400 Bad Request: Ungültige Eingabe, URL, UUID, Enum, Query-Parameter oder Body.
• 401 Unauthorized: Fehlendes oder ungültiges Bearer-Token, oder code: "token_issuer_lost_access", wenn die Person, die den API-Schlüssel erstellt hat, deaktiviert wurde oder den Workspace verlassen hat.
• 403 Forbidden: code: "subscription_required", wenn der Tarif des Workspace keinen API-Zugang enthält, code: "workspace_access_denied", wenn X-Workspace-Id einen Workspace nennt, den diese Zugangsdaten nicht erreichen, oder code: "permission_denied", wenn Ihre Rolle im Workspace die Berechtigung redreplier.write nicht hat (Admin und Editor haben sie).
• 404 Not Found: Die Ressource existiert nicht für das Token-Konto.
• 429 Too Many Requests: Rate-Limit überschritten. Warten Sie die Sekunden aus Retry-After ab.
• 500 Internal Server Error: Unerwarteter Serverfehler.