Reddit 公开数据 API
通过已知 URL 获取公开 Reddit 帖子和评论，浏览 subreddit 中的 new、top 或 hot 帖子，或按关键词和发布时间搜索讨论。
可用的 Reddit API
指定帖子使用 Posts，公开回复使用 Comments，社区帖子流使用 Subreddit Posts，按关键词发现讨论使用 Search。
可以获取哪些 Reddit 数据？
SocQ 返回标准化公开 Reddit 内容，并保留社区、回复、发现来源、互动和采集时间信息，用于讨论分析。
帖子与可见互动
获取标题、正文、作者、flair、社区、媒体、来源 URL 和以 collected_at 为锚点的可见指标。
评论与回复关系
获取公开评论正文、作者、来源帖子、父评论关系、发布时间、赞成票数和回复数。
Subreddit 内容发现
通过 /r/{subreddit} URL 浏览 new、top 或 hot 帖子，并为每个社区设置独立结果上限。
关键词搜索
按文本关键词和发布时间搜索公开帖子，同时保留匹配内容与发现来源。
SocQ 与 Reddit Data API 对比
SocQ 提供公开 Reddit 数据采集工作流；Reddit Data API 是获批应用访问或修改 Reddit 数据的官方接口。
| 能力 | SocQ | Reddit Data API |
|---|---|---|
| 主要用途 | 采集公开帖子、评论、Subreddit 列表和搜索结果 | 构建获批的 Reddit 应用、集成和审核工具 |
| 身份验证 | 使用 SocQ API key，无需 Reddit 用户 OAuth | 需要 Reddit 审批、OAuth 凭据和明确的应用身份 |
| 起始输入 | 公开帖子或 Subreddit URL，也可使用文本 query | Reddit endpoint、fullname、列表参数和 OAuth scope |
| 发帖、投票或审核 | 不支持 | 获批场景具备所需用户 scope 时支持 |
| 返回格式 | 标准化 SocQ 记录 | Reddit 原生对象和列表 |
Reddit API 如何工作
指定内容采集、subreddit 浏览和关键词搜索使用相同的异步任务和结果分页流程。
1. 提交输入
将帖子 URL、subreddit URL 或搜索词提交到对应 API，并保存返回的 task_id。
2. 跟踪任务
轮询 /v1/tasks/{task_id}，直到任务处理完成。
3. 获取结果
读取 data.results.items；has_more 为 true 时继续使用 next_cursor。
使用 SocQ API key 鉴权并提交关键词和发布时间范围。其他 Reddit API 使用相同的任务流程。
curl -X POST "https://api.socq.ai/v1/reddit/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"machine learning","results_limit":100,"published_within":"month"}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续使用 next_cursor常见 Reddit API 使用场景
社区监测
采集选定 subreddit 的 new、top 或 hot 帖子，并比较不同社区的公开活动。
讨论与回复分析
结合帖子内容、评论正文、回复关系、作者和采集时互动，分析选定讨论。
话题与市场研究
通过指定关键词和时间范围，发现有关产品、品牌、竞品或趋势的公开讨论。
研究归档与数据集
保留公开帖子、评论、来源链接、社区、时间和可见指标，支持可重复分析。
限制与公开数据政策
Reddit 结果是采集时的公开记录。这些 API 不访问私密社区、已删除内容、账号数据或审核功能。
- Posts 和 Comments 接受受支持的帖子 URL 或 redd.it 链接；Subreddit Posts 要求准确的 /r/{subreddit} 路径。
- Subreddit Posts 支持 new、top 或 hot 排序，results_limit 分别应用于每个 subreddit URL。
- Search 接受一个关键词、1 到 2,000 的 results_limit，以及 hour、day、week、month、year 或 all 时间范围，不提供 subreddit 或排序筛选。
- Posts 和 Comments 是独立资源；帖子包含 comments_count，但不包含单条评论记录。
- Comments 返回可见公开评论，但不保证包含完整回复树或全部历史讨论深度。
- 可见指标是以 collected_at 为锚点的快照；公开来源未提供时，选填字段可能为 null 或空值。
Reddit API 常见问题
Reddit API 是什么？
Reddit API 是 SocQ 提供的一组 API，用于获取指定公开帖子和评论、浏览 subreddit 帖子，以及按关键词和发布时间搜索公开讨论。
接受哪些 Reddit 链接？
Posts 和 Comments 接受受支持的 /r/{subreddit}/comments/{post_id} 路径或 redd.it 链接；Subreddit Posts 接受准确的 /r/{subreddit} 路径。
应该选择哪个 Reddit API？
指定帖子使用 Posts，公开回复使用 Comments，社区列表使用 Subreddit Posts，按关键词发现内容使用 Search。
浏览 subreddit 和 Reddit 搜索有什么区别？
Subreddit Posts 从准确的 /r/{subreddit} URL 浏览 new、top 或 hot 帖子；Search 根据一个文本关键词和发布时间范围发现公开帖子。
Reddit 评论和互动指标是完整或实时的吗？
不是。Comments 反映采集时返回的可见公开回复，互动数值是时间点快照，不代表完整历史或实时数据流。
Reddit 采集如何计费？
每条 Posts 或 Subreddit Posts 结果消耗 0.5 积分，每条评论消耗 0.3 积分，每条 Search 结果消耗 0.6 积分；结果为空时不产生结果费用。