Démarrage

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

Tous les endpoints sont en POST, acceptent et renvoient du application/json, et vivent sous une seule base :

Base URL

https://subreply.io/api/v1

Il 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

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.

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

Le scan est gratuit, mais pas ouvert à tous

Un scan ne débite rien, en revanche il exige un solde d'au moins 35 crédits — le prix d'un commentaire. Sans quoi l'endpoint répond 402 : scraper pour un compte qui ne peut rien produire derrière ne sert personne.

Limites et comportements à connaître

Pas de rate limit 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é.
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.