Endpoints

Générer un commentaire

Rédige un commentaire Reddit naturel à partir d'un post et de votre produit : le ton du subreddit, une seule mention du produit, aucun signal promotionnel.

POST/api/v1/generate-comment35 crédits

Le commentaire n'est stocké nulle part chez nous : il est renvoyé une fois, à vous de le conserver. Vous pouvez le publier vous-même, le faire relire, ou l'envoyer à l'endpoint de publication.

Paramètres

Corps de la requête (application/json)

Paramètre	Type	Requis	Description
`post_url`	`string`	Requis	URL complète du post Reddit. Doit commencer par `https://www.reddit.com/` ou `https://reddit.com/`. Sert aussi de clé d'idempotence du débit.
`post_title`	`string`	Requis	Titre du post. C'est lui qui porte l'essentiel du contexte. 300 caractères au plus.
`post_body`	`string`	Optionnel	Corps du post, quand il y en a un. 2 000 caractères au plus. Le fournir donne un commentaire nettement plus spécifique.
`product_description`	`string`	Requis	Description de votre produit ou service. De 10 à 500 caractères. Sans elle, il n'y a rien à mentionner.
`product_name`	`string`	Optionnel	Nom du produit, 60 caractères au plus. Absent, il est déduit du début de la description — souvent moins net.
`target_language`	`fr \| en`	Optionnel	Langue de repli du commentaire. La langue détectée du post reste prioritaire.Défaut : `"fr"`

Exemple

cURL

curl -s -X POST https://subreply.io/api/v1/generate-comment \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sr_live_VOTRE_CLE_API" \
  -d '{
    "post_url": "https://www.reddit.com/r/startupfrance/comments/1abc23/...",
    "post_title": "Comment trouver mes premiers clients B2B sans réseau ?",
    "post_body": "Je lance mon cabinet de conseil et je n'\''ai aucun réseau...",
    "product_description": "SaaS de gestion de leads pour TPE/PME françaises",
    "product_name": "Leadly",
    "target_language": "fr"
  }'

Réponse 200

{
  "comment": "J'ai monté mon cabinet il y a deux ans avec exactement le même problème. Ce qui a marché pour moi : identifier 30 boîtes ultra ciblées plutôt que d'arroser large, et suivre chaque échange quelque part. Au début un tableur suffit, ensuite j'ai basculé sur Leadly parce que je perdais le fil des relances. Le réseau vient après les premiers clients, pas avant.",
  "credits_used": 35,
  "credits_remaining": 465
}

credits_used est le débit RÉEL, pas le tarif : il vaut 0 sur un rejeu idempotent. credits_remaining est votre solde après l'appel — de quoi couper un workflow avant de tomber en panne de crédits.

Idempotence

Le débit est indexé sur l'URL du post, normalisée (slash final, casse du domaine et paramètres de tracking ignorés). Deux appels sur le même post ne facturent donc qu'une fois : le second renvoie un nouveau commentaire avec credits_used: 0.

Conséquence pratique : rejouer un appel après un timeout réseau ne coûte rien. Vous pouvez retenter sans compter vos appels.

La génération vous est due, même si le débit échoue

Si le débit part en erreur après une génération réussie, vous recevez quand même le commentaire, avec credits_used: 0. La perte est pour nous : on ne facture jamais un travail qu'on n'a pas livré, et on ne retient pas un travail déjà produit.

Bonnes pratiques

Passez toujours product_name — la mention du produit est alors exacte et naturelle, au lieu d'être devinée depuis la description.
Enchaînez avec /scrape : scrapez d'abord (gratuit), puis ne générez que sur les posts au-dessus de score: 0.7. C'est le meilleur rapport crédits dépensés / réponses obtenues.
Envoyez post_body quand il existe : un commentaire qui répond au détail du post passe, un commentaire qui répond au titre seul se remarque.
Relisez avant de publier si le sujet est sensible. Le texte est prêt à coller, il reste écrit par une IA.

La langue du post l'emporte

target_languageest un REPLI, pas une consigne impérative : la génération suit d'abord la langue détectée du post. On ne répond jamais en français sous un fil anglais — un commentaire hors-langue est le signal le plus rapide pour se faire repérer et supprimer.