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:
| Producto | Diseñado para | Límite importante |
|---|---|---|
| Developer Platform (Devvit) | Juegos, utilidades y aplicaciones de moderación que se ejecutan dentro de Reddit | La aplicación se construye para la experiencia de Reddit |
| Data API | Acceso programático aprobado para leer o modificar datos de Reddit | Aplican OAuth, revisión, políticas y límites de solicitudes |
| Reddit for Researchers | Investigación académica elegible | Vía oficial de investigación; requiere solicitud |
| Ads API | Anunciantes que administran campañas y reportes | Flujos de publicidad, no datos generales de comunidades |
| Reddit Embeds | Mostrar contenido individual de Reddit | Presentación, no acceso masivo a datos |
| API administrada de datos públicos | Flujos de producto que necesitan registros públicos en un esquema estable | Siguen 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-UsedX-Ratelimit-RemainingX-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:
- Registrarse y obtener la aprobación para el caso de uso correcto.
- Implementar el tipo de autorización OAuth que corresponda.
- renovar los tokens que vencen, cuando se admita.
- Enviar un User-Agent veraz y único.
- Respetar los encabezados de límite de solicitudes y reducir el ritmo antes de agotarlo.
- 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:
| Orden | Mejor uso | Limitación |
|---|---|---|
new | Monitoreo incremental y alertas | Incluye más publicaciones de poco valor |
hot | Atención actual de la comunidad | La clasificación cambia continuamente |
top | Descubrimiento de contenido con mucha interacción | Puede 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:
- Use ID estables. Las URL y los slugs pueden cambiar; los ID de Reddit son mejores claves para eliminar duplicados.
- Conserve el contexto de origen. Guarde el subreddit, la consulta, el orden y la hora de recopilación.
- Separe las instantáneas de las entidades. Las métricas cambian, mientras que el ID de la publicación permanece estable.
- Reintente tareas, no registros individuales. El retroceso exponencial evita envíos duplicados.
- Registre los estados ausente y eliminado. No convierta una ausencia en una publicación vacía pero válida.
- Minimice los datos personales. La mayoría de los análisis no necesita historiales de autores a largo plazo.
- 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
| Requisito | API oficial de Reddit | SocQ |
|---|---|---|
| Crear una aplicación o herramienta de moderación en Reddit | La mejor opción | No compatible |
| Acciones de lectura y escritura en Reddit | Compatible, sujeto a aprobación y permisos | Datos públicos de solo lectura |
| OAuth y registro de la aplicación en Reddit | Obligatorio | Clave de API de SocQ |
| Normalización de publicaciones y comentarios públicos | Objetos nativos de Reddit | Esquema compartido de SocQ |
| Producto social multiplataforma | Integraciones separadas | El mismo modelo de tareas en 27 plataformas |
| Límite de solicitudes gratuito publicado | 100 QPM para clientes OAuth elegibles | Precios por endpoint en el catálogo de SocQ |
| Permiso comercial | Debe obtener el permiso o contrato de Reddit | El acceso del proveedor no exime de las reglas de Reddit |
| Investigación académica | Se requiere Reddit for Researchers | No 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