Referencia de APIGET

Listar menciones

Lista menciones de Reddit, Hacker News, X y Bluesky puntuadas por IA con filtros y paginación.

GEThttps://ai.redreplier.com/ai-app/api/v1/mentions

Lista menciones de Reddit, Hacker News, X y Bluesky puntuadas por IA con filtros y paginación.

Token Bearer (token de API de RedReplier)

Autenticación

Envía un token de API de RedReplier como Bearer token en cada solicitud. Los tokens empiezan por redreplier_; RedReplier resuelve la cuenta desde el token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

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 con puntuación inferior a 30.
  • 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.
  • 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 o HACKERNEWS.
  • keyword (string | null): Valor de palabra clave que coincidió.
  • title, contentText, url, author, subreddit (string | null): Contexto de título, cuerpo y enlace. subreddit solo se rellena para fuentes de Reddit y es null para X, Bluesky y Hacker News.
  • 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.
  • 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.

Solicitud de ejemplo

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'

Notas

Por defecto se excluyen menciones REJECTED y se ocultan menciones con puntuación inferior a 30. 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.
  • 404 Not Found: El recurso no existe para la cuenta del token.
  • 500 Internal Server Error: Error inesperado del servidor.
Solicitud de ejemplo (curl)
curl --request GET \
  --url https://ai.redreplier.com/ai-app/api/v1/mentions?websiteId=9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10&statuses=NEW&sort=RELEVANCE&limit=25 \
  --header 'Authorization: Bearer redreplier_test_1234567890'
200
{
  "mentions": [
    {
      "id": "6a9f0e8b-2c65-44f7-b6e6-7f88a7df8301",
      "websiteId": "9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10",
      "source": "REDDIT_POST",
      "keyword": "agency CRM",
      "title": "Best CRM for a small agency?",
      "contentText": "We need a lightweight CRM for client follow-ups and deal tracking.",
      "url": "https://reddit.com/r/sales/comments/example/best_crm_for_a_small_agency",
      "author": "agency_ops",
      "subreddit": "sales",
      "status": "NEW",
      "relevanceScore": 86,
      "relevanceReason": "The thread asks for an agency CRM, which directly matches the monitored product category.",
      "tags": ["recommendation-request", "high-intent"],
      "publishedAt": "2026-05-29T09:20:00.000Z",
      "ingestedAt": "2026-05-29T09:24:12.000Z",
      "reviewedAt": null,
      "createdAt": "2026-05-29T09:24:12.000Z",
      "updatedAt": "2026-05-29T09:24:12.000Z"
    }
  ],
  "total": 1,
  "limit": 25,
  "offset": 0
}