Endpoints

Een reactie genereren

Schrijft een natuurlijke Reddit-reactie op basis van een post en jouw product: de toon van de subreddit, één enkele productvermelding, geen promotionele signalen.

POST/api/v1/generate-comment35 credits

De reactie wordt bij ons nergens opgeslagen: je krijgt hem één keer terug, en het is aan jou om hem te bewaren. Je kunt hem zelf plaatsen, laten nalezen of doorsturen naar het publicatie-endpoint.

Parameters

Body van de aanvraag (application/json)

Parameter	Type	Verplicht	Beschrijving
`post_url`	`string`	Verplicht	Volledige URL van de Reddit-post. Moet beginnen met `https://www.reddit.com/` of `https://reddit.com/`. Dient tegelijk als idempotentiesleutel voor de afschrijving.
`post_title`	`string`	Verplicht	Titel van de post. Die draagt het grootste deel van de context. Maximaal 300 tekens.
`post_body`	`string`	Optioneel	Tekst van de post, als die er is. Maximaal 2.000 tekens. Meesturen levert een merkbaar specifiekere reactie op.
`product_description`	`string`	Verplicht	Beschrijving van je product of dienst. Van 10 tot 500 tekens. Zonder die beschrijving valt er niets te noemen.
`product_name`	`string`	Optioneel	Naam van het product, maximaal 60 tekens. Laat je hem weg, dan wordt hij afgeleid uit het begin van de beschrijving — vaak minder scherp.
`target_language`	`fr \| en`	Optioneel	Terugvaltaal van de reactie. De gedetecteerde taal van de post heeft voorrang.Standaard: `"fr"`

Voorbeeld

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

Antwoord 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 is de ECHTE afschrijving, niet het tarief: bij een idempotente herhaling staat er 0. credits_remaining is je saldo ná de aanroep — genoeg om een workflow te stoppen vóór je zonder credits valt.

Idempotentie

De afschrijving hangt aan de URL van de post, genormaliseerd (slash aan het eind, hoofdlettergebruik van het domein en trackingparameters worden genegeerd). Twee aanroepen op dezelfde post kosten dus één keer: de tweede geeft een nieuwe reactie terug met credits_used: 0.

Praktisch gevolg: een aanroep opnieuw spelen na een netwerktimeout kost niets. Je kunt het opnieuw proberen zonder je aanroepen te tellen.

De generatie komt je toe, ook als de afschrijving mislukt

Gaat de afschrijving fout ná een geslaagde generatie, dan krijg je de reactie toch, met credits_used: 0. Het verlies is voor ons: we brengen nooit werk in rekening dat we niet geleverd hebben, en we houden geen werk achter dat al gemaakt is.

Goede gewoontes

Stuur altijd product_name mee — de productvermelding is dan exact en natuurlijk in plaats van geraden uit de beschrijving.
Zet het achter /scrape : scrape eerst (gratis) en genereer daarna alleen op posts boven score: 0.7. Dat is de beste verhouding tussen uitgegeven credits en verkregen antwoorden.
Stuur post_body mee als die er is : een reactie die ingaat op de details van de post valt niet op, een reactie op alleen de titel wel.
Lees hem na vóór je publiceert als het onderwerp gevoelig ligt. De tekst is klaar om te plakken, maar blijft door een AI geschreven.

De taal van de post wint

target_language is een TERUGVAL, geen bevel: de generatie volgt eerst de gedetecteerde taal van de post. We antwoorden nooit in het Frans onder een Engelse draad — een reactie in de verkeerde taal is de snelste manier om opgemerkt en verwijderd te worden.