RedditGuía de APIPublicacionesComentarios

Guía de la API de Reddit: acceso a publicaciones, comentarios y datos de búsqueda en 2026

Guía práctica 2026 sobre el acceso a la API de Reddit, OAuth, límites de solicitudes, reglas de uso comercial y cómo recopilar publicaciones y comentarios públicos con endpoints normalizados de SocQ.

SocQActualizado el 9 de noviembre de 202613 min de lectura

La forma correcta de integrar Reddit depende de lo que realmente haga su producto. Un bot de moderación instalado dentro de una comunidad, un cliente OAuth sin fines comerciales, un estudio académico y un producto comercial de escucha social no tienen el mismo camino de acceso ni las mismas responsabilidades.

Esta guía explica las opciones oficiales vigentes de Reddit y muestra cómo obtener publicaciones públicas, comentarios, feeds de subreddits, metadatos de subreddits y resultados de búsqueda con SocQ, cuando su aplicación necesita un endpoint de datos administrado y de solo lectura.

Respuesta rápida: use la Developer Platform oficial de Reddit para las aplicaciones que se ejecutan dentro de Reddit y solicite la Data API oficial cuando su caso de uso se ajuste a sus políticas. Use SocQ cuando necesite una sola clave de API y registros públicos de Reddit normalizados junto con otras plataformas sociales. Ninguna de las dos vías da permiso para ignorar los términos de Reddit, los requisitos sobre contenido eliminado, los derechos de privacidad ni las restricciones sobre el entrenamiento de modelos.

Los requisitos de acceso y las políticas se verificaron el 19 de julio de 2026. Reddit puede cambiar las reglas de aprobación y los límites, así que revise la documentación oficial enlazada antes del lanzamiento.

¿Qué API de Reddit conviene usar?

Reddit describe actualmente varias interfaces para desarrolladores, cada una con un propósito distinto:

ProductoDiseñado paraLímite importante
Developer Platform (Devvit)Juegos, utilidades y aplicaciones de moderación que se ejecutan dentro de RedditLa aplicación se construye para la experiencia de Reddit
Data APIAcceso programático aprobado para leer o modificar datos de RedditAplican OAuth, revisión, políticas y límites de solicitudes
Reddit for ResearchersInvestigación académica elegibleVía oficial de investigación; requiere solicitud
Ads APIAnunciantes que administran campañas y reportesFlujos de publicidad, no datos generales de comunidades
Reddit EmbedsMostrar contenido individual de RedditPresentación, no acceso masivo a datos
API administrada de datos públicosFlujos de producto que necesitan registros públicos en un esquema estableSiguen aplicando la cobertura y los términos del proveedor

La descripción general del acceso para desarrolladores de Reddit indica que la Data API es para desarrolladores aprobados y que la investigación académica debe pasar por Reddit for Researchers. El uso comercial requiere el permiso de Reddit y un contrato.

Por lo tanto, la decisión sobre la API debe comenzar por clasificar el caso de uso, no por elegir una biblioteca de código.

Requisitos de la Data API oficial de Reddit en 2026

Para el uso gratuito elegible de la Data API, Reddit exige actualmente un token OAuth registrado y un User-Agent descriptivo. El tráfico sin autenticación puede ser bloqueado en lugar de recibir la cuota estándar.

El wiki oficial de la Data API de Reddit indica un límite de 100 consultas por minuto por ID de cliente OAuth, calculado como promedio en una ventana de diez minutos. Los clientes deben leer:

  • X-Ratelimit-Used
  • X-Ratelimit-Remaining
  • X-Ratelimit-Reset

No trate las 100 QPM como un nivel comercial universal. Es el límite publicado para quienes son elegibles para el acceso gratuito. Reddit indica que el uso comercial – incluidos los productos de pago, los productos financiados con publicidad, los servicios por suscripción y los servicios que se venden a cambio de una tarifa – requiere permiso previo. El acceso más amplio o de pago se gestiona por separado, no mediante una tabla de precios pública de autoservicio.

Reddit también exige el manejo de eliminaciones. Su guía vigente señala que el contenido almacenado que se elimine de Reddit debe eliminarse de sus sistemas y que debe quitarse la información que identifica a la persona autora asociada con una cuenta eliminada. La documentación recomienda eliminar de forma rutinaria los datos y el contenido de usuarios almacenados en un plazo de 48 horas para facilitar el cumplimiento.

