RedditArchivos comunitarios2 credits

reddit_search

Busca posts y comentarios de Reddit, o lee un hilo de comentarios completo, sin tocar reddit.com, que bloquea los scrapers. Consulta los archivos comunitarios Arctic Shift y PullPush: gratuitos, casi en tiempo real y sin necesidad de credenciales de la API de Reddit.

Casos de uso

Monitoreo de marca y producto

Encuentra cada mención de tu producto o empresa en Reddit, acotada a subreddits relevantes o en todo el sitio

Investigación de mercado y sentimiento

Extrae lo que dicen los usuarios reales sobre una categoría, un competidor o un punto de dolor en las comunidades donde lo discuten

Lectura de hilos para agentes de IA

Obtén un post junto con su árbol completo de comentarios anidados en una sola llamada, listo para resumir o analizar

Seguimiento de tendencias de la comunidad

Observa de qué habla un subreddit durante un rango de fechas usando los filtros after/before

Investigación de usuarios

Recupera los posts o comentarios de un autor específico para entender opiniones expertas y temas recurrentes

Endpoint

POST/api/v1/tools/reddit_search

Auth Required

1 req/s en el plan Free

2 credits

Parameters

Name	Type	Required	Default	Description
query	string	Optional	-	Búsqueda por palabras clave. El modo posts coincide con title + selftext; el modo comments coincide con body. Admite "frases entre comillas", OR y exclusión con - Example: best mechanical keyboard
subreddit	string	Optional	-	Limita los resultados a un subreddit (con o sin el prefijo r/) Example: MechanicalKeyboards
author	string	Optional	-	Limita los resultados a un autor (con o sin el prefijo u/) Example: spez
mode	string	Optional	posts	Qué buscar: "posts" (predeterminado), "comments" o "thread" (un post junto con su árbol de comentarios anidados; requiere link_id) Example: thread
link_id	string	Optional	-	ID del post (p. ej. "1twm1zh" o "t3_1twm1zh"); obligatorio en el modo thread, filtro opcional en el modo comments Example: 1twm1zh
after	string	Optional	-	Solo contenido publicado después de esta fecha: ISO 8601, segundos epoch o un desplazamiento como "7d" Example: 7d
before	string	Optional	-	Solo contenido publicado antes de esta fecha; mismos formatos que after Example: 2026-08-01
limit	number	Optional	25	Máximo de resultados, 1-100 (modo thread: máximo de comentarios devueltos) Example: 10
sort	string	Optional	desc	Orden por fecha del post: "desc" (más recientes primero) o "asc" Example: desc
source	string	Optional	auto	Fuerza un backend de archivo específico: "auto" (enruta y aplica respaldo), "arctic_shift" o "pullpush" Example: auto

reddit.com bloquea el scraping directo, así que reddit_search nunca lo toca. Las búsquedas acotadas por subreddit o autor y el modo thread usan el archivo Arctic Shift (casi en tiempo real); las búsquedas por palabras clave en todo Reddit se enrutan a PullPush, que tiene lagunas conocidas en su archivo posterior a 2023. Toda búsqueda debe incluir al menos uno de query, subreddit o author. Los scores y los recuentos de comentarios del contenido con menos de ~36 horas pueden leerse como 0/1: los archivos capturan el contenido en el momento en que se publica.

Ejemplos de solicitud

terminalBash

curl -X POST https://crawlforge.dev/api/v1/tools/reddit_search \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "best mechanical keyboard",
    "subreddit": "MechanicalKeyboards",
    "mode": "posts",
    "limit": 10
  }'

Ejemplo de respuesta

200 OK850ms

{
  "success": true,
  "data": {
    "source": "arctic_shift",
    "mode": "posts",
    "query": "best mechanical keyboard",
    "subreddit": "MechanicalKeyboards",
    "author": null,
    "count": 2,
    "results": [
      {
        "id": "1x2y3z4",
        "title": "What's the best mechanical keyboard for programming in 2026?",
        "author": "keeb_enthusiast",
        "subreddit": "MechanicalKeyboards",
        "created_utc": 1755993600,
        "created_iso": "2026-08-24T00:00:00.000Z",
        "score": 142,
        "num_comments": 87,
        "upvote_ratio": 0.96,
        "flair": "Discussion",
        "over_18": false,
        "selftext": "After five years on membrane boards I finally want to switch...",
        "selftext_truncated": false,
        "url": "https://www.reddit.com/r/MechanicalKeyboards/comments/1x2y3z4/",
        "permalink": "https://www.reddit.com/r/MechanicalKeyboards/comments/1x2y3z4/whats_the_best_mechanical_keyboard/"
      }
    ],
    "notes": [
      "Data from the Arctic Shift community archive (arctic-shift.photon-reddit.com), not reddit.com (which blocks scrapers).",
      "Scores and comment counts of content less than ~36h old may read 0/1 — the archive captures content the moment it is posted."
    ],
    "checkedAt": "2026-08-24T14:30:00.000Z"
  },
  "credits_used": 2,
  "credits_remaining": 998,
  "processing_time": 850
}

