Reddit Subreddit Details
Subreddit 是 Reddit 围绕特定主题形成的垂直社区，拥有独立的版规准则、活跃用户体量与受众规模。采集社区元数据能够提供订阅会员数、周活跃贡献者估算、社区守则以及图标横幅等视觉资产。
主要特性
- 社区体量与活跃度提取每个版块的公开订阅者总数、周活跃用户数（WAU）与周发布贡献量。
- 版规与发帖要求解析获取完整的 Markdown 格式版规指南和发帖说明，便于自动化合规核查。
- 品牌与视觉物料采集社区官方图标、顶部横幅头图、官方显示名称和广告分类归属。
- 批量 URL 支持可在单次请求中传入多个 /r/{subreddit} 链接，一键聚合多个目标社群的基础档案。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 公开 Reddit /r/{subreddit} 社区 URL 数组。 |
如何使用
提交目标社区 URL 列表作为异步任务，并轮询获取标准化版块元数据。
- 准备一个或多个公开社区链接，例如 https://www.reddit.com/r/technology/。
- 向 /v1/reddit/subreddit-details 发送 POST 请求，传入 urls 数组。
- 轮询 /v1/tasks/{task_id} 直至状态变为 succeeded。
- 在 data.results.items 中读取标准化的社区数据对象。
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/"]}'
# 轮询 GET /v1/tasks/{task_id}，解析 data.results.items 中的社区元数据。最佳使用场景
- 社区受众与合作前置调研： 在发起 AMA 讨论或品牌入驻前，快速核实社区的真实订阅量与近期活跃人数规模。
- 社群发帖合规自动审查： 通过程序化拉取版块发帖限制与版规条款，避免因违规操作导致账号受限。
- 垂直兴趣社区导航搭建： 整理各领域的顶级 Reddit 版块，维护包含图标、简介与分类的完整索引目录。
使用建议
- 提交的链接必须为版块主页格式（如 /r/technology/），不可提交单个帖子的讨论链接。
- extra 元数据中的 weekly_active_users 与 weekly_contributions 是研判社区生命力的硬指标。
- 版块名称会保留原本的大小写拼写方式，便于对外展示或精准索引。
- 筛选出优质版块后，可紧接着配合 Reddit Subreddit Posts 接口采集最新的帖子讨论内容。
相关 API
需要其他类型的 Reddit 公开数据时，可以使用以下 API。
- Reddit Posts API — 从受支持的 Reddit URL 采集公开帖子正文、作者、社区信息、媒体、时间和可见互动指标。
- Reddit Comments API — 从受支持的帖子 URL 采集公开评论正文、作者、来源帖子与父评论关系、社区信息、时间和可见互动指标。
- Reddit Subreddit Posts API — 通过 subreddit URL 按 new、top 或 hot 排序发现公开帖子，设置每个社区的结果上限，并返回标准化社区与互动信息。
- Reddit Search API — 通过文本 query 和发布时间窗口搜索公开 Reddit 帖子，返回标准化内容、作者、社区信息、时间、媒体和可见互动指标。
- Reddit Subreddit Search API