Ejemplo de autenticación con la API oficial

Una aplicación instalada o de tipo script suele intercambiar sus credenciales de cliente y la autorización del usuario por un token OAuth, y luego envía ese token a oauth.reddit.com.

La forma simplificada de la solicitud es esta:

curl "https://oauth.reddit.com/r/learnpython/new?limit=25" \
  -H "Authorization: Bearer $REDDIT_ACCESS_TOKEN" \
  -H "User-Agent: web:socq-guide:v1.0 (by /u/your_username)"

Los clientes de producción deben:

  1. Registrarse y obtener la aprobación para el caso de uso correcto.
  2. Implementar el tipo de autorización OAuth que corresponda.
  3. renovar los tokens que vencen, cuando se admita.
  4. Enviar un User-Agent veraz y único.
  5. Respetar los encabezados de límite de solicitudes y reducir el ritmo antes de agotarlo.
  6. Procesar las eliminaciones y los cambios de política.

Los desarrolladores de Python suelen usar PRAW para manejar los objetos de listado, la paginación y los detalles de OAuth. El HTTP directo puede ser apropiado cuando se quieren menos dependencias, pero no elimina ninguna obligación de política.

Obtener una publicación de Reddit por URL con SocQ

Reddit Posts API de SocQ acepta URL públicas de publicaciones de Reddit y enlaces cortos de redd.it. Devuelve título, cuerpo, autor, contexto de la comunidad, marcas de tiempo, referencias públicas a medios e interacción visible, todo normalizado.

curl -X POST "https://api.socq.ai/v1/reddit/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.reddit.com/r/learnpython/comments/POST_ID/POST_SLUG/"
    ]
  }'

La solicitud crea una tarea asíncrona. Guarde el task_id devuelto y luego consulte el estado:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=100" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Cuando la tarea termina con éxito, los registros están en data.results.items. Continúe con next_cursor mientras has_more sea true.

Un registro de publicación usa la misma estructura general que los demás recursos de SocQ:

{
  "id": "post_id",
  "platform": "reddit",
  "resource": "posts",
  "type": "post",
  "url": "https://www.reddit.com/r/learnpython/comments/post_id/example/",
  "name": "Example post title",
  "text": "Example post body",
  "author": {
    "username": "example_user",
    "name": "example_user"
  },
  "metrics": {
    "upvotes_count": 842,
    "comments_count": 54,
    "upvote_ratio": 0.96
  },
  "created_at": "2026-07-16T08:00:00Z",
  "collected_at": "2026-07-19T08:00:00Z",
  "extra": {
    "tag": "Discussion",
    "community_name": "learnpython"
  }
}

Los puntajes visibles son instantáneas, no una verdad permanente. Reddit puede alterar el conteo de votos, el contenido puede editarse o eliminarse, y una recopilación posterior puede arrojar resultados distintos.

Obtener los comentarios de Reddit

Use Reddit Comments API cuando necesite la discusión pública de publicaciones cuyas URL ya conoce:

curl -X POST "https://api.socq.ai/v1/reddit/comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.reddit.com/r/learnpython/comments/POST_ID/POST_SLUG/"
    ]
  }'

Los registros de comentarios normalizados incluyen:

  • ID, URL y texto del comentario.
  • Campos públicos del autor, cuando están disponibles.
  • Conteos visibles de votos positivos y de respuestas.
  • Referencias a la publicación de origen y a la comunidad.
  • ID del comentario padre, cuando está disponible.
  • Marcas de tiempo de publicación y de recopilación.

El endpoint actual de SocQ no acepta un parámetro de entrada results_limit. No suponga que se devolverá cada rama visible, cada respuesta contraída, cada comentario eliminado, cada elemento exclusivo de moderadores ni cada resultado clasificado de forma dinámica. Si la reconstrucción completa del hilo es un requisito indispensable, pruebe hilos representativos, profundos y extensos antes de elegir un proveedor.

Obtener publicaciones nuevas, principales o populares de un subreddit

Para el monitoreo de comunidades, Reddit Subreddit Posts API acepta una o varias URL públicas de subreddits. sort_by admite new, top y hot; results_limit acepta de 1 a 2,000 por cada subreddit enviado.

curl -X POST "https://api.socq.ai/v1/reddit/subreddit-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.reddit.com/r/learnpython/",
      "https://www.reddit.com/r/webdev/"
    ],
    "sort_by": "new",
    "results_limit": 250
  }'

