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 积分；结果为空时不产生结果费用。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
Rednote API
获取公开账号和笔记，搜索笔记或用户，采集评论与嵌套回复，并记录一页首页推荐。
Pinterest API
获取公开 Pinterest 账号数据、解析指定 Pin、采集选定账号的 Pin，或按关键词搜索，用于创作者、内容和视觉趋势研究。
Threads API
获取公开 Threads 账号、解析指定帖子，或采集选定账号的帖子，并返回标准化身份、内容、媒体、互动和时间字段。
Bluesky API
获取公开 Bluesky 账号、解析指定帖子 URL，或采集一页账号帖子，并返回标准化身份、内容、媒体、时间和可见互动字段。
Snapchat API
将一个已知公开 Snapchat Spotlight 获取为标准化记录，并返回可用的创作者、说明文字、媒体、音频、时间、时长和互动字段。
Twitch API
将一个已知公开 Twitch username 解析为标准化主页记录，或采集其公开视频清单，用于创作者研究、目录补全、比较和快照监测。