Reddit User Posts
El historial de publicaciones de un usuario de Reddit es la lista de envíos que una cuenta ha hecho en distintas comunidades, cada uno con su título y cuerpo, enlace, hora de publicación, puntaje neto, cantidad de comentarios e imágenes o videos adjuntos. Leído por fecha o por puntaje, muestra qué comparte una persona, cuáles de sus temas ganan tracción y cómo cambia su producción con el tiempo, lo que alimenta la investigación de creadores de contenido, el seguimiento de la cuenta de un fundador y la recopilación de los textos extensos de un especialista.
Funcionalidades de la Reddit User Posts API
- Un nombre de usuario, hasta 1,000 publicacionesusername recibe una sola cuenta, con o sin el prefijo u/, y results_limit recopila entre 1 y 1,000 de sus publicaciones, 25 de forma predeterminada.
- Título y cuerpo en un solo campo de textotext empieza con el título de la publicación y, en las publicaciones de texto, sigue con una línea en blanco y el cuerpo completo, así que un solo campo contiene todo lo escrito.
- Puntaje neto y cantidad de comentariosmetrics.likes_count es el puntaje de la publicación, votos positivos menos negativos, y metrics.comments_count muestra cuánta conversación generó.
- Imágenes, galerías y videos alojadosmedia enumera cada imagen o video adjunto con su url, imagen de vista previa y ancho y alto en píxeles, listos para miniaturas o descargas.
Parámetros de la Reddit User Posts API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
username | Obligatorio | Un nombre de usuario de Reddit, con o sin el prefijo u/, formado por 3 a 20 letras, dígitos, guiones o guiones bajos. |
sort_by | Opcional | Orden de las publicaciones: new (predeterminado), top o hot. |
results_limit | Opcional | Cantidad máxima de publicaciones que se recopilan, un entero de 1 a 1,000; el valor predeterminado es 25. |
Cómo usar la Reddit User Posts API
Envíe un nombre de usuario con un orden y un límite, y luego recorra las páginas de publicaciones.
- Envíe {"username": "spez", "sort_by": "new", "results_limit": 25} por POST a /v1/reddit/user-posts.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea las publicaciones en results.items y, mientras has_more sea true, pase results.next_cursor para cargar la página siguiente.
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}'Casos de uso de la Reddit User Posts API
- Seguir los envíos más recientes de una cuenta: Ejecute sort_by new de forma periódica y lea published_at y url para detectar cada nueva publicación de la cuenta de un fundador, un periodista o un competidor.
- Clasificar las publicaciones con más puntaje de un usuario: Pida sort_by top y compare likes_count con comments_count para ver qué temas y formatos de una persona obtuvieron la mejor respuesta.
- Armar un corpus con los textos de un especialista: Guarde el text de las publicaciones de texto con su url y published_at para reunir un conjunto de datos con las explicaciones extensas de un especialista.
Consejos de expertos para la Reddit User Posts API
- Divida text en la primera línea en blanco para separar el título del cuerpo; las publicaciones de enlace o con contenido multimedia solo contienen su título.
- Al revisar si una cuenta tiene publicaciones nuevas con sort_by new, conserve los id que ya guardó y deje de leer páginas en cuanto aparezca un id conocido.
- Recopile el mismo nombre de usuario con Reddit User Comments API cuando necesite toda la actividad de la cuenta, ya que allí se devuelven sus respuestas en los hilos de otras personas.
APIs relacionadas
Además de la Reddit User Posts 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 User Profile API — Consulta cuentas de Reddit por nombre de usuario, con el karma total, de publicaciones y de comentarios, conteos de actividad, antigüedad de la cuenta e indicadores del perfil.
- Reddit User Active Subreddits API — Lista los subreddits en los que está activo un usuario de Reddit a partir de su nombre, con la cantidad de miembros y la descripción de cada uno.
- Reddit Popular Feed API — Recolecta publicaciones de r/popular en orden hot, best, new, rising o top, con título y cuerpo, autor, puntaje, comentarios y contenido multimedia.