Elija el orden con criterio:

OrdenMejor usoLimitación
newMonitoreo incremental y alertasIncluye más publicaciones de poco valor
hotAtención actual de la comunidadLa clasificación cambia continuamente
topDescubrimiento de contenido con mucha interacciónPuede sobrerrepresentar contenido más antiguo o que ya es popular

Para el monitoreo, recopile new de forma programada y elimine duplicados por ID de publicación. Use hot o top como una vista de descubrimiento independiente, en lugar de sobrescribir el feed cronológico.

Buscar publicaciones de Reddit por palabra clave

Reddit Search API acepta una consulta, un límite de resultados de 1 a 2,000 y una ventana de publicación:

curl -X POST "https://api.socq.ai/v1/reddit/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "\"social listening\" API",
    "results_limit": 500,
    "published_within": "month"
  }'

Las ventanas admitidas son hour, day, week, month, year y all.

Los resultados de búsqueda son resultados de descubrimiento clasificados, no un archivo exhaustivo garantizado. La sintaxis de la consulta, la clasificación, la disponibilidad y la indexación pueden afectar la cobertura. Ejecute varias consultas específicas en lugar de esperar que una sola consulta amplia represente toda la conversación.

Para el monitoreo de marca, por ejemplo, use un conjunto de consultas:

"Acme Cloud"
acmecloud
"Acme API"
"Acme Cloud" pricing
"Acme Cloud" alternative

Guarde la consulta en el contexto de descubrimiento para que los analistas puedan explicar por qué cada registro entró al conjunto de datos.

Detalles de un subreddit y búsqueda dentro de un subreddit

Otros dos endpoints cubren la comunidad en sí. Reddit Subreddit Details API toma URL públicas de subreddits y devuelve metadatos como el número de suscriptores, los usuarios activos semanales, las reglas y los recursos de la comunidad. Es una forma económica de evaluar una comunidad antes de monitorearla.

Reddit Subreddit Search API busca discusiones y publicaciones públicas dentro de un subreddit específico, según la consulta, el período y el orden. Úselo cuando un término de marca solo sea relevante en unas pocas comunidades y una búsqueda en todo Reddit lo dejaría enterrado. Consulte la página de cada endpoint para conocer los campos de entrada exactos.

Cómo construir un pipeline confiable de monitoreo de Reddit

Un flujo de trabajo duradero separa la recopilación, el almacenamiento y el análisis:

Query/subreddit registry
        ↓
Scheduled SocQ submissions
        ↓
Task polling with backoff
        ↓
Normalize + deduplicate by Reddit ID
        ↓
Deletion/retention controls
        ↓
Classification, alerts and reporting

Reglas de implementación recomendadas:

  1. Use ID estables. Las URL y los slugs pueden cambiar; los ID de Reddit son mejores claves para eliminar duplicados.
  2. Conserve el contexto de origen. Guarde el subreddit, la consulta, el orden y la hora de recopilación.
  3. Separe las instantáneas de las entidades. Las métricas cambian, mientras que el ID de la publicación permanece estable.
  4. Reintente tareas, no registros individuales. El retroceso exponencial evita envíos duplicados.
  5. Registre los estados ausente y eliminado. No convierta una ausencia en una publicación vacía pero válida.
  6. Minimice los datos personales. La mayoría de los análisis no necesita historiales de autores a largo plazo.
  7. Agregue una vía de supresión. Su modelo de datos debe poder eliminar el contenido y las referencias a los autores.

API oficial de Reddit frente a SocQ

RequisitoAPI oficial de RedditSocQ
Crear una aplicación o herramienta de moderación en RedditLa mejor opciónNo compatible
Acciones de lectura y escritura en RedditCompatible, sujeto a aprobación y permisosDatos públicos de solo lectura
OAuth y registro de la aplicación en RedditObligatorioClave de API de SocQ
Normalización de publicaciones y comentarios públicosObjetos nativos de RedditEsquema compartido de SocQ
Producto social multiplataformaIntegraciones separadasEl mismo modelo de tareas en 27 plataformas
Límite de solicitudes gratuito publicado100 QPM para clientes OAuth elegiblesPrecios por endpoint en el catálogo de SocQ
Permiso comercialDebe obtener el permiso o contrato de RedditEl acceso del proveedor no exime de las reglas de Reddit
Investigación académicaSe requiere Reddit for ResearchersNo usar como una forma de eludir la política

