reddit/
search

Busque publicaciones públicas de Reddit por consulta y ventana de publicación, con títulos, texto, autores, contexto de la comunidad, marcas de tiempo, contenido multimedia e interacción visible, todo normalizado.

Reddit Search API

Búsqueda de publicaciones
Ventana de publicación
Contexto de descubrimiento
0.6 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Reddit Search

Los resultados de Reddit Search son publicaciones públicas que coinciden con una consulta de texto, con títulos, texto del cuerpo, autores, contexto del subreddit, contenido multimedia, horas de publicación y las señales visibles de votos y comentarios. Estos registros sirven para descubrir temas, revisar fuentes, investigar por ventanas de tiempo y comparar la interacción entre consultas definidas.

Funcionalidades de la Reddit Search API

  • Descubrimiento de publicaciones por consultaUse una consulta de texto no vacía para descubrir publicaciones públicas de Reddit sin necesidad de indicar URL de publicaciones ni de subreddits.
  • Filtro por ventana de publicaciónLimita el descubrimiento a la última hora, día, semana, mes o año, o usa all para todo el rango de tiempo compatible.
  • Solicitudes de resultados acotadasDefina results_limit de 1 a 2,000 para controlar la cantidad máxima de publicaciones solicitadas para la consulta.
  • Publicación normalizada y contexto de descubrimientoDevuelve en un registro uniforme el contenido de la publicación, los campos del autor y de la comunidad, el contenido multimedia, las marcas de tiempo, la interacción visible y la entrada de descubrimiento.

Parámetros de la Reddit Search API

ParámetrosObligatorioDescripción
queryObligatorioTexto obligatorio y no vacío que se usa para descubrir publicaciones públicas de Reddit.
results_limitOpcionalMáximo de publicaciones que se solicitan. El valor predeterminado es 100 y acepta enteros de 1 a 2,000.
published_withinOpcionalVentana de publicación de las publicaciones coincidentes. El valor predeterminado es all y admite hour, day, week, month, year o all.

Cómo usar la Reddit Search API

Envíe una consulta específica con la ventana de tiempo y el tope de resultados que desee, y luego lea los registros de publicaciones normalizados de la tarea asíncrona completada.

  1. Prepare una consulta de texto no vacía y elija, de forma opcional, una ventana published_within y un results_limit.
  2. Envíe los parámetros por POST a /v1/reddit/search y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
  4. Lea data.results.items y luego solicite el next_cursor devuelto mientras has_more siga en true.
curl -X POST "https://api.socq.ai/v1/reddit/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"machine learning","results_limit":100,"published_within":"month"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la Reddit Search API

  • Descubrimiento de conversaciones por tema: Use los títulos, el texto del cuerpo, los nombres de las comunidades y las URL de origen de las publicaciones para encontrar conversaciones públicas que coincidan con un tema definido.
  • Conjuntos de datos de investigación rastreables hasta la fuente: Conserve los ID, las URL, los autores, las horas de publicación y discovery_input para que cada registro recopilado siga conectado con su fuente y su consulta.
  • Comparación de la interacción por ventana de tiempo: Combine published_within con created_at, collected_at, upvotes_count, comments_count y upvote_ratio para comparar muestras de resultados acotadas.

Consejos de expertos para la Reddit Search API

  • Use una consulta específica que represente una sola pregunta de investigación, para que el texto de las publicaciones coincidentes y el contexto de la comunidad sigan siendo interpretables.
  • Elija published_within según el período que necesite; déjelo en all cuando un corte por fecha de publicación eliminaría publicaciones anteriores relevantes.
  • Trate results_limit como un tope de la solicitud y continúe con los cursores de los resultados de la tarea hasta que has_more sea false, para leer todos los resultados almacenados.
  • Elimine los duplicados de las búsquedas repetidas por ID de publicación y conserve extra.discovery_input y collected_at como contexto de la consulta y de la observación.
  • Maneje como nulos los campos de autor, contenido multimedia, comunidad, marcas de tiempo e interacción, porque la fuente pública puede omitir valores individuales.

Además de la Reddit Search API, use estas APIs cuando necesite otro tipo de datos públicos de Reddit.

  • Reddit Posts API — Recolecta desde URLs de Reddit compatibles el texto de publicaciones públicas, autores, contexto de la comunidad, contenido multimedia, marcas de tiempo e interacción visible.
  • 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 Subreddit Search 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.

Explorar otras plataformas

Combine los datos de Reddit con datos públicos de otras plataformas sociales compatibles.

Reddit Search API — FAQ

Reddit Search API descubre publicaciones públicas a partir de una consulta de texto no vacía, con una ventana de publicación y un tope de resultados opcionales. Devuelve contenido de publicaciones, autores, contexto del subreddit, contenido multimedia, marcas de tiempo, interacción visible y la entrada de descubrimiento, todo normalizado.

La solicitud acepta query, results_limit y published_within. query es obligatorio; el endpoint no expone controles de URL de subreddit, tipo de contenido ni orden.

Cada publicación normalizada puede incluir su ID, URL, título, texto, autor, contexto de la comunidad, contenido multimedia, horas de publicación y de recopilación, votos positivos y comentarios visibles, proporción de votos positivos y la entrada de descubrimiento.

published_within acepta hour, day, week, month, year o all. El valor predeterminado es all.

results_limit tiene un valor predeterminado de 100 y acepta enteros de 1 a 2,000 como máximo solicitado. Cuando la tarea tiene éxito, continúe con next_cursor mientras has_more sea true para leer todas las páginas de resultados almacenados.

Cada resultado de búsqueda normalizado devuelto cuesta 0.6 créditos de SocQ. Un conjunto de resultados vacío no genera cargo por resultados.