reddit/
user-posts

输入一个用户名,按 new、top 或 hot 排序采集该 Reddit 用户发过的帖子,最多 1000 条,返回标题与正文、净得分、评论数和图片视频。

Reddit User Posts API

用户名输入
new / top / hot 排序
最多 1000 条帖子
分数与评论数
每条结果 0.5 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

Reddit User Posts

Reddit 用户发帖记录是一个账号在各个社区发过的全部帖子,每条都有标题和正文、链接、发布时间、净得分、评论数,以及附带的图片或视频。按时间或按分数去读这些帖子,能看出一个人在分享什么、哪些话题更受欢迎、发帖重心怎样变化,适合做创作者调研、跟踪创始人账号,或者收集某位行业专家的长文。

Reddit User Posts API 主要特性

  • 一个用户名,最多 1000 条帖子username 填一个账号,带不带 u/ 前缀都可以,results_limit 可取 1 到 1000,默认采集 25 条。
  • 标题和正文合在一个字段text 以帖子标题开头,文字帖还会空一行接上完整正文,一个字段就是整篇帖子的文字。
  • 净得分与评论数metrics.likes_count 是帖子的分数,即赞成票减去反对票,metrics.comments_count 反映帖子引发了多少讨论。
  • 图片、图集和站内视频media 列出帖子附带的每张图片或每个视频,包含 url、预览图以及以像素计的宽高,可以直接做缩略图或下载。

Reddit User Posts API 参数

参数必填描述
username必填一个 Reddit 用户名,可带 u/ 前缀,由 3–20 个字母、数字、连字符或下划线组成。
sort_by可选帖子排序方式:new(默认,最新)、top(最高分)或 hot(热门)。
results_limit可选最多采集的帖子数,取 1–1000 之间的整数,默认 25。

如何使用 Reddit User Posts API

提交一个用户名、排序方式和数量上限,再分页读取帖子。

  1. 向 /v1/reddit/user-posts 发送 {"username": "spez", "sort_by": "new", "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/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"spez","sort_by":"new","results_limit":25}'

Reddit User Posts API 最佳使用场景

  • 跟进账号的最新发帖: 定期用 sort_by new 采集,读取 published_at 和 url,创始人、记者或竞品账号每发一条新帖都能及时发现。
  • 找出用户得分最高的帖子: 用 sort_by top 采集,对比 likes_count 和 comments_count,看出这个人哪些话题和形式反响最强。
  • 用专家长帖建立语料库: 把文字帖的 text 连同 url、published_at 一起保存,整理出某位专家的长篇讲解数据集。

Reddit User Posts API 使用建议

  • 在 text 的第一个空行处切开,就能分出标题和正文;链接帖和图片视频帖只有标题。
  • 用 sort_by new 检查账号有没有新帖时,保存已经入库的 id,一旦翻到已知的 id 就停止往下读。
  • 想看账号的完整动态时,把同一个用户名也提交给 Reddit User Comments API,它在别人帖子下的回复都在那里返回。

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

  • Reddit Posts API — 从受支持的 Reddit URL 采集公开帖子正文、作者、社区信息、媒体、时间和可见互动指标。
  • Reddit Comments API — 从受支持的帖子 URL 采集公开评论正文、作者、来源帖子与父评论关系、社区信息、时间和可见互动指标。
  • Reddit Subreddit Posts API — 通过 subreddit URL 按 new、top 或 hot 排序发现公开帖子,设置每个社区的结果上限,并返回标准化社区与互动信息。
  • Reddit User Profile API — 按用户名查询 Reddit 账号,返回总 Karma 及帖子、评论各自的 Karma、发帖评论数、注册时间和主页标记。
  • Reddit User Active Subreddits API — 通过一个用户名列出 Reddit 用户活跃的版块,附带成员数和简介。
  • Reddit Popular Feed API — 按 hot、best、new、rising 或 top 采集 r/popular 帖子,返回标题与正文、作者、分数、评论数和媒体。

探索其他平台

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

Reddit User Posts API — 常见问题

Reddit User Posts API 是一个用于根据用户名采集 Reddit 账号所发帖子的 API。它返回每条帖子的标题与正文、链接、发布时间、分数、评论数和附带媒体。

提交用户名,sort_by 设为 new,results_limit 最多填 1000,然后用 next_cursor 逐页读取,直到 has_more 为 false。

new 从最新的帖子往前排,top 按分数排序,hot 沿用 Reddit 对该主页的热门排序。不填 sort_by 时使用 new。

每返回一条帖子计 0.5 积分,默认的 25 条计 12.5 积分,1000 条计 500 积分。账号的帖子少于 results_limit 时,只按实际返回的帖子计费。