Elija la vía oficial si su producto realiza acciones autorizadas por el usuario, moderación, publicaciones, votos, mensajería o integraciones profundas nativas de Reddit. Elija SocQ para la recopilación de datos públicos compatible cuando los registros normalizados y multiplataforma y la extracción administrada importen más que el acceso de escritura.

Cómo estimar la carga de trabajo y el costo

No compare proveedores solo por “solicitudes”. Una solicitud puede devolver una publicación, una página de comentarios o cientos de resultados de un subreddit.

Estime:

monthly records =
  direct post lookups
  + comments returned
  + subreddit posts returned
  + search results returned

monthly workload =
  schedules × inputs per run × average records per input

Luego considere:

  • Resultados vacíos o no disponibles.
  • Frecuencia de actualización.
  • Superposición de búsquedas y eliminación de duplicados.
  • Hilos de comentarios profundos.
  • Almacenamiento y procesamiento de eliminaciones.
  • Requisitos de concurrencia y latencia.
  • Si solo se facturan los resultados exitosos.

Ejecute un piloto representativo con comunidades pequeñas y grandes antes de proyectar el gasto anual.

Uso responsable y retención de datos

Que los datos sean públicos no equivale a un permiso general para cualquier uso. Las políticas vigentes de Reddit restringen el acceso comercial sin aprobación y prohíben usar el contenido de Reddit para entrenar modelos sin consentimiento explícito. Además, imponen obligaciones de eliminación.

Implemente los siguientes controles antes de escalar:

  • Recopile solo los campos necesarios para el propósito declarado.
  • Evite perfilar a personas sensibles y el acoso individual.
  • No use la API para eludir restricciones de subreddits o cuentas.
  • Conserve la atribución de la fuente cuando se muestre el contenido.
  • Defina períodos de retención cortos para el contenido sin procesar.
  • Vuelva a verificar o elimine el contenido que ya no esté disponible.
  • Proteja las claves de API y audite el acceso a las exportaciones.
  • Obtenga una revisión legal para usos comerciales, de investigación o de alto riesgo.

SocQ es una capa técnica de acceso, no una concesión de derechos de propiedad intelectual, privacidad, investigación o uso comercial.

API de Reddit: preguntas frecuentes (FAQ)

¿La API de Reddit es gratis?

Reddit ofrece acceso gratuito y de pago según el caso de uso. Los clientes elegibles de la Data API con acceso gratuito tienen actualmente un límite publicado de 100 QPM por ID de cliente OAuth. El uso comercial requiere el permiso de Reddit y puede requerir un contrato y tarifas.

¿Se puede usar la API de Reddit sin OAuth?

No diseñe su solución en torno al acceso sin autenticación. La documentación vigente de Reddit exige tokens OAuth registrados e indica que el tráfico sin OAuth ni credenciales de inicio de sesión será bloqueado.

¿Puedo hacer scraping de Reddit para entrenar IA?

Reddit indica que su contenido no puede usarse como insumo para entrenar modelos sin consentimiento explícito. Una API de terceros no elimina esa restricción.

¿SocQ admite los comentarios de Reddit?

Sí. SocQ tiene seis endpoints de Reddit: publicaciones directas, comentarios a partir de URL de publicaciones, descubrimiento de publicaciones de un subreddit, detalles de un subreddit, búsqueda por palabra clave en todo Reddit y búsqueda dentro de un solo subreddit.

¿SocQ puede publicar, votar o moderar en Reddit?

No. Los endpoints de Reddit de SocQ recopilan registros públicos compatibles. Use los productos oficiales para desarrolladores de Reddit para las acciones de escritura autorizadas y la moderación.

¿Los resultados de búsqueda de Reddit son exhaustivos?

No. Trate la búsqueda como un descubrimiento clasificado. Los resultados dependen de la consulta, la ventana de tiempo, la indexación y la disponibilidad; no son un archivo histórico completo.

¿Qué ocurre cuando un usuario de Reddit elimina contenido?

Su sistema debe poder eliminar el contenido y la información relacionada que identifica a la persona autora. La guía oficial de Reddit recomienda eliminar de forma rutinaria los datos y el contenido de usuarios almacenados en un plazo de 48 horas para simplificar el cumplimiento.

REDDIT API

Probar el flujo de trabajo con una URL pública de Reddit

Envíe entradas públicas y reciba registros normalizados con contexto de origen rastreable.

Ver las API de Reddit