跳转到主要内容
POST
Reddit 热门信息流

Reddit 热门信息流

按 Reddit 的展示顺序读取 r/popular:全站各社区此刻正在上升的帖子,包含标题和正文、帖子链接、作者、分数、评论数和图片视频。把 sort_by 换成 top,再选一个从一小时到全部时间的时间窗口,就能看到一天或一周里真正冲上来的内容。媒体团队用它提早发现新闻点,营销人员用它找正在起量的内容形式,研究人员用它抽样平台上的热议话题。
所有字段都是可选的。sort_by 决定 r/popular 的排序:best、hot(默认)、new、top 或 rising;published_within 设置 top 排序的时间范围,可选 hour 到 all。results_limit 默认 25,可填 1–500 之间的整数。每条帖子计 0.5 积分。

标准结果字段

任务结果使用下方稳定的 SocQ 字段。系统会统一来源特有的字段名和格式,但不会推断或补充来源未提供的数据。如需缩小返回字段集合,MCP 查询使用 fields,Typed 工具使用 _result_fields,CLI 使用 --result-fields。声明字段的值为 null 时仍会保留。 以下示例展示任务完成后的响应格式,具体数据以实际查询结果为准。

任务完成响应

授权

Authorization
string
header
必填

使用 Authorization: Bearer <token> 请求头进行身份验证。

请求体

application/json

所有字段都是可选的。sort_by 决定 r/popular 的排序:best、hot(默认)、new、top 或 rising;published_within 设置 top 排序的时间范围,可选 hour 到 all。results_limit 默认 25,可填 1–500 之间的整数。每条帖子计 0.5 积分。

callback_url
string<uri>

可选的任务完成回调 URL。

published_within
enum<string>
默认值:day

内容发布时间范围。

可用选项:
all,
day,
hour,
month,
week,
year
Minimum string length: 1
results_limit
integer
默认值:25

最多保存的结果数,实际结果可能少于该值。

必填范围: 1 <= x <= 500
sort_by
enum<string>
默认值:hot

结果排序方式。

可用选项:
best,
hot,
new,
rising,
top
Minimum string length: 1

响应

任务已受理

code
integer

HTTP 业务状态码。

data
object