Endpoints

Scraper des posts Reddit

Scrape des posts Reddit et les score par pertinence avec l'IA. Gratuit en crédits — vous ne payez qu'à la génération.

POST/api/v1/scrapeGratuit

L'endpoint fait tourner exactement le pipeline de scan du produit : recherche sur les subreddits demandés, déduplication, filtre de fraîcheur (30 jours), puis scoring IA de chaque post restant. Rien n'est stocké chez nous — vous recevez les posts scorés et vous en faites ce que vous voulez.

Paramètres

Corps de la requête (application/json)

Paramètre	Type	Requis	Description
`subreddits`	`string[]`	Requis	Subreddits à fouiller, au format `r/nom`. De 1 à 5.
`keywords`	`string[]`	Requis	Mots-clés de recherche. De 1 à 10. Ils servent à la fois de requête Reddit et de contexte au scoring.
`product_description`	`string`	Optionnel	Description de votre produit. Améliore nettement la pertinence : c'est elle qui dit au scoring quel problème vous résolvez. 500 caractères au plus.
`target_language`	`fr \| en`	Optionnel	Langue cible des posts. Filtre strict si défini ; absent, aucun filtre de langue n'est appliqué.
`limit`	`number`	Optionnel	Nombre de posts retournés, entier de 1 à 25. Les posts sont triés par score décroissant.Défaut : `10`

product_description change tout

Sans elle, le scoring retombe sur vos mots-clés comme seul contexte — une base bien plus pauvre, donc une sélection mécaniquement plus sévère. Une phrase suffit : « SaaS de gestion de leads pour TPE/PME françaises ».

Exemple

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

Réponse 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
  }
}

Champs de la réponse

Champ	Type	Description
`posts[].reddit_post_id`	string	Identifiant Reddit du post (sans préfixe t3_).
`posts[].url`	string	Permalien du post. C'est cette URL que prennent les deux autres endpoints.
`posts[].score`	number	Pertinence globale, de 0 à 1.
`posts[].product_fit`	number	Adéquation du post au problème que résout votre produit, de 0 à 1.
`posts[].is_potential_customer`	boolean	L'auteur est un client potentiel (et non un concurrent ou un pair).
`posts[].customer_intent`	string	Nature du signal d'achat (voir plus bas).
`posts[].created_utc`	number	Date de publication, timestamp Unix en secondes.
`meta.scraped`	number	Posts récupérés après déduplication.
`meta.scored`	number	Posts effectivement passés au scoring.
`meta.returned`	number	Posts renvoyés, après application de limit.

Comprendre le scoring

Deux questions différentes sont posées à chaque post, et il faut passer les deux pour ressortir.

score

Pertinence globale du post pour votre recherche, de 0 à 1. C'est la clé de tri de la réponse. En pratique, au-dessus de 0.7 le post mérite un commentaire, en dessous de 0.5 il est rarement exploitable.

product_fit

Le post parle-t-il du problème que votre produit résout ? Cette note ignore volontairement qui est l'auteur : un consultant qui décrit parfaitement votre problème aura un product_fit élevé et un is_potential_customer à false.

is_potential_customer

L'auteur peut-il devenir client ? falsepour un concurrent, un pair qui vend le même service ou un simple curieux. C'est ce champ qui évite de prospecter des gens qui font le même métier que vous.

customer_intent

Nature du signal d'achat, du plus chaud au plus froid :

recherche active— l'auteur cherche une solution maintenant. C'est le meilleur moment pour répondre.
frustration— il subit le problème sans encore chercher d'outil.
curiosité— il s'informe, sans urgence.
aucun — aucun signal client.

Un tableau vide est une réponse honnête

Un posts: [] avec un meta.scoredsupérieur à 0 signifie que des posts existaient mais qu'aucun ne correspond à votre cible. Ce n'est pas un bug : c'est le filtre qui fait son travail. Élargissez les mots-clés ou les subreddits plutôt que de relancer à l'identique.

Et ensuite

Gardez les posts au-dessus de 0.7 avec is_potential_customer: true, puis passez leur url et leur title à l'endpoint de génération. C'est à cette étape seulement que des crédits sont débités.