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
发送空请求,读取当前的热搜列表。
- 向 /v1/reddit/trending-searches 发送空 JSON 对象 {}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变为 succeeded。
- 从 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,拿到帖子正文、作者和互动数据。
相关 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 答案,附带引用的评论、来源帖子和推荐版块。