Endpoints

Extraer publicaciones de Reddit

Extrae publicaciones de Reddit y las puntúa por relevancia con IA. Gratis en créditos — solo pagas al generar.

POST/api/v1/scrapeGratis

El endpoint ejecuta exactamente la cadena de escaneo del producto: búsqueda en los subreddits indicados, deduplicación, filtro de frescura (30 días) y después puntuación con IA de cada publicación restante. Aquí no se guarda nada — recibes las publicaciones puntuadas y haces con ellas lo que quieras.

Parámetros

Cuerpo de la petición (application/json)

Parámetro	Tipo	Obligatorio	Descripción
`subreddits`	`string[]`	Obligatorio	Subreddits que explorar, con el formato `r/nombre`. De 1 a 5.
`keywords`	`string[]`	Obligatorio	Palabras clave de búsqueda. De 1 a 10. Sirven a la vez como consulta de Reddit y como contexto para la puntuación.
`product_description`	`string`	Opcional	Descripción de tu producto. Mejora mucho la relevancia: es lo que le dice a la puntuación qué problema resuelves. 500 caracteres como máximo.
`target_language`	`fr \| en`	Opcional	Idioma objetivo de las publicaciones. Filtro estricto si se define; si falta, no se aplica ningún filtro de idioma.
`limit`	`number`	Opcional	Número de publicaciones devueltas, un entero de 1 a 25. Se ordenan por puntuación descendente.Por defecto: `10`

product_description lo cambia todo

Sin ella, la puntuación se queda con tus palabras clave como único contexto — una base mucho más pobre y, por tanto, una selección mecánicamente más severa. Basta una frase: «SaaS de gestión de leads para pymes».

Ejemplo

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

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

Campos de la respuesta

Campo	Tipo	Descripción
`posts[].reddit_post_id`	string	Identificador de Reddit de la publicación (sin el prefijo t3_).
`posts[].url`	string	Enlace permanente de la publicación. Es la URL que toman los otros dos endpoints.
`posts[].score`	number	Relevancia global, de 0 a 1.
`posts[].product_fit`	number	Encaje de la publicación con el problema que resuelve tu producto, de 0 a 1.
`posts[].is_potential_customer`	boolean	El autor es un cliente potencial (y no un competidor ni un colega del sector).
`posts[].customer_intent`	string	Naturaleza de la señal de compra (ver más abajo).
`posts[].created_utc`	number	Fecha de publicación, marca de tiempo Unix en segundos.
`meta.scraped`	number	Publicaciones recuperadas tras la deduplicación.
`meta.scored`	number	Publicaciones que realmente pasaron por la puntuación.
`meta.returned`	number	Publicaciones devueltas, una vez aplicado limit.

Entender la puntuación

A cada publicación se le hacen dos preguntas distintas, y tiene que superar las dos para salir en la respuesta.

score

Relevancia global de la publicación para tu búsqueda, de 0 a 1. Es la clave de ordenación de la respuesta. En la práctica, por encima de 0.7 la publicación merece un comentario y por debajo de 0.5 rara vez es aprovechable.

product_fit

¿Habla la publicación del problema que resuelve tu producto? Esta nota ignora deliberadamente quién es el autor: un consultor que describe tu problema a la perfección tendrá un product_fit alto y un is_potential_customer a false.

is_potential_customer

¿Puede el autor llegar a ser cliente? false para un competidor, un colega que vende el mismo servicio o alguien que solo siente curiosidad. Es el campo que evita que prospectes a gente que se dedica a lo mismo que tú.

customer_intent

Naturaleza de la señal de compra, de la más caliente a la más fría:

recherche active — el autor busca una solución ahora mismo. Es el mejor momento para responder.
frustration — sufre el problema pero todavía no busca ninguna herramienta.
curiosité — se está informando, sin urgencia.
aucun — ninguna señal de cliente.

Un array vacío es una respuesta honesta

Un posts: [] con un meta.scored mayor que 0 significa que había publicaciones pero que ninguna encaja con tu objetivo. No es un fallo: es el filtro haciendo su trabajo. Amplía las palabras clave o los subreddits en vez de repetir la misma llamada.

Y después

Quédate con las publicaciones por encima de 0.7 con is_potential_customer: true y pasa su url y su title al endpoint de generación. Solo en ese paso se descuentan créditos.