Referência da APIGET

Contar menções

Conta menções do Reddit, Hacker News, X, Bluesky e Facebook 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, Bluesky e Facebook que correspondem aos mesmos filtros do endpoint de listagem.

Token Bearer (token de API do RedReplier)

Parâmetros

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

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, ou code: "token_issuer_lost_access" quando a pessoa que criou a chave API foi desativada ou saiu do workspace.
  • 403 Forbidden: code: "subscription_required" quando o plano do workspace não inclui acesso à API, code: "workspace_access_denied" quando X-Workspace-Id indica um workspace que esta credencial não pode alcançar, ou code: "permission_denied" quando seu papel no workspace não tem a permissão redreplier.write (Admin e Editor têm).
  • 404 Not Found: O recurso não existe para a conta do token.
  • 429 Too Many Requests: Limite de requisições excedido. Aguarde os segundos indicados em Retry-After.
  • 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
}