Référence de l'APIGET

Compter les mentions

Compte les mentions Reddit, Hacker News, X, Bluesky et Facebook correspondant aux mêmes filtres que l’endpoint de liste.

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

Compte les mentions Reddit, Hacker News, X, Bluesky et Facebook correspondant aux mêmes filtres que l’endpoint de liste.

Jeton Bearer (jeton API RedReplier)

Paramètres

  • same filters as GET /mentions (requête, facultatif): Accepte websiteId, statuses, scoreBuckets, includeLowRelevance, minScore, keywords, sources, sort, from et to. limit et offset peuvent passer la validation, mais n’affectent pas le total.

Corps de la requête

Cet endpoint ne nécessite aucun corps JSON.

Réponse

Renvoie le nombre total de mentions correspondantes.

  • total (number): Nombre total de mentions correspondantes.

Notes

Utilisez-le pour la pagination ou les tableaux de bord sans charger les lignes de mentions.

Erreurs

  • 400 Bad Request: Entrée, URL, UUID, enum, paramètre de requête ou corps non valide.
  • 401 Unauthorized: Bearer token manquant ou non valide, ou code: "token_issuer_lost_access" quand la personne qui a créé la clé API a été désactivée ou a quitté l'espace de travail.
  • 403 Forbidden: code: "subscription_required" quand l'abonnement de l'espace de travail n'inclut pas l'accès à l'API, code: "workspace_access_denied" quand X-Workspace-Id désigne un espace de travail que ces identifiants ne peuvent pas atteindre, ou code: "permission_denied" quand votre rôle dans l'espace de travail n'a pas la permission redreplier.write (Admin et Editor l'ont).
  • 404 Not Found: La ressource n’existe pas pour le compte du token.
  • 429 Too Many Requests: Limite de débit dépassée. Attendez le nombre de secondes indiqué dans Retry-After.
  • 500 Internal Server Error: Erreur serveur inattendue.
Exemple de requête (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
}