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
提交一个用户名、排序方式和数量上限,再分页读取帖子。
- 向 /v1/reddit/user-posts 发送 {"username": "spez", "sort_by": "new", "results_limit": 25}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变为 succeeded。
- 从 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,它在别人帖子下的回复都在那里返回。
相关 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 帖子,返回标题与正文、作者、分数、评论数和媒体。