reddit/
subreddit-posts

Descubra publicaciones públicas de Reddit a partir de URL de subreddits ordenadas por new, top o hot, con contenido, autores, contexto de la comunidad, contenido multimedia e interacción visible en registros normalizados.

Reddit Subreddit Posts API

Entrada con URL de subreddit
New, top o hot
Límite por subreddit
0.5 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
urlsObligatorioLista obligatoria de URL de subreddits públicos de Reddit que usen exactamente la ruta /r/{subreddit} en un host de Reddit compatible.
results_limitOpcionalMáximo de publicaciones solicitadas por cada URL de subreddit; el valor predeterminado es 100 y acepta enteros de 1 a 2,000.
sort_byOpcionalListado 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.

  1. Prepare una o más URL públicas de Reddit cuya ruta sea /r/{subreddit}.
  2. Envíe por POST urls, results_limit y sort_by a /v1/reddit/subreddit-posts y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
  4. 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 true

Casos 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.

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.

Explorar otras plataformas

Combine los datos de Reddit con datos públicos de otras plataformas sociales compatibles.

Reddit Subreddit Posts API — FAQ

Reddit Subreddit Posts API descubre publicaciones públicas a partir de URL de subreddits aceptadas, con orden new, top o hot. Devuelve contenido, autores, contexto de la comunidad, contenido multimedia, marcas de tiempo e interacción visible, todo normalizado.

Envíe una URL http o https de un host de Reddit compatible cuya ruta sea exactamente /r/{subreddit}, con una barra final opcional. No se aceptan nombres de subreddits, URL de publicaciones ni rutas más profundas.

sort_by admite new, top y hot, y su valor predeterminado es new. La solicitud no acepta un parámetro de ventana de tiempo para los listados top.

results_limit tiene un valor predeterminado de 100 y acepta valores de 1 a 2,000. Se aplica por separado a cada URL, de modo que dos URL con results_limit 50 solicitan hasta 100 publicaciones.

No. Cada publicación puede incluir comments_count, pero el resultado no contiene el texto de los comentarios ni sus autores.

Los detalles del autor, el contenido multimedia, el flair, el contexto de la comunidad, la hora de publicación y los valores de interacción pueden ser nulos o estar vacíos cuando el listado público no expone un valor utilizable.

Cada registro de publicación devuelto cuesta 0.5 créditos de SocQ. La estimación previa a la solicitud usa urls multiplicado por results_limit, y un conjunto de resultados vacío no genera cargo por resultados.