Referencia de APIGET

Contar menciones

Cuenta menciones de Reddit, Hacker News, X y Bluesky 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 y Bluesky que coinciden con los mismos filtros del endpoint de listado.

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

  • same filters as GET /mentions (consulta, opcional): Acepta websiteId, statuses, scoreBuckets, includeLowRelevance, 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.

Solicitud de ejemplo

curl -s 'https://ai.redreplier.com/ai-app/api/v1/mentions/count?statuses=NEW' \
  -H 'Authorization: Bearer redreplier_test_1234567890'

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.
  • 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/count?websiteId=9b0f2b8d-4a76-4f59-9f0b-6b4b6f6c2a10&statuses=NEW \
  --header 'Authorization: Bearer redreplier_test_1234567890'
200
{
  "total": 14
}