Listar menciones

Parámetros

• websiteId (consulta, UUID, opcional): Filtra a un solo sitio web.
• statuses (consulta, repetible, opcional): Estados de mención: NEW, APPROVED, REJECTED.
• scoreBuckets (consulta, repetible, opcional): Rangos de relevancia: VERY_LOW, LOW, MEDIUM, HIGH, VERY_HIGH.
• includeLowRelevance (consulta, booleano, opcional): Incluye menciones por debajo de la puntuación mínima del sitio web (30 por defecto).
• minScore (consulta, entero, opcional, 0-100): Solo menciones con al menos esta puntuación. Las menciones sin puntuación quedan fuera. La puntuación mínima del sitio web sigue aplicándose salvo que includeLowRelevance sea true.
• keywords (consulta, repetible, opcional): Filtra por valores de palabra clave.
• sources (consulta, repetible, opcional): Fuentes de mención: REDDIT_POST, REDDIT_COMMENT, TWITTER (X), BLUESKY, HACKERNEWS, FACEBOOK, FACEBOOK_GROUP.
• sort (consulta, opcional): Orden: RELEVANCE o RECENT.
• from, to (consulta, string ISO, opcional): Rango de fechas de ingesta.
• limit (consulta, entero, opcional, 1-500, predeterminado 50): Tamaño de página.
• offset (consulta, entero, opcional, mínimo 0, predeterminado 0): Desplazamiento de paginación.

Cuerpo de la solicitud

Este endpoint no requiere un cuerpo JSON.

Respuesta

Devuelve objetos Mention públicos paginados.

• mentions (Mention[]): Menciones de la página actual.
• total (number): Total de menciones coincidentes.
• limit (number): Tamaño de página usado por la respuesta.
• offset (number): Desplazamiento de paginación usado por la respuesta.

Objeto Mention

• id (string): UUID de la mención.
• websiteId (string | null): UUID del sitio web.
• source (string): REDDIT_POST, REDDIT_COMMENT, TWITTER (X), BLUESKY, HACKERNEWS, FACEBOOK o FACEBOOK_GROUP.
• keyword (string | null): Valor de palabra clave que coincidió.
• title, contentText, url, author, subreddit (string | null): Contexto de título, cuerpo y enlace. subreddit contiene el subreddit en fuentes de Reddit y el id del grupo en FACEBOOK_GROUP, y es null en las demás fuentes.
• status (string): NEW, APPROVED o REJECTED.
• relevanceScore (number | null): Puntuación de relevancia de IA de 0 a 100, o null.
• relevanceReason (string | null): Explicación de IA de la coincidencia, o null.
• aiReplySuggestion (string | null): Respuesta redactada por IA para que una persona la revise antes de publicarla, o null.
• tags (string[]): Etiquetas de relevancia generadas por IA.
• publishedAt, ingestedAt, reviewedAt, createdAt, updatedAt (ISO string | null): Marcas de publicación, ingesta, revisión, creación y actualización en formato ISO 8601, o null.

Notas

Por defecto se excluyen menciones REJECTED y se ocultan menciones por debajo de la puntuación mínima del sitio web (30 por defecto). minScore filtra más y nunca baja ese umbral por sí solo. Rangos: VERY_LOW <10, LOW 10-29, MEDIUM 30-49, HIGH 50-74, VERY_HIGH >=75.

Errores

• 400 Bad Request: Entrada, URL, UUID, enum, parámetro de consulta o cuerpo no válido.
• 401 Unauthorized: Bearer token ausente o no válido, o code: "token_issuer_lost_access" cuando la persona que creó la clave API fue desactivada o salió del workspace.
• 403 Forbidden: code: "subscription_required" cuando el plan del workspace no incluye acceso a la API, code: "workspace_access_denied" cuando X-Workspace-Id indica un workspace al que esta credencial no puede acceder, o code: "permission_denied" cuando tu rol en el workspace no tiene el permiso redreplier.write (lo tienen Admin y Editor).
• 404 Not Found: El recurso no existe para la cuenta del token.
• 429 Too Many Requests: Límite de solicitudes superado. Espera los segundos indicados en Retry-After.
• 500 Internal Server Error: Error inesperado del servidor.