reddit/
popular-feed

按五种排序中的任意一种采集 Reddit r/popular 信息流里的热门帖子,返回标题与正文、作者、分数、评论数和图片视频,每次请求最多 500 条。

Reddit Popular Feed API

无需输入
五种排序
top 时间范围
最多 500 条帖子
每条结果 0.5 积分
等待提交
README

由 SocQ 维护 · 更新于

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

选好排序和数量上限,或者直接发送空请求体,再分页读取信息流。

  1. 向 /v1/reddit/popular-feed 发送 {"sort_by": "hot", "results_limit": 25}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变为 succeeded。
  3. 从 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 和账号年龄。

除了 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 搜索结果链接。

探索其他平台

还可以将 Reddit 数据与其他已支持社交平台的公开数据结合使用。

Reddit Popular Feed API — 常见问题

Reddit Popular Feed API 是一个用于按指定排序和时间范围采集 Reddit r/popular 信息流帖子的 API。它返回每条帖子的标题与正文、链接、作者、分数、评论数和媒体。

所有字段都是可选的:空请求返回 r/popular 上最热的 25 条帖子,sort_by、published_within 和 results_limit 分别调整排序、时间范围和数量。

results_limit 每次可取 1 到 500 条,每条帖子计 0.5 积分,默认的 25 条计 12.5 积分,500 条计 250 积分。