Reddit Subreddit Search
Buscar dentro de un subreddit designado aísla las conversaciones relevantes del ruido del resto de la plataforma. Las búsquedas acotadas a una comunidad devuelven títulos de publicaciones, texto del cuerpo, nombres de autor, conteos de comentarios, votos positivos y enlaces multimedia, todo normalizado.
Funcionalidades de la Reddit Subreddit Search API
- Consulta acotada a una comunidadLimita las consultas por palabra clave a comunidades /r/{subreddit} específicas, en lugar de consultar toda la plataforma.
- Opciones de orden detalladasOrdena las publicaciones coincidentes por relevancia, hot, top, new o cantidad de comentarios, según las necesidades de la investigación.
- Filtros de período flexiblesFiltra los resultados por ventanas de publicación de una hora, un día, una semana, un mes, un año o todo el historial.
- Detalles completos de las publicacionesEntrega registros de publicaciones normalizados con título, cuerpo, autor, cantidad de votos positivos, cantidad de comentarios y enlaces permanentes.
Parámetros de la Reddit Subreddit Search API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Consulta de búsqueda por palabra clave que se ejecuta dentro de la comunidad de subreddit indicada. |
urls | Obligatorio | Lista de URL públicas de Reddit con el formato /r/{subreddit} que definen el alcance de la búsqueda a nivel de comunidad. |
results_limit | Opcional | Cantidad máxima de publicaciones que se devuelven por comunidad; el valor predeterminado es 100 y el rango permitido es de 1 a 2,000. |
sort_by | Opcional | Modo de orden de las publicaciones coincidentes: relevance (predeterminado), hot, top, new o comments. |
published_within | Opcional | Filtro de período de publicación: all (predeterminado), year, month, week, day o hour. |
Cómo usar la Reddit Subreddit Search API
Envíe una consulta de búsqueda junto con las URL de las comunidades de destino como una tarea asíncrona y luego obtenga las publicaciones coincidentes.
- Defina su consulta de búsqueda e indique una o más URL de comunidades /r/{subreddit} en urls.
- Si lo desea, elija sort_by (relevance, hot, top, new, comments) y published_within (de hour a all).
- Envíe una solicitud POST a /v1/reddit/subreddit-search con su clave de API de SocQ.
- Consulte /v1/tasks/{task_id} y recorra data.results.items con next_cursor.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"AI agents","urls":["https://www.reddit.com/r/technology/"],"results_limit":20,"sort_by":"relevance"}'
# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.Casos de uso de la Reddit Subreddit Search API
- Seguimiento del sentimiento de la comunidad: Monitoree lo que dicen los miembros de subreddits dedicados a tecnología, finanzas o videojuegos sobre su marca o sus competidores.
- Descubrimiento de problemas de clientes: Busque palabras clave de solución de problemas y de preguntas dentro de subreddits especializados en productos para encontrar los puntos de dolor de los usuarios.
- Investigación de nichos en archivo: Recupere las conversaciones históricas más destacadas sobre temas técnicos o culturales específicos, limitadas a comunidades de referencia.
Consejos de expertos para la Reddit Subreddit Search API
- Indique siempre URL /r/{subreddit} completas en la lista urls; el backend extrae el nombre de la comunidad de forma automática.
- Use este endpoint en lugar de Reddit Search cuando necesite evitar el ruido entre comunidades y centrarse en un solo subreddit.
- Ordenar por comments ayuda a identificar hilos de debate de alta interacción, donde la opinión de la comunidad se expresa con mayor profundidad.
- Combínelo con Reddit Comments para obtener el árbol completo de comentarios de las publicaciones más relevantes que descubra.
APIs relacionadas
Además de la Reddit Subreddit Search API, use estas APIs cuando necesite otro tipo de datos públicos de Reddit.
- Reddit Comments API — Recolecta desde URLs de publicaciones compatibles el texto de comentarios públicos, autores, referencias a la publicación y al comentario principal, contexto de la comunidad, marcas de tiempo e interacción visible.
- Reddit Subreddit Posts API — Descubre publicaciones públicas desde URLs de subreddits con orden por nuevas, mejores o populares, un límite de resultados por subreddit y contexto normalizado de la comunidad y la interacción.
- Reddit Search API — Busca publicaciones públicas de Reddit por consulta de texto y período de publicación, y devuelve contenido normalizado, autores, contexto de la comunidad, marcas de tiempo, contenido multimedia e interacción visible.
- Reddit Subreddit Details API
- Reddit Trending Searches API — Obtiene las búsquedas en tendencia de hoy en Reddit sin datos de entrada, cada una con su posición y un enlace a los resultados de Reddit.
- Reddit Answers API — Haz una pregunta y obtén la respuesta con IA de Reddit, con los comentarios citados, las publicaciones de origen y los subreddits recomendados.