Field Descriptions

data.sourceQué archivo respondió: arctic_shift (acotado, más fresco) o pullpush (búsqueda por palabras clave en todo el sitio)

data.resultsPosts o comentarios normalizados con permalinks completos de reddit.com y fechas ISO

data.results.selftext_truncatedEl texto del post/comentario se limita a 2,000 caracteres; true cuando se recorta

data.notesAdvertencias de procedencia y frescura del archivo que respondió

credits_used2 credits fijos por búsqueda o lectura de hilo

processing_timeLas búsquedas en los archivos normalmente se completan en menos de 2 segundos

Manejo de errores

Falta el ámbito de búsqueda (400 Bad Request)

Los modos posts y comments necesitan al menos uno de query, subreddit o author. El modo thread requiere link_id.

Búsqueda de Arctic Shift sin acotar (400 Bad Request)

Arctic Shift no puede buscar por palabras clave en todo Reddit. Añade un ámbito de subreddit o autor, o usa source: "pullpush".

Modo thread vía PullPush (400 Bad Request)

El modo thread es exclusivo de Arctic Shift; source: "pullpush" admite la búsqueda de posts y comments.

Filtro de fecha no válido (400 Bad Request)

after/before deben ser ISO 8601, segundos epoch o un desplazamiento como "7d".

Archivos no disponibles (502 Bad Gateway)

Ambos archivos comunitarios fallaron o están aplicando límites de tasa. El mensaje de error incluye el motivo de cada archivo. No se cobran credits: vuelve a intentarlo en breve.

Consejo profesional: Acota las búsquedas a un subreddit o autor siempre que puedas: las consultas acotadas se enrutan a Arctic Shift, que es más fresco y fiable que la ruta de PullPush para todo el sitio. Para leer una discusión de principio a fin, toma el id de un post de un resultado de búsqueda y pásalo como link_id con mode: "thread".

Costo en credits

2 credits

2 credits por búsqueda

Costo fijo por una búsqueda o la lectura de un hilo completo. Los credits se cobran solo por las solicitudes exitosas.

Qué incluye:

Modos de posts, comments e hilo completo

Filtros por subreddit, autor y rango de fechas

Árboles de comentarios anidados con marcadores de colapso al estilo reddit

Permalinks completos de reddit.com y fechas ISO en cada resultado

Sin necesidad de credenciales de la API de Reddit

Recomendaciones de plan:

Plan Free: 1,000 credits de prueba por única vez = 500 búsquedas

Plan Hobby: 5,000 credits = 2,500 búsquedas ($19/mo)

Plan Professional: 50,000 credits = 25,000 búsquedas ($99/mo)

Herramientas relacionadas

search_web

Busca en toda la web mediante Google o DuckDuckGo (5 credits)

summarize_content

Resume hilos largos en puntos clave (4 credits)

analyze_content

Sentimiento, entidades y palabras clave del texto de un hilo (3 credits)

deep_research

Investigación multifuente con análisis de IA (10 credits)

¿Listo para probar reddit_search? Regístrate gratis y obtén 1,000 credits para empezar a extraer discusiones de Reddit.

Casos de uso

Monitoreo de marca y producto

Encuentra cada mención de tu producto o empresa en Reddit, acotada a subreddits relevantes o en todo el sitio

Investigación de mercado y sentimiento

Extrae lo que dicen los usuarios reales sobre una categoría, un competidor o un punto de dolor en las comunidades donde lo discuten

Lectura de hilos para agentes de IA

Obtén un post junto con su árbol completo de comentarios anidados en una sola llamada, listo para resumir o analizar

Seguimiento de tendencias de la comunidad

Observa de qué habla un subreddit durante un rango de fechas usando los filtros after/before

Investigación de usuarios

Recupera los posts o comentarios de un autor específico para entender opiniones expertas y temas recurrentes

Parameters

Name	Type	Required	Default	Description
query	string	Optional	-	Búsqueda por palabras clave. El modo posts coincide con title + selftext; el modo comments coincide con body. Admite "frases entre comillas", OR y exclusión con - Example: best mechanical keyboard
subreddit	string	Optional	-	Limita los resultados a un subreddit (con o sin el prefijo r/) Example: MechanicalKeyboards
author	string	Optional	-	Limita los resultados a un autor (con o sin el prefijo u/) Example: spez
mode	string	Optional	posts	Qué buscar: "posts" (predeterminado), "comments" o "thread" (un post junto con su árbol de comentarios anidados; requiere link_id) Example: thread
link_id	string	Optional	-	ID del post (p. ej. "1twm1zh" o "t3_1twm1zh"); obligatorio en el modo thread, filtro opcional en el modo comments Example: 1twm1zh
after	string	Optional	-	Solo contenido publicado después de esta fecha: ISO 8601, segundos epoch o un desplazamiento como "7d" Example: 7d
before	string	Optional	-	Solo contenido publicado antes de esta fecha; mismos formatos que after Example: 2026-08-01
limit	number	Optional	25	Máximo de resultados, 1-100 (modo thread: máximo de comentarios devueltos) Example: 10
sort	string	Optional	desc	Orden por fecha del post: "desc" (más recientes primero) o "asc" Example: desc
source	string	Optional	auto	Fuerza un backend de archivo específico: "auto" (enruta y aplica respaldo), "arctic_shift" o "pullpush" Example: auto

