Référence de l'API

Premiers pas avec l'API RedReplier

L’API RedReplier permet aux outils externes, automatisations et agents IA de gérer le suivi des mentions sur Reddit, Hacker News, X, Bluesky et Facebook. Utilisez-la pour créer des sites surveillés, gérer les mots-clés, examiner les mentions scorées par IA, prévisualiser les changements de facturation et configurer les alertes e-mail. L'API ne facture rien et ne change jamais l'abonnement: les changements d'abonnement se font dans l'application RedReplier.

URL de base: https://ai.redreplier.com/ai-app/api/v1

Envoyez un token API RedReplier comme Bearer token à chaque requête. Les tokens commencent par redreplier_; RedReplier résout le compte depuis le token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Le compte est déduit du token API. N’envoyez pas d’IDs de compte ou d’organisation. Chaque appel s’exécute dans un espace de travail : sans l’en-tête facultatif X-Workspace-Id, il aboutit dans l’espace de travail par défaut. Une connexion OAuth, comme le connecteur Claude ou ChatGPT, peut atteindre chaque espace de travail dont son membre fait partie, dans toutes ses organisations. Appelez Lister les espaces de travail et envoyez l’id voulu dans X-Workspace-Id. Une clé API appartient à un seul espace de travail, envoyez donc son propre id ou omettez l’en-tête.

X-Workspace-Id: acct_7dK9pQ2

Commencez par Lister les sites web pour découvrir les IDs de sites web et de mots-clés.

Ressources principales:

  • Website: produit, domaine ou marque surveillée.
  • Keyword: expression comparée aux publications et commentaires sur Reddit, Hacker News, X, Bluesky et Facebook pour un site web.
  • Mention: publication ou commentaire trouvé sur Reddit, Hacker News, X, Bluesky ou Facebook avec un relevanceScore de 0 à 100.
  • Alert settings: cadence e-mail pour les nouvelles mentions pertinentes.

Statuts de mot-clé: PENDING, ACTIVE, DISABLED, SUSPENDED. Statuts de mention: NEW, APPROVED, REJECTED.

Endpoints REST

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: L’en-tête X-Workspace-Id désigne un espace de travail que ces identifiants ne peuvent pas atteindre, y compris l’id d’un autre espace de travail envoyé avec une clé API. Le corps contient code: "workspace_access_denied" et le workspaceId. Un 403 avec code: "subscription_required" signifie que l'abonnement de l'espace de travail n'inclut pas l'accès à l'API. Un 403 avec code: "permission_denied" signifie que votre rôle dans l'espace de travail n'a pas la permission requise par l'appel: RedReplier demande redreplier.write, que détiennent Admin et Editor. Ce corps indique la requiredPermission et votre role.
  • 404 Not Found: La ressource n’existe pas pour le compte du token.
  • 429 Too Many Requests: Limite de débit dépassée. Chaque réponse contient RateLimit-Policy, RateLimit-Limit, RateLimit-Remaining et RateLimit-Reset, et un 429 ajoute Retry-After en secondes. Les limites sont comptées par clé API.
  • 500 Internal Server Error: Erreur serveur inattendue.

Un espace de travail refusé répond :

{
  "statusCode": 403,
  "error": "Forbidden",
  "code": "workspace_access_denied",
  "workspaceId": "acct_3Hm8XwR",
  "message": "Vous n'avez pas accès à l'espace de travail acct_3Hm8XwR. Appelez GET /workspaces pour lister les espaces de travail disponibles, puis envoyez l'un de ces identifiants dans l'en-tête X-Workspace-Id."
}

Retour au début