Lister les mentions

Authentification

Envoyez un token API RedReplier comme Bearer token à chaque requête. Les tokens commencent par redreplier_; RedReplier résout le compte depuis le token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

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 avec un score inférieur à 30.
• 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.
• 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 ou HACKERNEWS.
• 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 n’est renseigné que pour les sources Reddit et vaut null pour X, Bluesky et Hacker News.
• 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.
• 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.

Exemple de requête

curl -s 'https://ai.redreplier.com/ai-app/api/v1/mentions?statuses=NEW&scoreBuckets=HIGH&scoreBuckets=VERY_HIGH&sort=RECENT&limit=20' \
  -H 'Authorization: Bearer redreplier_test_1234567890'

Notes

Par défaut, les mentions REJECTED sont exclues et les mentions sous le score 30 sont masquées. 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.
• 404 Not Found: La ressource n’existe pas pour le compte du token.
• 500 Internal Server Error: Erreur serveur inattendue.