Lister les mentions

Paramètres

• websiteId (requête, UUID, facultatif): Filtre sur un seul site web.
• statuses (requête, répétable, facultatif): Statuts de mention: NEW, APPROVED, REJECTED.
• scoreBuckets (requête, répétable, facultatif): Buckets de pertinence: VERY_LOW, LOW, MEDIUM, HIGH, VERY_HIGH.
• includeLowRelevance (requête, booléen, facultatif): Inclut les mentions sous le score minimum du site web (30 par défaut).
• minScore (requête, entier, facultatif, 0-100): Uniquement les mentions dont le score atteint au moins cette valeur. Les mentions sans score sont exclues. Le score minimum du site web s'applique toujours, sauf si includeLowRelevance vaut true.
• keywords (requête, répétable, facultatif): Filtre par valeurs de mot-clé.
• sources (requête, répétable, facultatif): Sources de mention: REDDIT_POST, REDDIT_COMMENT, TWITTER (X), BLUESKY, HACKERNEWS, FACEBOOK, FACEBOOK_GROUP.
• sort (requête, facultatif): Tri: RELEVANCE ou RECENT.
• from, to (requête, string ISO, facultatif): Plage de dates d’ingestion.
• limit (requête, entier, facultatif, 1-500, défaut 50): Taille de page.
• offset (requête, entier, facultatif, min 0, défaut 0): Décalage de pagination.

Corps de la requête

Cet endpoint ne nécessite aucun corps JSON.

Réponse

Renvoie des objets Mention publics paginés.

• mentions (Mention[]): Mentions de la page actuelle.
• total (number): Nombre total de mentions correspondantes.
• limit (number): Taille de page utilisée par la réponse.
• offset (number): Décalage de pagination utilisé par la réponse.

Objet Mention

• id (string): UUID de la mention.
• websiteId (string | null): UUID du site web.
• source (string): REDDIT_POST, REDDIT_COMMENT, TWITTER (X), BLUESKY, HACKERNEWS, FACEBOOK ou FACEBOOK_GROUP.
• keyword (string | null): Valeur de mot-clé qui a correspondu.
• title, contentText, url, author, subreddit (string | null): Contexte du titre, du contenu et du lien. subreddit contient le subreddit pour les sources Reddit et l'id du groupe pour FACEBOOK_GROUP, et vaut null pour les autres sources.
• status (string): NEW, APPROVED ou REJECTED.
• relevanceScore (number | null): Score de pertinence IA de 0 à 100, ou null.
• relevanceReason (string | null): Explication IA de la correspondance, ou null.
• aiReplySuggestion (string | null): Réponse rédigée par IA, à relire avant publication, ou null.
• tags (string[]): Tags de pertinence générés par IA.
• publishedAt, ingestedAt, reviewedAt, createdAt, updatedAt (ISO string | null): Horodatages de publication, d’ingestion, de revue, de création et de mise à jour au format ISO 8601, ou null.

Notes

Par défaut, les mentions REJECTED sont exclues et les mentions sous le score minimum du site web (30 par défaut) sont masquées. minScore filtre davantage et n'abaisse jamais ce seuil à lui seul. Buckets: VERY_LOW <10, LOW 10-29, MEDIUM 30-49, HIGH 50-74, VERY_HIGH >=75.

Erreurs

• 400 Bad Request: Entrée, URL, UUID, enum, paramètre de requête ou corps non valide.
• 401 Unauthorized: Bearer token manquant ou non valide, ou code: "token_issuer_lost_access" quand la personne qui a créé la clé API a été désactivée ou a quitté l'espace de travail.
• 403 Forbidden: code: "subscription_required" quand l'abonnement de l'espace de travail n'inclut pas l'accès à l'API, code: "workspace_access_denied" quand X-Workspace-Id désigne un espace de travail que ces identifiants ne peuvent pas atteindre, ou code: "permission_denied" quand votre rôle dans l'espace de travail n'a pas la permission redreplier.write (Admin et Editor l'ont).
• 404 Not Found: La ressource n’existe pas pour le compte du token.
• 429 Too Many Requests: Limite de débit dépassée. Attendez le nombre de secondes indiqué dans Retry-After.
• 500 Internal Server Error: Erreur serveur inattendue.