Volver a las API
Datos públicos de Reddit

Reddit Public Data API

Obtenga publicaciones y comentarios públicos de Reddit a partir de URL conocidas, explore publicaciones nuevas, principales o populares de un subreddit, o busque conversaciones por palabra clave y período de publicación.

API de Reddit disponibles

Use Posts para una publicación conocida, Comments para sus respuestas públicas, Subreddit Posts para el feed de una comunidad o Search para descubrir contenido por palabra clave.

¿Qué datos de Reddit se pueden obtener?

SocQ devuelve contenido público normalizado de Reddit con contexto de comunidad, respuestas, descubrimiento, interacción y momento de recopilación para el análisis de conversaciones.

Publicaciones e interacción visible

Obtenga títulos, texto del cuerpo, autores, flair, contexto de la comunidad, multimedia, URL de origen y métricas visibles asociadas a collected_at.

Comentarios y relaciones entre respuestas

Obtenga el texto de comentarios públicos, autores, referencias a la publicación de origen y al comentario principal, marcas de tiempo, upvotes y conteos de respuestas.

Descubrimiento de subreddits

Explore publicaciones nuevas, principales o populares a partir de URL /r/{subreddit}, con un límite de resultados independiente para cada comunidad.

Búsqueda por palabra clave

Busque publicaciones públicas por consulta de texto y período de publicación, manteniendo juntos la publicación encontrada y el contexto de descubrimiento.

SocQ vs Reddit Data API

SocQ ofrece flujos de recopilación de datos públicos de Reddit. Reddit Data API es la interfaz oficial para apps aprobadas que acceden a los datos de Reddit o los modifican.

FuncionalidadSocQReddit Data API
Uso principalRecopilar publicaciones, comentarios, listados de subreddits y resultados de búsqueda públicosCrear apps, integraciones y herramientas de moderación de Reddit aprobadas
AutenticaciónClave de API de SocQ; sin OAuth de usuario de RedditAprobación de Reddit, credenciales OAuth e identidad de app declarada
Entrada inicialURL pública de una publicación o de un subreddit, o una consulta de textoEndpoints de Reddit, fullnames, parámetros de listados y scopes de OAuth
Publicar, votar o moderarNo compatibleCompatible en casos de uso aprobados con los scopes de usuario requeridos
Formato de respuestaRegistros normalizados de SocQObjetos y listados nativos de Reddit

Cómo funciona la API de Reddit

La recopilación directa, la exploración de subreddits y la búsqueda por palabra clave usan el mismo flujo de tarea asíncrona y resultados paginados.

  1. 1. Enviar la entrada

    Envíe URL de publicaciones, URL de subreddits o una consulta de búsqueda a la API correspondiente y guarde el task_id devuelto.

  2. 2. Seguir la tarea

    Consulte /v1/tasks/{task_id} hasta que el procesamiento termine.

  3. 3. Obtener los resultados

    Lea data.results.items y use next_cursor mientras has_more sea true.

Buscar conversaciones públicas de Reddit

Autentíquese con su clave de API de SocQ y envíe una palabra clave con un período de publicación. Las demás API de Reddit usan el mismo flujo de tarea.

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 frecuentes de la API de Reddit

Monitoreo de comunidades

Recopile publicaciones nuevas, principales o populares de subreddits seleccionados y compare la actividad visible entre comunidades.

Análisis de conversaciones y respuestas

Estudie el contenido de las publicaciones, el texto de los comentarios, las relaciones entre respuestas, los autores y la interacción al momento de la recopilación en conversaciones seleccionadas.

Investigación de temas y de mercado

Busque palabras clave y períodos definidos para encontrar conversaciones públicas sobre productos, marcas, competidores o tendencias.

Archivos y conjuntos de datos de investigación

Conserve publicaciones, comentarios, enlaces de origen, contexto de la comunidad, marcas de tiempo y métricas visibles para análisis repetibles.

Límites y política de datos públicos

Los resultados de Reddit son registros públicos de un momento determinado. Estas API no acceden a comunidades privadas, contenido eliminado, datos de cuentas ni controles de moderación.

  • Posts y Comments aceptan URL de publicaciones compatibles o enlaces redd.it. Subreddit Posts requiere una ruta /r/{subreddit} exacta.
  • Subreddit Posts admite el orden new, top o hot, con results_limit aplicado por separado a cada URL de subreddit.
  • Search acepta una consulta, un results_limit de 1 a 2,000 y un período de publicación de hora, día, semana, mes, año o todo el tiempo. No expone filtros de subreddit ni de orden.
  • Posts y Comments siguen siendo recursos separados; una publicación incluye comments_count, pero no los registros individuales de comentarios.
  • Comments devuelve los comentarios públicos visibles, pero no garantiza un árbol de respuestas completo ni la profundidad total del historial de la conversación.
  • Las métricas visibles son instantáneas asociadas a collected_at. Los campos opcionales pueden ser null o estar vacíos cuando la fuente pública no los expone.

Preguntas frecuentes sobre la API de Reddit

¿Qué es la API de Reddit?

La API de Reddit es un conjunto de endpoints de SocQ para obtener publicaciones y comentarios públicos conocidos, explorar publicaciones de subreddits y buscar conversaciones públicas por palabra clave y período de publicación.

¿Qué enlaces de Reddit se aceptan?

Posts y Comments aceptan rutas compatibles /r/{subreddit}/comments/{post_id} o enlaces redd.it. Subreddit Posts acepta una ruta /r/{subreddit} exacta.

¿Qué API de Reddit debo elegir?

Use Posts para una publicación conocida, Comments para sus respuestas públicas, Subreddit Posts para el listado de una comunidad y Search para el descubrimiento por palabra clave.

¿En qué se diferencian la exploración de subreddits y la búsqueda en Reddit?

Subreddit Posts explora publicaciones new, top o hot a partir de URL /r/{subreddit} exactas. Search encuentra publicaciones públicas a partir de una consulta de texto y un período de publicación.

¿Los comentarios y las métricas de interacción de Reddit son completos o en tiempo real?

No. Comments refleja las respuestas públicas visibles devueltas al momento de la recopilación, y los valores de interacción son instantáneas de un momento determinado, no un historial completo ni feeds en tiempo real.

¿Cuánto cuesta la recopilación de datos de Reddit?

Cada resultado de Posts o Subreddit Posts cuesta 0.5 créditos, cada comentario cuesta 0.3 créditos y cada resultado de Search cuesta 0.6 créditos; un conjunto de resultados vacío no tiene cargo por resultado.

Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.