Referencia de APIGET

Contar menciones

Cuenta menciones de Reddit, Hacker News, X, Bluesky y Facebook que coinciden con los mismos filtros del endpoint de listado.

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

Cuenta menciones de Reddit, Hacker News, X, Bluesky y Facebook que coinciden con los mismos filtros del endpoint de listado.

Token Bearer (token de API de RedReplier)

Parámetros

  • same filters as GET /mentions (consulta, opcional): Acepta websiteId, statuses, scoreBuckets, includeLowRelevance, minScore, keywords, sources, sort, from y to. limit y offset pueden pasar la validación, pero no afectan el recuento.

Cuerpo de la solicitud

Este endpoint no requiere un cuerpo JSON.

Respuesta

Devuelve el número total de menciones coincidentes.

  • total (number): Total de menciones coincidentes.

Notas

Úsalo para paginación o paneles sin cargar filas de menciones.

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.
Solicitud de ejemplo (curl)
curl --request GET \
  --url https://ai.redreplier.com/ai-app/api/v1/mentions/count?websiteId=9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10&statuses=NEW \
  --header 'Authorization: Bearer redreplier_test_1234567890'
200
{
  "total": 14
}