API SubReply
L'API publique de SubReply expose le moteur de social selling Reddit du produit, sans passer par le dashboard.
- Scraper— vous donnez des subreddits et des mots-clés, l'API vous rend les posts récents, scorés par pertinence et par intention d'achat.
- Générer— vous donnez un post et votre produit, l'API rédige un commentaire naturel, dans la langue du fil, pensé pour ne pas déclencher de shadowban.
- Publier— vous donnez un commentaire, l'API le poste sur Reddit depuis un compte du parc SubReply, derrière un proxy résidentiel.
Base URL
Les endpoints qui produisent sont en POST, ceux qui lisent en GET. Tous renvoient du application/json et vivent sous une seule base :
https://subreply.io/api/v1Il n'y a pas de version v2 en préparation ni de champ qui disparaîtra sans préavis : ce que cette page décrit est le contrat.
Premier appel en 30 secondes
Générez une clé sur votre page clés API, puis collez ceci dans un terminal. Le scan ne coûte aucun crédit : vous pouvez le lancer autant de fois que nécessaire pour caler vos mots-clés.
curl -s -X POST https://subreply.io/api/v1/scrape \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sr_live_VOTRE_CLE_API" \
-d '{
"subreddits": ["r/entrepreneur"],
"keywords": ["trouver des clients"],
"target_language": "fr",
"limit": 3
}'Cas d'usage
L'API est stateless : rien n'est stocké côté SubReply, ni les posts scrapés ni les commentaires générés. Vous gardez la donnée chez vous, et vous branchez l'API où vous voulez.
n8n, Zapier et Make
Un nœud HTTP Request suffit : trois appels POST enchaînés font un workflow de prospection Reddit complet, sans écrire une ligne de code.
Scripts Python ou Node.js
Du JSON dedans, du JSON dehors. Pas de SDK à installer, pas de pagination à gérer : un fetch et vous avez vos posts scorés.
CRM et outils de prospection
Poussez les posts détectés comme leads dans votre CRM avec leur score, leur intention client et leur permalien Reddit.
Agents IA
Donnez ces trois endpoints à un LLM et il prospecte seul : il cherche, il rédige, il publie. Cette page est écrite pour être lue par un agent autant que par un humain.
Pour les agents, il existe un chemin plus court que le HTTP : le serveur MCP. Les mêmes capacités y sont exposées en six tools, que Claude, ChatGPT, Gemini ou n8n découvrent tout seuls — avec la clé API de cette page, sans une ligne de code de colle.
Coût de chaque action
Le modèle est simple : la recherche est gratuite, seule la production est facturée. Vous ne payez donc jamais pour un scan qui ne trouve rien.
| Action | Endpoint | Crédits |
|---|---|---|
| Scraper des posts | POST /api/v1/scrape | 0 |
| Générer un commentaire | POST /api/v1/generate-comment | 35 |
| Publier un commentaire | POST /api/v1/publish | 50 |
| Lire le statut du compte | GET /api/v1/account | 0 |
| Lister ses projets | GET /api/v1/projects | 0 |
Vous utilisez un LLM ? Connectez-le directement via le serveur MCP : les mêmes capacités, sans une ligne de code de colle.
Le scan est gratuit, mais pas ouvert à tous
402: scraper pour un compte qui ne peut rien produire derrière ne sert personne. Les deux endpoints de lecture, eux, restent ouverts à 0 crédit — c'est tout leur intérêt.Limites et comportements à connaître
- Pas de rate limit sur l'API REST aujourd'hui. Le solde de crédits est la seule limite. Si un quota apparaît un jour, il sera annoncé ici avant d'être appliqué. Le serveur MCP, lui, applique des quotas par compte et par tool.
- Publier est lent — jusqu'à deux minutes : un vrai navigateur ouvre le post et écrit le commentaire. Réglez le timeout de votre client HTTP à 180 s au moins (dans n8n :
Options → Timeout). - Les débits sont idempotents par post : rejouer un appel sur la même URL Reddit après un timeout réseau ne facture pas deux fois. Le second appel renvoie
credits_used: 0. - Un scan vide est un résultat, pas une panne. Les filtres de fraîcheur, de pertinence et de fit produit sont stricts — mieux vaut zéro post que dix hors-sujet.
Les erreurs suivent toutes la même forme et sont détaillées sur la page codes d'erreur.