API-referentieGET

Vermeldingen tellen

Tel vermeldingen op Reddit, Hacker News, X, Bluesky en Facebook met dezelfde filters als het endpoint voor de lijst.

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

Tel vermeldingen op Reddit, Hacker News, X, Bluesky en Facebook met dezelfde filters als het endpoint voor de lijst.

Bearer-token (RedReplier API-token)

Authenticatie

Stuur bij elk verzoek een RedReplier-API-token mee als Bearer-token. Tokens beginnen met redreplier_; RedReplier leidt het account af uit het token. Stuur X-Workspace-Id mee om in een andere workspace dan de standaardworkspace te werken; zie Workspaces weergeven.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parameters

  • same filters as GET /mentions (query, optioneel): Accepteert websiteId, statuses, scoreBuckets, includeLowRelevance, minScore, keywords, sources, sort, from en to. limit en offset komen door de validatie, maar hebben geen invloed op de telling.

Request body

Dit endpoint vereist geen JSON-body.

Respons

Geeft het totale aantal vermeldingen terug dat aan de filters voldoet.

  • total (number): Totaal aantal passende vermeldingen.

Voorbeeldverzoek

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

Opmerkingen

Gebruik dit voor paginering of dashboards zonder de rijen met vermeldingen te laden.

Fouten

  • 400 Bad Request: Ongeldige invoer, URL, UUID, enum, queryparameter of body.
  • 401 Unauthorized: Bearer-token ontbreekt of is ongeldig, of code: "token_issuer_lost_access" wanneer de persoon die de API-sleutel heeft aangemaakt is gedeactiveerd of de workspace heeft verlaten.
  • 403 Forbidden: code: "subscription_required" wanneer het abonnement van de workspace geen API-toegang bevat, code: "workspace_access_denied" wanneer X-Workspace-Id een workspace noemt waar deze inloggegevens geen toegang toe hebben, of code: "permission_denied" wanneer je rol in de workspace geen redreplier.write heeft (Admin en Editor hebben die wel).
  • 404 Not Found: De resource bestaat niet voor het account van het token.
  • 429 Too Many Requests: Rate limit overschreden. Wacht het aantal seconden uit Retry-After.
  • 500 Internal Server Error: Onverwachte serverfout.
Voorbeeldverzoek (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
}