Ejemplos de solicitud

terminalBash

curl -X POST https://crawlforge.dev/api/v1/tools/reddit_search \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "best mechanical keyboard",
    "subreddit": "MechanicalKeyboards",
    "mode": "posts",
    "limit": 10
  }'

Ejemplo de respuesta

200 OK850ms

{
  "success": true,
  "data": {
    "source": "arctic_shift",
    "mode": "posts",
    "query": "best mechanical keyboard",
    "subreddit": "MechanicalKeyboards",
    "author": null,
    "count": 2,
    "results": [
      {
        "id": "1x2y3z4",
        "title": "What's the best mechanical keyboard for programming in 2026?",
        "author": "keeb_enthusiast",
        "subreddit": "MechanicalKeyboards",
        "created_utc": 1755993600,
        "created_iso": "2026-08-24T00:00:00.000Z",
        "score": 142,
        "num_comments": 87,
        "upvote_ratio": 0.96,
        "flair": "Discussion",
        "over_18": false,
        "selftext": "After five years on membrane boards I finally want to switch...",
        "selftext_truncated": false,
        "url": "https://www.reddit.com/r/MechanicalKeyboards/comments/1x2y3z4/",
        "permalink": "https://www.reddit.com/r/MechanicalKeyboards/comments/1x2y3z4/whats_the_best_mechanical_keyboard/"
      }
    ],
    "notes": [
      "Data from the Arctic Shift community archive (arctic-shift.photon-reddit.com), not reddit.com (which blocks scrapers).",
      "Scores and comment counts of content less than ~36h old may read 0/1 — the archive captures content the moment it is posted."
    ],
    "checkedAt": "2026-08-24T14:30:00.000Z"
  },
  "credits_used": 2,
  "credits_remaining": 998,
  "processing_time": 850
}

Field Descriptions

data.sourceQué archivo respondió: arctic_shift (acotado, más fresco) o pullpush (búsqueda por palabras clave en todo el sitio)

data.resultsPosts o comentarios normalizados con permalinks completos de reddit.com y fechas ISO

data.results.selftext_truncatedEl texto del post/comentario se limita a 2,000 caracteres; true cuando se recorta

data.notesAdvertencias de procedencia y frescura del archivo que respondió

credits_used2 credits fijos por búsqueda o lectura de hilo

processing_timeLas búsquedas en los archivos normalmente se completan en menos de 2 segundos

Manejo de errores

Falta el ámbito de búsqueda (400 Bad Request)

Los modos posts y comments necesitan al menos uno de query, subreddit o author. El modo thread requiere link_id.

Búsqueda de Arctic Shift sin acotar (400 Bad Request)

Arctic Shift no puede buscar por palabras clave en todo Reddit. Añade un ámbito de subreddit o autor, o usa source: "pullpush".

Modo thread vía PullPush (400 Bad Request)

El modo thread es exclusivo de Arctic Shift; source: "pullpush" admite la búsqueda de posts y comments.

Filtro de fecha no válido (400 Bad Request)

after/before deben ser ISO 8601, segundos epoch o un desplazamiento como "7d".

Archivos no disponibles (502 Bad Gateway)

Ambos archivos comunitarios fallaron o están aplicando límites de tasa. El mensaje de error incluye el motivo de cada archivo. No se cobran credits: vuelve a intentarlo en breve.

Costo en credits

2 credits

2 credits por búsqueda

Costo fijo por una búsqueda o la lectura de un hilo completo. Los credits se cobran solo por las solicitudes exitosas.

Qué incluye:

Modos de posts, comments e hilo completo

Filtros por subreddit, autor y rango de fechas

Árboles de comentarios anidados con marcadores de colapso al estilo reddit

Permalinks completos de reddit.com y fechas ISO en cada resultado

Sin necesidad de credenciales de la API de Reddit

Recomendaciones de plan:

Plan Free: 1,000 credits de prueba por única vez = 500 búsquedas

Plan Hobby: 5,000 credits = 2,500 búsquedas ($19/mo)

Plan Professional: 50,000 credits = 25,000 búsquedas ($99/mo)