Vermeldingen tellen
Tel vermeldingen op Reddit, Hacker News, X, Bluesky en Facebook met dezelfde filters als het endpoint voor de lijst.
https://ai.redreplier.com/ai-app/api/v1/mentions/countTel vermeldingen op Reddit, Hacker News, X, Bluesky en Facebook met dezelfde filters als het endpoint voor de lijst.
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/jsonParameters
same filters as GET /mentions(query, optioneel): AccepteertwebsiteId,statuses,scoreBuckets,includeLowRelevance,minScore,keywords,sources,sort,fromento.limitenoffsetkomen 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, ofcode: "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"wanneerX-Workspace-Ideen workspace noemt waar deze inloggegevens geen toegang toe hebben, ofcode: "permission_denied"wanneer je rol in de workspace geenredreplier.writeheeft (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 uitRetry-After.500 Internal Server Error: Onverwachte serverfout.
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'{
"total": 14
}