Endpoints

Generar un comentario

Redacta un comentario de Reddit natural a partir de una publicación y de tu producto: el tono del subreddit, una sola mención del producto, ninguna señal promocional.

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

El comentario no se almacena en ningún sitio de nuestro lado: se devuelve una vez y eres tú quien lo conserva. Puedes publicarlo tú, hacer que alguien lo revise o enviarlo al endpoint de publicación.

Parámetros

Cuerpo de la petición (application/json)

Parámetro	Tipo	Obligatorio	Descripción
`post_url`	`string`	Obligatorio	URL completa de la publicación de Reddit. Debe empezar por `https://www.reddit.com/` o `https://reddit.com/`. Sirve además como clave de idempotencia del cargo.
`post_title`	`string`	Obligatorio	Título de la publicación. Es lo que aporta la mayor parte del contexto. 300 caracteres como máximo.
`post_body`	`string`	Opcional	Cuerpo de la publicación, cuando lo hay. 2.000 caracteres como máximo. Enviarlo produce un comentario bastante más específico.
`product_description`	`string`	Obligatorio	Descripción de tu producto o servicio. De 10 a 500 caracteres. Sin ella no hay nada que mencionar.
`product_name`	`string`	Opcional	Nombre del producto, 60 caracteres como máximo. Si falta, se deduce del principio de la descripción — a menudo con menos precisión.
`target_language`	`fr \| en`	Opcional	Idioma de reserva del comentario. El idioma detectado de la publicación tiene prioridad.Por defecto: `"fr"`

Ejemplo

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"
  }'

Respuesta 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 es el cargo REAL, no la tarifa: vale 0 en una repetición idempotente. credits_remaining es tu saldo después de la llamada — lo justo para cortar un flujo antes de quedarte sin créditos.

Idempotencia

El cargo se indexa sobre la URL de la publicación, normalizada (se ignoran la barra final, las mayúsculas del dominio y los parámetros de seguimiento). Dos llamadas sobre la misma publicación cobran una sola vez: la segunda devuelve un comentario nuevo con credits_used: 0.

Consecuencia práctica: repetir una llamada tras un timeout de red no cuesta nada. Puedes reintentar sin contar tus llamadas.

La generación te corresponde, aunque falle el cargo

Si el cargo da error después de una generación correcta, recibes el comentario igualmente, con credits_used: 0. La pérdida es nuestra: nunca cobramos un trabajo que no hemos entregado, y nunca retenemos un trabajo ya producido.

Buenas prácticas

Envía siempre product_name — así la mención del producto es exacta y natural en vez de adivinada a partir de la descripción.
Encadénalo con /scrape : extrae primero (gratis) y genera solo sobre las publicaciones por encima de score: 0.7. Es la mejor relación entre créditos gastados y respuestas obtenidas.
Envía post_body cuando exista : un comentario que responde al detalle de la publicación pasa desapercibido, uno que responde solo al título se nota.
Reléelo antes de publicar si el tema es delicado. El texto está listo para pegar, pero lo sigue escribiendo una IA.

El idioma de la publicación manda

target_language es un RESPALDO, no una orden: la generación sigue ante todo el idioma detectado de la publicación. Nunca respondemos en francés bajo un hilo en inglés — un comentario fuera de idioma es la señal más rápida para que te detecten y te borren.