Reddit Subreddit Rules
Las reglas de un subreddit son las pautas de publicación numeradas que cada comunidad de Reddit define para sí misma, cada una con un título corto que los moderadores muestran en el menú de denuncias y una explicación completa de lo que abarca. Leídas antes de publicar, indican qué tipo de publicaciones acepta o elimina una comunidad, lo que respalda revisiones de cumplimiento antes de un lanzamiento, reglamentos compartidos para equipos que manejan varias cuentas y comparaciones entre comunidades.
Funcionalidades de la Reddit Subreddit Rules API
- Varios subreddits por solicitudurls recibe direcciones de comunidades como https://www.reddit.com/r/AskReddit/, y cada subreddit vuelve como una fila con su nombre r/ y su url.
- Reglas en su orden numeradorules conserva el orden que usa la comunidad, así que la primera entrada es su primera regla y una referencia como “regla 3” corresponde directamente al tercer elemento.
- Título corto y texto completo de cada reglarules.name contiene el título corto que los moderadores muestran en el menú de denuncias, rules.description el texto completo de la regla y rules.id la identifica.
Parámetros de la Reddit Subreddit Rules API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Una o más URL de subreddits con el formato https://www.reddit.com/r/{name}/; también funcionan las direcciones de old.reddit.com y new.reddit.com. |
Cómo usar la Reddit Subreddit Rules API
Envíe las URL de los subreddits y lea una lista de reglas por comunidad.
- Envíe {"urls": ["https://www.reddit.com/r/AskReddit/"]} por POST a /v1/reddit/subreddit-rules.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea el arreglo rules de cada subreddit en results.items y siga results.next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-rules" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.reddit.com/r/AskReddit/"]}'Casos de uso de la Reddit Subreddit Rules API
- Revisar una publicación de lanzamiento frente a las reglas: Lea rules.description de cada subreddit de destino antes de una publicación de producto o un AMA para confirmar que su formato, sus enlaces y su redacción están permitidos.
- Mantener un reglamento de cada comunidad donde publica un equipo: Guarde las reglas de cada subreddit con collected_at para que todas las personas que publican desde cuentas de la empresa trabajen con la misma versión vigente.
- Comparar reglas entre comunidades: Busque en rules.name y rules.description de muchos subreddits términos como promoción, enlaces o flair para ver qué comunidades encajan con una campaña.
Consejos de expertos para la Reddit Subreddit Rules API
- Recorte cada URL hasta la raíz de la comunidad /r/{name}/ antes de enviarla, porque un enlace a una publicación o cualquier otra ruta en la lista rechaza toda la solicitud.
- Muestre rules.description como Markdown, ya que conserva las listas, los énfasis y los enlaces que escribieron los moderadores, incluidos los enlaces a versiones más extensas de una regla en la wiki.
- Compare rules.id y rules.description entre ejecuciones para detectar reglas agregadas, eliminadas o reescritas antes de que salga su próxima publicación.
APIs relacionadas
Además de la Reddit Subreddit Rules 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 Details API
- 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.