Reddit Posts
Una publicación de Reddit es un envío a una comunidad cuya página pública puede exponer un título, un cuerpo, un autor, una etiqueta (flair), contenido multimedia, la hora de publicación y las señales visibles de votos y comentarios. Vincular esos campos con el subreddit y el momento de captura hace que cada publicación sirva para revisar fuentes, analizar contenido y comparar con marca de tiempo.
Funcionalidades de la Reddit Posts API
- Resolución directa de publicacionesResuelve la URL de una conversación de Reddit aceptada, o un enlace corto de redd.it, en un registro normalizado de esa publicación pública, y rechaza las páginas de inicio de subreddits y las rutas no relacionadas.
- Contenido y atribución de la publicaciónDevuelve el ID de la publicación, la URL pública, el título, el texto del cuerpo y los identificadores del autor disponibles, para que cada elemento pueda rastrearse hasta su fuente.
- Contexto del subreddit y clasificaciónExpone el flair junto con el nombre, la URL y el número visible de miembros de la comunidad en extra, cuando la fuente los proporciona.
- Contenido multimedia, interacción y momento de capturaMantiene juntos en una instantánea con marca de tiempo las referencias multimedia, created_at, collected_at, upvotes_count, comments_count y upvote_ratio.
Parámetros de la Reddit Posts API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista obligatoria de URL de publicaciones públicas de Reddit que usen rutas /r/{subreddit}/comments/{post_id} en los hosts de Reddit compatibles, o enlaces cortos de redd.it. |
Cómo usar la Reddit Posts API
Envíe las publicaciones públicas exactas que necesita, siga la tarea asíncrona y lea los registros normalizados con paginación por cursor.
- Prepare una o más URL de publicaciones públicas de Reddit con una ruta de comentarios compatible, o enlaces cortos de redd.it.
- Envíe los enlaces como urls a /v1/reddit/posts y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
- Lea data.results.items y luego solicite el next_cursor devuelto mientras has_more siga en true.
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/example/comments/post_id/example_post/"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la Reddit Posts API
- Revisión de publicaciones con respaldo de la fuente: Conserve los ID, las URL, los títulos, el texto del cuerpo y los campos de autor de las publicaciones, para que quienes revisan puedan volver a consultar los envíos públicos exactos incluidos en un análisis.
- Comparación de temas entre comunidades: Agrupe los títulos y el texto del cuerpo por community_name y tag para examinar cómo se plantea un tema definido en subreddits seleccionados.
- Seguimiento de la interacción con marca de tiempo: Almacene upvotes_count, comments_count y upvote_ratio junto con collected_at para comparar instantáneas repetidas sin tratar los valores como permanentes.
Consejos de expertos para la Reddit Posts API
- Resuelva los enlaces de redd.it y elimine los duplicados por identificador de publicación antes de armar el lote, porque un enlace corto y la URL completa de la conversación pueden apuntar a la misma publicación.
- Use este endpoint cuando ya conozca las URL de las publicaciones; no acepta páginas de inicio de subreddits, consultas de búsqueda, controles de orden ni results_limit.
- Admita que el autor, el contenido multimedia, tag, los detalles de la comunidad, las marcas de tiempo y las métricas sean nulos cuando la fuente pública no los exponga.
- Almacene collected_at junto a las métricas de interacción visibles para poder comparar instantáneas posteriores sin sobrescribir sus momentos de observación.
APIs relacionadas
Además de la Reddit Posts API, use estas APIs cuando necesite otro tipo de datos públicos de Reddit.
- 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 Subreddit Details API
- 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 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.