SocQ ya cubría publicaciones, comentarios, listados de subreddits y búsqueda en Reddit. El 2026-11-17 añadió siete endpoints que responden a preguntas distintas: quién es este usuario de Reddit, qué publica y qué dice, y dónde está activo, además de qué es tendencia en todo Reddit y qué permite cada subreddit.
Esta guía explica qué devuelve cada nuevo endpoint, la solicitud, el precio y cuándo usarlo. Para la API oficial de Reddit, OAuth y los endpoints lanzados anteriormente, lea la guía de la API de Reddit y la comparativa de APIs de scraping de Reddit.
Respuesta rápida: envíe un nombre de usuario, la URL de un subreddit o ningún dato a uno de los siete endpoints
POST /v1/reddit/...conAuthorization: Bearer $SOCQ_API_KEY. ConsulteGET /v1/tasks/{task_id}hasta questatusseasucceededy leadata.results.items. Cinco endpoints cobran por resultado (0.3 o 0.5 créditos); Active Subreddits y Trending Searches cuestan 0.5 créditos por llamada. Un crédito equivale a $0.005.
Los siete nuevos endpoints de Reddit
| Endpoint | Qué devuelve | Precio |
|---|---|---|
| User Profile | Karma (de publicaciones y de comentarios), número de publicaciones y comentarios, antigüedad de la cuenta, descripción, avatar, trofeos e indicadores de cuenta verificada y de empleado | 0.5 créditos ($0.0025) por cuenta |
| User Posts | Las publicaciones de un usuario por new, top o hot, con texto completo, puntuación, comentarios y multimedia | 0.5 créditos ($0.0025) por publicación |
| User Comments | Los comentarios de un usuario con puntuación, fecha, enlace y la publicación en la que se dejó cada uno | 0.3 créditos ($0.0015) por comentario |
| User Active Subreddits | Subreddits en los que el usuario está activo, con número de miembros y descripción | 0.5 créditos ($0.0025) por llamada |
| Popular Feed | Publicaciones de r/popular por best, hot, new, top o rising | 0.5 créditos ($0.0025) por publicación |
| Trending Searches | Las búsquedas en tendencia de hoy en Reddit, ordenadas | 0.5 créditos ($0.0025) por llamada |
| Subreddit Rules | Reglas numeradas con título corto y texto completo | 0.5 créditos ($0.0025) por subreddit |
Investigar a un usuario de Reddit
Reddit User Profile
La Reddit User Profile API devuelve una fila por cuenta: el karma total dividido en karma de publicaciones y de comentarios, cuántas publicaciones y comentarios ha hecho la cuenta, cuándo se creó, la descripción y el avatar del perfil, el número de trofeos e indicadores de cuentas verificadas y de empleados de Reddit. Úsela para evaluar a un creador antes de contactarlo o para valorar la trayectoria de los autores de un hilo.
curl -X POST "https://api.socq.ai/v1/reddit/user-profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"usernames": ["spez", "GovSchwarzenegger"]
}'
Envíe hasta 100 nombres de usuario, con o sin el prefijo u/. Consulte la documentación de User Profile.
Reddit User Posts
La Reddit User Posts API obtiene el historial de publicaciones de un usuario con el texto completo de las publicaciones de texto, el enlace, la puntuación, el número de comentarios, la fecha de publicación y las imágenes o vídeos. Ordene por new para seguir lo que alguien comparte ahora, o por top para ver qué publicaciones funcionaron mejor.
curl -X POST "https://api.socq.ai/v1/reddit/user-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "spez",
"sort_by": "new",
"results_limit": 25
}'
sort_by es new (por defecto), top o hot. results_limit es 25 por defecto y acepta de 1 a 1,000. likes_count contiene la puntuación de la publicación. Consulte la documentación de User Posts.
Reddit User Comments
El historial de comentarios muestra lo que alguien sabe y le importa mejor que sus propias publicaciones. La Reddit User Comments API devuelve cada comentario con su puntuación, fecha, un enlace al comentario y el post_id de la publicación en la que se dejó. Úsela para identificar expertos y clientes potenciales, o para seguir cómo habla una cuenta de su producto.
curl -X POST "https://api.socq.ai/v1/reddit/user-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "spez",
"sort_by": "top",
"results_limit": 100
}'
results_limit es 100 por defecto y acepta de 1 a 1,000. text contiene una vista previa de hasta 300 caracteres; url abre el comentario completo. Consulte la documentación de User Comments.
Reddit User Active Subreddits
La Reddit User Active Subreddits API enumera las comunidades en las que un usuario ha publicado o comentado recientemente, cada una con su número de miembros y su descripción. Sirve para trazar los intereses de una persona y le señala las comunidades de nicho que usa su audiencia.
curl -X POST "https://api.socq.ai/v1/reddit/user-active-subreddits" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "GovSchwarzenegger"
}'
Una solicitud cuesta 0.5 créditos y devuelve todas las comunidades de la lista pública de actividad de la cuenta. Consulte la documentación de Active Subreddits.
Seguir lo que es tendencia en Reddit
Reddit Popular Feed
La Reddit Popular Feed API lee r/popular tal como lo muestra Reddit: publicaciones que suben en todas las comunidades, con título y cuerpo, enlace, autor, puntuación, número de comentarios y multimedia. Cambie sort_by a top y establezca published_within para ver qué destacó en un día o una semana.
curl -X POST "https://api.socq.ai/v1/reddit/popular-feed" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sort_by": "hot",
"results_limit": 25
}'
Todos los campos son opcionales. sort_by es best, hot (por defecto), new, top o rising; published_within se aplica a top y va de hour a all. results_limit es 25 por defecto y acepta de 1 a 500. Consulte la documentación de Popular Feed.
Reddit Trending Searches
La Reddit Trending Searches API devuelve las búsquedas en tendencia de hoy en el orden en que Reddit las muestra; a menudo son noticias, lanzamientos de productos y momentos culturales a medida que ocurren. Consúltela varias veces al día para un panel de tendencias y profundice en un tema con Reddit Search.
curl -X POST "https://api.socq.ai/v1/reddit/trending-searches" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
No requiere ningún dato de entrada. Cada llamada devuelve la lista actual, normalmente seis búsquedas, ordenadas desde el 1. Consulte la documentación de Trending Searches.
Revisar las reglas de un subreddit antes de publicar
La Reddit Subreddit Rules API devuelve una fila por subreddit con sus reglas numeradas en orden, cada una con el título corto que los moderadores muestran en el menú de denuncias y el texto completo de la regla. Las marcas la usan para comprobar qué está permitido antes de una publicación de lanzamiento; los equipos que gestionan muchas cuentas mantienen un reglamento por comunidad.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-rules" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.reddit.com/r/AskReddit/"]
}'
Consulte la documentación de Subreddit Rules.
Autenticación y flujo de tareas asíncronas
Cada solicitud incluye su clave de API y un tipo de contenido JSON:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Cada envío inicia una tarea en segundo plano (submit -> task_id -> queued -> running -> succeeded, o failed). La respuesta del envío devuelve data.task_id y data.status. Consulte la tarea:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Mientras la tarea está en queued, running o failed, la respuesta contiene solo los metadatos de la tarea; en failed, lea error_message. Cuando está en succeeded, la respuesta incluye la primera página de registros normalizados en data.results.items. limit es 50 por defecto y admite hasta 500. Si has_more es true, pase results.next_cursor como cursor. fields acepta hasta 50 campos o rutas con puntos separados por comas.
Un tiempo de espera agotado en el cliente no cancela la tarea; reanude con el mismo task_id en lugar de pagar por un duplicado. También puede añadir callback_url al cuerpo del envío para recibir un único POST con un resumen de la tarea cuando esta termine.
Cuánto cuesta un trabajo típico
- Perfilar a 100 autores de un hilo: 100 × 0.5 = 50 créditos, $0.25.
- Análisis completo de un usuario (25 publicaciones, 100 comentarios, subreddits activos): 12.5 + 30 + 0.5 = 43 créditos, $0.215.
- Búsquedas en tendencia cuatro veces al día durante 30 días: 120 × 0.5 = 60 créditos, $0.30.
Preguntas frecuentes
¿Puedo consultar muchos usuarios de Reddit a la vez?
User Profile acepta hasta 100 nombres de usuario por solicitud. User Posts, User Comments y Active Subreddits aceptan un solo username cada uno, así que envíe una tarea por usuario.
¿User Comments devuelve el texto completo del comentario?
text contiene una vista previa de hasta 300 caracteres. El campo url abre el comentario completo y post_id identifica la publicación en la que se dejó.
¿En qué se diferencia Popular Feed de Subreddit Posts?
Popular Feed lee r/popular, que mezcla publicaciones que suben en todas las comunidades. Para leer una sola comunidad, use Subreddit Posts.
¿Pago si un usuario no tiene publicaciones?
Los endpoints por resultado no tienen tarifa base, así que un resultado vacío no cuesta nada. Active Subreddits y Trending Searches son llamadas con tarifa fija de 0.5 créditos.
¿Dónde puedo comparar proveedores de datos de Reddit?
Consulte alternativas a la API de Reddit. Todos los endpoints de Reddit de SocQ están en la página de la plataforma Reddit, con las tarifas actuales en la página de precios.
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