API referenceGET

Count mentions

Count mentions across Reddit, Hacker News, X, and Bluesky matching the same filters used by the list endpoint.

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

Count mentions across Reddit, Hacker News, X, and Bluesky matching the same filters used by the list endpoint.

Bearer Token (RedReplier API token)

Parameters

same filters as GET /mentions (query, optional): Accepts websiteId, statuses, scoreBuckets, includeLowRelevance, keywords, sources, sort, from, and to. limit and offset are accepted by validation but do not affect the count.

Request body

This endpoint does not require a JSON body.

Response

Returns the total number of matching mentions.

total (number): Total matching mentions.

Notes

Use this for pagination or dashboards without loading mention rows.

Errors

400 Bad Request: Invalid input, URL, UUID, enum, query parameter, or body.
401 Unauthorized: Missing or invalid Bearer token.
404 Not Found: The resource does not exist for the token account.
500 Internal Server Error: Unexpected server error.

Example request (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
}

Example request (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
}