Endpoints

Reddit-posts scrapen

Scrapet Reddit-posts en scoort ze op relevantie met AI. Gratis in credits — je betaalt pas bij het genereren.

POST/api/v1/scrapeGratis

Het endpoint draait precies de scanpijplijn van het product: zoeken in de gevraagde subreddits, ontdubbelen, versheidsfilter (30 dagen) en daarna AI-scoring van elke overgebleven post. Bij ons wordt niets opgeslagen — jij krijgt de gescoorde posts en doet ermee wat je wilt.

Parameters

Body van de aanvraag (application/json)

Parameter	Type	Verplicht	Beschrijving
`subreddits`	`string[]`	Verplicht	Subreddits om te doorzoeken, in de vorm `r/naam`. Van 1 tot 5.
`keywords`	`string[]`	Verplicht	Zoekwoorden. Van 1 tot 10. Ze dienen zowel als Reddit-zoekopdracht als als context voor de scoring.
`product_description`	`string`	Optioneel	Beschrijving van je product. Verhoogt de relevantie flink: dit vertelt de scoring welk probleem je oplost. Maximaal 500 tekens.
`target_language`	`fr \| en`	Optioneel	Doeltaal van de posts. Een streng filter wanneer ingevuld; laat je hem weg, dan geldt er geen taalfilter.
`limit`	`number`	Optioneel	Aantal teruggegeven posts, een geheel getal van 1 tot 25. De posts staan gesorteerd op aflopende score.Standaard: `10`

product_description maakt het verschil

Zonder die beschrijving valt de scoring terug op alleen je zoekwoorden — een veel magerdere basis, dus een navenant strengere selectie. Eén zin volstaat: « SaaS voor leadbeheer voor kleine bedrijven ».

Voorbeeld

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/startupfrance", "r/entrepreneur_libre"],
    "keywords": ["trouver clients", "prospection", "acquisition"],
    "product_description": "SaaS de gestion de leads pour TPE/PME françaises",
    "target_language": "fr",
    "limit": 5
  }'

Antwoord 200

{
  "posts": [
    {
      "reddit_post_id": "1abc23",
      "title": "Comment trouver mes premiers clients B2B sans réseau ?",
      "url": "https://www.reddit.com/r/startupfrance/comments/1abc23/...",
      "subreddit": "startupfrance",
      "score": 0.87,
      "is_potential_customer": true,
      "customer_intent": "recherche active",
      "product_fit": 0.82,
      "language": "fr",
      "created_utc": 1725977600
    }
  ],
  "meta": {
    "scraped": 47,
    "scored": 47,
    "returned": 1,
    "credits_used": 0
  }
}

Velden van het antwoord

Veld	Type	Beschrijving
`posts[].reddit_post_id`	string	Reddit-identifier van de post (zonder voorvoegsel t3_).
`posts[].url`	string	Permalink van de post. Dit is de URL die de twee andere endpoints verwachten.
`posts[].score`	number	Algemene relevantie, van 0 tot 1.
`posts[].product_fit`	number	Hoe goed de post aansluit op het probleem dat jouw product oplost, van 0 tot 1.
`posts[].is_potential_customer`	boolean	De auteur is een potentiële klant (en geen concurrent of vakgenoot).
`posts[].customer_intent`	string	Aard van het koopsignaal (zie hieronder).
`posts[].created_utc`	number	Publicatiedatum, Unix-timestamp in seconden.
`meta.scraped`	number	Opgehaalde posts na ontdubbeling.
`meta.scored`	number	Posts die daadwerkelijk door de scoring zijn gegaan.
`meta.returned`	number	Teruggegeven posts, na toepassing van limit.

De scoring begrijpen

Aan elke post worden twee verschillende vragen gesteld, en hij moet ze allebei doorstaan om terug te komen.

score

Algemene relevantie van de post voor jouw zoekopdracht, van 0 tot 1. Het is de sorteersleutel van het antwoord. In de praktijk verdient een post boven 0.7 een reactie en is hij onder 0.5 zelden bruikbaar.

product_fit

Gaat de post over het probleem dat jouw product oplost? Deze score negeert bewust wie de auteur is: een consultant die jouw probleem perfect beschrijft krijgt een hoge product_fit en een is_potential_customer op false.

is_potential_customer

Kan de auteur klant worden? false voor een concurrent, een vakgenoot die dezelfde dienst verkoopt of iemand die gewoon nieuwsgierig is. Dit veld voorkomt dat je mensen benadert die hetzelfde vak uitoefenen als jij.

customer_intent

Aard van het koopsignaal, van warmst naar koudst:

recherche active — de auteur zoekt nú een oplossing. Het beste moment om te reageren.
frustration — hij loopt tegen het probleem aan, maar zoekt nog geen tool.
curiosité — hij oriënteert zich, zonder haast.
aucun — geen enkel koopsignaal.

Een lege array is een eerlijk antwoord

Een posts: [] met een meta.scored boven 0 betekent dat er posts wáren, maar dat geen enkele bij jouw doelgroep paste. Dat is geen bug: dat is het filter dat zijn werk doet. Verbreed je zoekwoorden of je subreddits in plaats van dezelfde aanroep te herhalen.

En daarna

Houd de posts boven 0.7 met is_potential_customer: true over en geef hun url en hun title door aan het generatie-endpoint. Pas bij die stap worden er credits afgeschreven.