Reddit Popular Feed
Reddit 热门信息流 r/popular 汇集了全站各个社区里同时在往上冲的帖子,每条都有标题和正文、作者、分数、评论数、发布时间以及附带的图片或视频。换不同的排序和时间范围去读它,就能看出哪些新闻、内容形式和话题正在全站走红,适合提早发现新闻点、研究内容形式,以及抽样了解 Reddit 上的热议话题。
Reddit Popular Feed API 主要特性
- 五种方式排列 r/popularsort_by 可选 best、hot、new、rising 或 top,不填时使用 hot。
- top 排序的时间范围published_within 把 top 排序限定在过去一小时、一天、一周、一个月、一年或全部时间,默认是一天。
- 带作者和媒体的完整帖子记录每行都有包含标题与正文的 text、帖子 url、作者用户名和主页链接、likes_count 里的分数、comments_count,以及带像素宽高的 media。
Reddit Popular Feed API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
sort_by | 可选 | r/popular 的排序方式:best、hot(默认)、new、rising 或 top。 |
published_within | 可选 | sort_by 为 top 时使用的时间范围:hour、day(默认)、week、month、year 或 all。 |
results_limit | 可选 | 最多采集的帖子数,取 1–500 之间的整数,默认 25。 |
如何使用 Reddit Popular Feed API
选好排序和数量上限,或者直接发送空请求体,再分页读取信息流。
- 向 /v1/reddit/popular-feed 发送 {"sort_by": "hot", "results_limit": 25}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变为 succeeded。
- 从 results.items 读取帖子;has_more 为 true 时,用 results.next_cursor 继续读取后续页面。
curl -X POST "https://api.socq.ai/v1/reddit/popular-feed" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"sort_by":"hot","results_limit":25}'Reddit Popular Feed API 最佳使用场景
- 在热度见顶前发现新闻: 定期用 sort_by rising 或 new 采集,盯住 published_at、likes_count 和 comments_count,看哪些帖子在 r/popular 上加速上升。
- 整理每周热帖回顾: 用 sort_by top 加 published_within week 采集,列出过去七天冲上来的帖子的 url、text 和分数。
- 研究哪些内容形式能上 r/popular: 按 media 类型把帖子分成图片、视频和纯文字三组,再比较各组的 likes_count 和 comments_count。
Reddit Popular Feed API 使用建议
- 用到 published_within 时一定把 sort_by 设为 top,因为时间范围只对 top 排序生效。
- 每次快照都记下 collected_at 并按 id 去重,信息流变化很快,同一条帖子可能出现在相邻几次采集里。
- 某个发帖人反复出现时,把 author.username 交给 Reddit User Profile API,查看他的 Karma 和账号年龄。
相关 API
除了 Reddit Popular Feed 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 User Posts API — 通过一个用户名按 new、top 或 hot 采集 Reddit 用户的发帖记录,返回标题与正文、分数、评论数和媒体。
- Reddit Trending Searches API — 无需输入获取 Reddit 今日热门搜索,每条附排名和 Reddit 搜索结果链接。