Reddit Posts
Reddit 帖子是发布在社区中的内容，公开页面可能展示标题、正文、作者、flair、媒体、发布时间以及可见的投票与评论信号。将这些字段与所属社区和采集时间关联起来，可以支持单帖溯源、内容分析和分时点比较。
主要特性
- 按链接精确解析帖子将受支持的 Reddit 讨论链接或 redd.it 短链解析为对应公开帖子的标准化记录，并拒绝社区首页和无关路径。
- 帖子内容与来源身份返回帖子 ID、公开 URL、标题、正文和可用的作者标识，便于将每条记录追溯到原始页面。
- 社区与内容分类信息当来源提供相应数据时，在 extra 中返回 flair、社区名称、社区 URL 和可见成员数。
- 媒体、互动与采集时间在同一份分时点记录中保留媒体引用、created_at、collected_at、upvotes_count、comments_count 和 upvote_ratio。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 必填的公开 Reddit 帖子 URL 列表；可使用受支持 Reddit 域名下的 /r/{subreddit}/comments/{post_id} 路径或 redd.it 短链。 |
如何使用
提交需要读取的公开帖子，跟踪异步任务，并使用 cursor 分页读取标准化记录。
- 准备一个或多个使用受支持 comments 路径或 redd.it 短链的公开 Reddit 帖子 URL。
- 将链接作为 urls 提交到 /v1/reddit/posts，并保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或返回失败。
- 读取 data.results.items；当 has_more 为 true 时，使用返回的 next_cursor 继续请求。
curl -X POST "https://api.socq.ai/v1/reddit/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.reddit.com/r/example/comments/post_id/example_post/"]}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；has_more 为 true 时继续使用 next_cursor最佳使用场景
- 溯源审阅指定帖子： 保留帖子 ID、URL、标题、正文和作者字段，让分析人员能够回到本次研究所使用的具体公开内容。
- 比较不同社区的话题表达： 按照 community_name 和 tag 组织标题与正文，比较同一主题在选定社区中的讨论方式。
- 跟踪分时点互动变化： 将 upvotes_count、comments_count 和 upvote_ratio 与 collected_at 一同保存，用重复快照比较变化而不是把计数视为固定值。
使用建议
- 批量提交前先解析 redd.it 短链并按帖子 ID 去重，因为短链和完整讨论 URL 可能指向同一个帖子。
- 仅在已经掌握帖子 URL 时使用此 endpoint；它不接受社区首页、搜索词、排序选项或 results_limit。
- 当公开来源没有展示相应数据时，允许作者、媒体、tag、社区信息、时间和互动指标为 null。
- 将 collected_at 与可见互动指标一同保存，避免后续快照覆盖此前计数的观察时间。
相关 API
需要其他类型的 Reddit 公开数据时，可以使用以下 API。
- Reddit Comments API — 从受支持的帖子 URL 采集公开评论正文、作者、来源帖子与父评论关系、社区信息、时间和可见互动指标。
- Reddit Subreddit Posts API — 通过 subreddit URL 按 new、top 或 hot 排序发现公开帖子，设置每个社区的结果上限，并返回标准化社区与互动信息。
- Reddit Search API — 通过文本 query 和发布时间窗口搜索公开 Reddit 帖子，返回标准化内容、作者、社区信息、时间、媒体和可见互动指标。