Reddit Subreddit Details
Los subreddits forman comunidades especializadas por temas, con pautas de moderación propias, actividad de colaboradores y alcance de audiencia distintos. Recopilar los metadatos de un subreddit permite obtener el número de suscriptores de la comunidad, las estimaciones de usuarios activos semanales, las reglas de la comunidad y las imágenes del ícono.
Funcionalidades de la Reddit Subreddit Details API
- Tamaño e interacción de la comunidadExtrae el total de suscriptores, los usuarios activos semanales y la cantidad de contribuciones semanales de cada subreddit.
- Extracción de reglas de moderaciónObtiene las pautas completas de la comunidad y las reglas de publicación, en formato markdown, que rigen la participación de los usuarios.
- Marca y recursos visualesCaptura las imágenes de ícono de la comunidad, el arte del encabezado, los nombres visibles y las clasificaciones de categorías publicitarias.
- Lotes con varias URLEnvía una lista de URL /r/{subreddit} en una sola solicitud para un análisis agregado de comunidades.
Parámetros de la Reddit Subreddit Details API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista de URL de comunidades públicas de Reddit con el formato /r/{subreddit} de las que se obtendrán los metadatos. |
Cómo usar la Reddit Subreddit Details API
Envíe una o más URL de subreddits como una tarea asíncrona y luego consulte los perfiles de comunidad normalizados.
- Prepare uno o más enlaces de subreddits públicos, por ejemplo https://www.reddit.com/r/technology/.
- Envíe una solicitud POST a /v1/reddit/subreddit-details con la lista urls.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded.
- Lea data.results.items para obtener los metadatos de comunidad normalizados.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-details" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.reddit.com/r/technology/"]}'
# Poll GET /v1/tasks/{task_id}, then inspect data.results.items.Casos de uso de la Reddit Subreddit Details API
- Dimensionamiento de la audiencia de un subreddit: Evalúe el número de suscriptores y de colaboradores activos semanales antes de lanzar una acción de difusión orgánica o una sesión de AMA.
- Verificación del cumplimiento de reglas: Analice las reglas de la comunidad de forma programática para asegurarse de que las publicaciones de los usuarios se ajusten a las políticas de publicación.
- Creación de directorios de temas: Mantenga un catálogo actualizado de comunidades de Reddit con descripciones categorizadas e íconos.
Consejos de expertos para la Reddit Subreddit Details API
- Las URL deben apuntar a la raíz de la comunidad (por ejemplo, /r/technology/) y no a hilos de publicaciones individuales.
- Los campos weekly_active_users y weekly_contributions de los metadatos de extra ofrecen indicadores confiables del estado de la comunidad.
- Los nombres de los subreddits se conservan con su capitalización original en los campos display_name y name.
- Combínelo con Reddit Subreddit Posts para muestrear contenido en vivo de las comunidades que cumplan sus criterios de tamaño.
APIs relacionadas
Además de la Reddit Subreddit Details 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 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 Subreddit Search API
- 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 Subreddit Rules API — Obtiene las reglas numeradas de subreddits a partir de sus URL, con el título corto y el texto completo de cada regla.