Reddit Subreddit Posts
Las publicaciones de un subreddit son envíos públicos a una comunidad, con títulos, texto del cuerpo, autores, flair, contenido multimedia, horas de publicación y las señales visibles de votos y comentarios. Estos campos de contenido, contexto e interacción sirven para monitorear comunidades, investigar temas y hacer comparaciones alineadas entre listados de subreddits.
Funcionalidades de la Reddit Subreddit Posts API
- Descubrimiento a partir del listado de un subredditDescubre publicaciones públicas a partir de URL /r/{subreddit} aceptadas y permite elegir el listado new, top o hot para todos los subreddits de la solicitud.
- Profundidad de recopilación por subredditAplica results_limit por separado a cada URL de subreddit enviada, con un valor predeterminado de 100 y un rango aceptado de 1 a 2,000.
- Contenido y autores de publicaciones normalizadosDevuelve los identificadores de las publicaciones, las URL de origen, los títulos, el texto del cuerpo, los campos de autor disponibles y las referencias multimedia con una estructura de registro uniforme.
- Contexto de la comunidad y de la interacciónMantiene con cada publicación el flair, los detalles de la comunidad, las horas de publicación y de recopilación, upvotes_count, comments_count, upvote_ratio y discovery_input.
Parámetros de la Reddit Subreddit Posts API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista obligatoria de URL de subreddits públicos de Reddit que usen exactamente la ruta /r/{subreddit} en un host de Reddit compatible. |
results_limit | Opcional | Máximo de publicaciones solicitadas por cada URL de subreddit; el valor predeterminado es 100 y acepta enteros de 1 a 2,000. |
sort_by | Opcional | Listado que se aplica a todas las URL de subreddits enviadas; el valor predeterminado es new y admite new, top o hot. |
Cómo usar la Reddit Subreddit Posts API
Envíe URL de subreddits públicos con un modo de listado y un límite de resultados por subreddit, y luego lea los resultados de la tarea asíncrona con paginación por cursor.
- Prepare una o más URL públicas de Reddit cuya ruta sea /r/{subreddit}.
- Envíe por POST urls, results_limit y sort_by a /v1/reddit/subreddit-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 solicite el next_cursor devuelto mientras has_more siga en true.
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/"],"results_limit":100,"sort_by":"new"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la Reddit Subreddit Posts API
- Monitoreo de publicaciones de comunidades: Recopile el listado new y conserve los ID de las publicaciones, created_at, collected_at, los títulos y el texto para revisar los envíos públicos recientes en subreddits seleccionados.
- Investigación de temas de un subreddit: Agrupe los títulos, el texto del cuerpo, el flair y los campos de la comunidad para examinar los asuntos y formatos recurrentes dentro de comunidades públicas definidas.
- Comparación de listados alineados: Use el mismo sort_by en todas las URL de subreddits y compare las horas de publicación, upvotes_count, comments_count y upvote_ratio bajo un mismo modo de listado.
Consejos de expertos para la Reddit Subreddit Posts API
- Envíe la URL canónica de inicio /r/{subreddit} y no un nombre de subreddit, una URL de publicación ni una ruta más profunda, para que la solicitud pase la validación de URL.
- Calcule la profundidad solicitada como la cantidad de urls multiplicada por results_limit, porque el límite y la estimación de créditos se aplican por separado a cada subreddit.
- Ejecute tareas separadas para comparar new, top y hot, porque se aplica un único valor de sort_by a todas las URL de subreddits de una solicitud.
- Conserve discovery_input y collected_at en cada registro para que los conjuntos de datos posteriores mantengan el subreddit de origen y el momento de observación.
- Admita que los campos de autor, contenido multimedia, flair, comunidad, marcas de tiempo e interacción sean nulos o estén vacíos cuando un listado público no los exponga.
APIs relacionadas
Además de la Reddit Subreddit 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 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.