Reddit Popular Feed
El feed popular de Reddit, r/popular, es el flujo de publicaciones que suben al mismo tiempo en las distintas comunidades del sitio, cada una con su título y cuerpo, autor, puntaje, cantidad de comentarios, hora de publicación e imágenes o videos adjuntos. Leído con distintos órdenes y ventanas de tiempo, muestra qué historias, formatos y temas se abren paso en toda la plataforma, algo útil para detectar noticias a tiempo, investigar formatos de contenido y tomar el pulso de lo que se comenta en Reddit.
Funcionalidades de la Reddit Popular Feed API
- Cinco formas de ordenar r/popularsort_by lee el feed como best, hot, new, rising o top, y se usa hot cuando el campo se omite.
- Ventana de tiempo para el orden toppublished_within acota top a la última hora, día, semana, mes o año, o a todo el historial, con day como valor predeterminado.
- Registros completos con autor y contenido multimediaCada fila trae text con título y cuerpo, la url de la publicación, el nombre de usuario y el enlace al perfil del autor, el puntaje en likes_count, comments_count y media con sus dimensiones en píxeles.
Parámetros de la Reddit Popular Feed API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
sort_by | Opcional | Orden de r/popular: best, hot (predeterminado), new, rising o top. |
published_within | Opcional | Ventana de tiempo que se aplica cuando sort_by es top: hour, day (predeterminado), week, month, year o all. |
results_limit | Opcional | Cantidad máxima de publicaciones que se recopilan, un entero de 1 a 500; el valor predeterminado es 25. |
Cómo usar la Reddit Popular Feed API
Elija un orden y un límite, o envíe un cuerpo vacío, y luego recorra las páginas del feed.
- Envíe {"sort_by": "hot", "results_limit": 25} por POST a /v1/reddit/popular-feed.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea las publicaciones en results.items y cargue más páginas con results.next_cursor mientras has_more sea true.
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}'Casos de uso de la Reddit Popular Feed API
- Detectar historias antes de que lleguen a su pico: Consulte sort_by rising o new de forma periódica y observe published_at, likes_count y comments_count para ver qué publicaciones ganan velocidad en r/popular.
- Resumen semanal de las publicaciones top: Pida sort_by top con published_within week y liste la url, el text y el puntaje de lo que destacó en los últimos siete días.
- Investigar qué formatos llegan a r/popular: Agrupe las publicaciones por tipo de contenido multimedia en imagen, video y solo texto, y compare likes_count y comments_count entre los grupos.
Consejos de expertos para la Reddit Popular Feed API
- Ponga sort_by en top siempre que use published_within, porque la ventana de tiempo solo se aplica al orden top.
- Guarde collected_at con cada captura y elimine duplicados por id, ya que la misma publicación puede aparecer en consultas consecutivas de un feed que cambia rápido.
- Envíe author.username a Reddit User Profile API cuando un autor aparezca una y otra vez, para revisar su karma y la antigüedad de su cuenta.
APIs relacionadas
Además de la Reddit Popular Feed 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 Search API — Busca publicaciones públicas de Reddit por consulta de texto y período de publicación, y devuelve contenido normalizado, autores, contexto de la comunidad, marcas de tiempo, contenido multimedia e interacción visible.
- Reddit User Posts API — Recolecta el historial de publicaciones de un usuario de Reddit a partir de su nombre, en orden new, top o hot, con título y cuerpo, puntaje, comentarios y contenido multimedia.
- 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.