Reddit Subreddit Rules
Reddit 版块规则是每个社区为自己定下的编号发帖准则,每条都有版主在举报菜单里显示的简短标题,以及说明具体范围的完整正文。发帖前读一遍,就知道这个社区欢迎哪些帖子、会删掉哪些帖子,可以用来做发布前的合规检查,为多账号团队整理统一的规则手册,或者并排比较不同社区。
Reddit Subreddit Rules API 主要特性
- 一次查询多个版块urls 接受 https://www.reddit.com/r/AskReddit/ 这样的社区地址,每个版块返回一行,带有 r/ 名称和 url。
- 规则保持编号顺序rules 沿用社区自己的顺序,第一项就是社区的第一条规则,提到“第 3 条规则”时可以直接对应到第三项。
- 每条规则都有标题和正文rules.name 是版主在举报菜单里显示的简短标题,rules.description 是完整规则正文,rules.id 是规则的标识。
Reddit Subreddit Rules API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 一个或多个版块链接,格式为 https://www.reddit.com/r/{name}/;old.reddit.com 和 new.reddit.com 的地址同样可用。 |
如何使用 Reddit Subreddit Rules API
提交版块链接,每个社区读取一份规则列表。
- 向 /v1/reddit/subreddit-rules 发送 {"urls": ["https://www.reddit.com/r/AskReddit/"]}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变为 succeeded。
- 从 results.items 读取每个版块的 rules 数组;has_more 为 true 时,继续用 results.next_cursor 读取。
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/"]}'Reddit Subreddit Rules API 最佳使用场景
- 发布前对照规则检查帖子: 发产品帖或 AMA 之前,逐个阅读目标版块的 rules.description,确认帖子格式、链接和措辞都被允许。
- 为团队参与的每个社区建规则手册: 把每个版块的规则连同 collected_at 一起保存,用公司账号发帖的每个人都参照同一份最新版本。
- 横向比较不同社区的规则: 在多个版块的 rules.name 和 rules.description 里搜索 promotion、links、flair 等词,判断哪些社区适合这次推广。
Reddit Subreddit Rules API 使用建议
- 提交前把每个链接都截到社区根路径 /r/{name}/,列表里只要混进一个帖子链接或其他路径,整个请求都会被拒绝。
- 按 Markdown 渲染 rules.description,它保留了版主写的列表、强调和链接,其中也包括指向规则完整 wiki 页面的链接。
- 在两次采集之间比对 rules.id 和 rules.description,下一次发帖前就能发现新增、删除或改写过的规则。
相关 API
除了 Reddit Subreddit Rules API,需要其他类型的 Reddit 公开数据时,可以使用以下 API。
- Reddit Posts API — 从受支持的 Reddit URL 采集公开帖子正文、作者、社区信息、媒体、时间和可见互动指标。
- Reddit Subreddit Posts API — 通过 subreddit URL 按 new、top 或 hot 排序发现公开帖子,设置每个社区的结果上限,并返回标准化社区与互动信息。
- Reddit Subreddit Details API
- Reddit Subreddit Search API
- Reddit User Profile API — 按用户名查询 Reddit 账号,返回总 Karma 及帖子、评论各自的 Karma、发帖评论数、注册时间和主页标记。
- Reddit User Active Subreddits API — 通过一个用户名列出 Reddit 用户活跃的版块,附带成员数和简介。