API-ReferenzGET

Mentions zählen

Zählt Mentions aus Reddit, Hacker News, X, Bluesky und Facebook 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, Bluesky und Facebook mit denselben Filtern wie der Listen-Endpoint.

Bearer-Token (RedReplier-API-Token)

Parameter

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

Hinweise

Nutzen Sie 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, oder code: "token_issuer_lost_access", wenn die Person, die den API-Schlüssel erstellt hat, deaktiviert wurde oder den Workspace verlassen hat.
  • 403 Forbidden: code: "subscription_required", wenn der Tarif des Workspace keinen API-Zugang enthält, code: "workspace_access_denied", wenn X-Workspace-Id einen Workspace nennt, den diese Zugangsdaten nicht erreichen, oder code: "permission_denied", wenn Ihre Rolle im Workspace die Berechtigung redreplier.write nicht hat (Admin und Editor haben sie).
  • 404 Not Found: Die Ressource existiert nicht für das Token-Konto.
  • 429 Too Many Requests: Rate-Limit überschritten. Warten Sie die Sekunden aus Retry-After ab.
  • 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
}