RedditArchivos comunitarios5 credits

reddit_search

Busca posts y comentarios de Reddit, o lee un hilo de comentarios completo, sin tocar reddit.com, que bloquea los scrapers. Lee el archivo comunitario Arctic Shift: gratuito, 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

5 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 específico: "auto" (primero Arctic Shift, después PullPush; una búsqueda por palabras clave sin acotar pasa primero por web_discovery), "arctic_shift" (búsquedas acotadas e hilos), "web_discovery" (búsqueda por palabras clave en todo Reddit) o "pullpush" (la segunda fuente automática; rechaza a los clientes automatizados desde agosto de 2026) 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 leen el archivo Arctic Shift (casi en tiempo real). Una búsqueda por palabras clave en todo Reddit no la puede servir Arctic Shift directamente —exige un ámbito—, así que se enruta primero a web_discovery: una búsqueda web restringida al sitio encuentra los posts que coinciden y esos IDs se leen después de Arctic Shift. Esa ruta devuelve filas reales del archivo, pero se limita a 10 posts por llamada, los ordena por relevancia de la búsqueda web en lugar de por puntuación o fecha, y no puede aplicar after/before; la respuesta lo indica en sus notes. Siempre que Arctic Shift o web_discovery fallan en una búsqueda de posts o comments, se prueba PullPush en segundo lugar y la respuesta lo indica en fallback_used; PullPush rechaza a los clientes automatizados desde agosto de 2026, así que ese respaldo suele devolver también ese rechazo. Toda búsqueda debe incluir al menos uno de query, subreddit o author. Las puntuaciones y los recuentos de comentarios de contenido con menos de ~36 horas pueden leerse como 0/1: el archivo captura el contenido en el momento en que se publica.

Un backend es exclusivo de MCP. El paquete autoalojado crawlforge-mcp-server también puede leer la API de datos oficial de Reddit (source: "reddit_api") cuando defines REDDIT_CLIENT_ID y REDDIT_CLIENT_SECRET con las credenciales de tu propia app de Reddit: devuelve puntuaciones en vivo y árboles de comentarios completos con tu propia cuota, y recurre a los archivos como respaldo. Este endpoint REST no lo ofrece deliberadamente: una clave de Reddit compartida del lado del servidor sería uso comercial según los términos de la API de Reddit. Ten en cuenta además que Reddit cerró el alta autoservicio de su API en noviembre de 2025, así que las credenciales nuevas pasan por un proceso de aprobación. La búsqueda de texto completo en comentarios y los filtros after/before usan siempre los archivos, porque la API de Reddit no admite ninguno de los dos.

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": 5,
  "credits_remaining": 995,
  "processing_time": 850
}

Field Descriptions

data.sourceQué backend respondió: arctic_shift (acotado, más fresco), web_discovery (búsqueda por palabras clave en todo Reddit sin acotar) o pullpush (la segunda fuente automática, o bajo petición explícita)

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ó

data.commentsModo thread: el árbol de comentarios anidado. Una rama contraída es un stub {more_count, more_ids}: more_count es cuántos comentarios oculta, respuestas incluidas; more_ids solo lista las respuestas directas ocultas, así que puede ser más corto que more_count

data.comment_countModo thread: comentarios en data.comments a cualquier profundidad, sin contar los stubs — como máximo limit

data.comments_collapsedModo thread: la suma del more_count de cada stub — comentarios que el archivo guarda para este hilo y que la respuesta deja fuera. comment_count + comments_collapsed es lo que guarda el archivo; post.num_comments es el total propio de Reddit de cuando el archivo leyó el post, así que puede ser mayor (comentarios eliminados, retirados o aún no archivados) o menor (comentarios publicados después de esa lectura)

credits_used5 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 quita source y deja que auto enrute la consulta a web_discovery.

Modo thread en un backend que no es Arctic (400 Bad Request)

El modo thread es exclusivo de Arctic Shift. source: "pullpush" admite la búsqueda de posts y comments, y source: "web_discovery" solo sirve búsquedas por palabras clave sin acotar.

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. Una consulta acotada va directa a Arctic Shift, donde limit llega a 100 y after/before funcionan; una sin acotar ejecuta web_discovery, que devuelve como mucho 10 posts e ignora los filtros de fecha. 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".