reddit/
trending-searches

无需任何输入即可获取 Reddit 今天的热门搜索,返回每个搜索词、它在 Reddit 热搜里的排名以及对应的搜索结果链接。

Reddit Trending Searches API

无需输入
按排名列出
搜索结果链接
每次请求 0.5 积分
等待提交
README

由 SocQ 维护 · 更新于

Reddit Trending Searches

Reddit 热门搜索是 Reddit 标为今日热门的一小组搜索词,通常 6 条左右,每条都带有在列表中的位置和对应搜索结果的链接,内容多是正在发酵的新闻事件、新品发布和文化热点。在一天里多次记录这份列表,就能看出 Reddit 用户此刻在主动搜什么,可以用来搭建趋势看板、安排有时效性的内容,并在关注的话题上榜时及时提醒。

Reddit Trending Searches API 主要特性

  • 不用准备任何输入请求体为空,放进定时任务里就能直接运行,无需任何配置。
  • 沿用 Reddit 的排名顺序rank 从 1 开始,与 Reddit 列出热门搜索的顺序一致。
  • 每个搜索词都有搜索链接keyword 是搜索词本身,url 打开 Reddit 上这个词的搜索结果,每个热点都能直接看到背后的讨论。

Reddit Trending Searches API 参数

可直接发送

此接口无需请求参数,直接发送空 JSON 对象即可。

{}

如何使用 Reddit Trending Searches API

发送空请求,读取当前的热搜列表。

  1. 向 /v1/reddit/trending-searches 发送空 JSON 对象 {}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变为 succeeded。
  3. 从 results.items 读取 keyword 和 rank;has_more 为 true 时,用 results.next_cursor 读取其余结果。
curl -X POST "https://api.socq.ai/v1/reddit/trending-searches" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Reddit Trending Searches API 最佳使用场景

  • 积累热搜历史: 每次运行都保存 keyword、rank 和 collected_at,画出话题在榜上停留多久、排名怎样升降。
  • 安排有时效性的内容: 每天早上看一眼当前的 keyword 列表,决定当天哪些正在发酵的话题值得写帖子、简报条目或解读文章。
  • 关注话题上榜提醒: 把每个 keyword 和品牌、产品或行业词表做比对,一旦有词上榜就通知团队。

Reddit Trending Searches API 使用建议

  • 入库时用 keyword 加 collected_at 作为键,因为 id 就是搜索词本身,同一个词会在之后的快照里再次出现。
  • 需要某个热点背后的帖子时,把 keyword 作为 query 交给 Reddit Search API,拿到帖子正文、作者和互动数据。

除了 Reddit Trending Searches API,需要其他类型的 Reddit 公开数据时,可以使用以下 API。

  • Reddit Posts API — 从受支持的 Reddit URL 采集公开帖子正文、作者、社区信息、媒体、时间和可见互动指标。
  • Reddit Search API — 通过文本 query 和发布时间窗口搜索公开 Reddit 帖子,返回标准化内容、作者、社区信息、时间、媒体和可见互动指标。
  • Reddit Subreddit Details API
  • Reddit Subreddit Search API
  • Reddit Popular Feed API — 按 hot、best、new、rising 或 top 采集 r/popular 帖子,返回标题与正文、作者、分数、评论数和媒体。
  • Reddit Answers API — 提一个问题,获取 Reddit 的 AI 答案,附带引用的评论、来源帖子和推荐版块。

探索其他平台

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

Reddit Trending Searches API — 常见问题

Reddit Trending Searches API 是一个用于获取 Reddit 今日热门搜索的 API,调用时无需任何输入。它返回每个搜索词及其排名和对应的 Reddit 搜索结果链接。

通常 6 条,按 Reddit 列出的顺序从 1 开始排名,也就是 Reddit 当时展示的整份列表。

每次调用固定计 0.5 积分,与列表里的搜索词数量无关。