Referência da APIGET

Contar menções

Conta menções do Reddit, Hacker News, X e Bluesky que correspondem aos mesmos filtros do endpoint de listagem.

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

Conta menções do Reddit, Hacker News, X e Bluesky que correspondem aos mesmos filtros do endpoint de listagem.

Token Bearer (token de API do RedReplier)

Autenticação

Envie um token de API do RedReplier como Bearer token em cada requisição. Os tokens começam com redreplier_; o RedReplier resolve a conta a partir do token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parâmetros

  • same filters as GET /mentions (consulta, opcional): Aceita websiteId, statuses, scoreBuckets, includeLowRelevance, keywords, sources, sort, from e to. limit e offset podem passar pela validação, mas não afetam a contagem.

Corpo da requisição

Este endpoint não exige um corpo JSON.

Resposta

Retorna o número total de menções correspondentes.

  • total (number): Total de menções correspondentes.

Exemplo de requisição

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

Notas

Use para paginação ou painéis sem carregar linhas de menções.

Erros

  • 400 Bad Request: Entrada, URL, UUID, enum, parâmetro de consulta ou corpo inválido.
  • 401 Unauthorized: Bearer token ausente ou inválido.
  • 404 Not Found: O recurso não existe para a conta do token.
  • 500 Internal Server Error: Erro inesperado do servidor.
Exemplo de solicitação (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
}