API-ReferenzGET

Mentions zählen

Zählt Mentions aus Reddit, Hacker News, X und Bluesky mit denselben Filtern wie der Listen-Endpoint.

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

Zählt Mentions aus Reddit, Hacker News, X und Bluesky mit denselben Filtern wie der Listen-Endpoint.

Bearer-Token (RedReplier-API-Token)

Authentifizierung

Sende bei jeder Anfrage ein RedReplier-API-Token als Bearer-Token. Tokens beginnen mit redreplier_; RedReplier ermittelt das Konto aus dem Token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parameter

  • same filters as GET /mentions (Query, optional): Akzeptiert websiteId, statuses, scoreBuckets, includeLowRelevance, keywords, sources, sort, from und to. limit und offset können validiert werden, beeinflussen die Anzahl aber nicht.

Request-Body

Dieser Endpoint benötigt keinen JSON-Body.

Antwort

Gibt die Gesamtzahl passender Mentions zurück.

  • total (number): Gesamtzahl passender Mentions.

Beispielanfrage

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

Hinweise

Nutze dies für Pagination oder Dashboards, ohne Mention-Zeilen zu laden.

Fehler

  • 400 Bad Request: Ungültige Eingabe, URL, UUID, Enum, Query-Parameter oder Body.
  • 401 Unauthorized: Fehlendes oder ungültiges Bearer-Token.
  • 404 Not Found: Die Ressource existiert nicht für das Token-Konto.
  • 500 Internal Server Error: Unerwarteter Serverfehler.
Beispielanfrage (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
}