Reddit User Profile
Reddit 用户资料是每个 u/ 用户名背后的公开主页,列出总 Karma 及其在帖子和评论之间的拆分、账号发过多少帖子和评论、注册时间、简介、头像、奖杯,以及认证账号和 Reddit 员工的标记。把这些信号放在一起,就能看出一个账号资历多深、活跃程度如何,可用于筛选合作创作者、排查新号和低 Karma 账号,以及长期跟踪细分领域里的重要成员。
Reddit User Profile API 主要特性
- 一次最多查 100 个用户名usernames 最多接受 100 个 Reddit 用户名,带不带 u/ 前缀都可以,每个存在的账号单独返回一行。
- Karma 按来源拆分metrics.karma_count 是总 Karma,post_karma_count 和 comment_karma_count 分别说明这些 Karma 来自发帖还是评论。
- 活跃度数量与账号年龄posts_count 和 comments_count 反映账号发过多少内容,published_at 记录账号的注册时间。
- 主页标记与奖杯is_verified、is_employee 和 is_nsfw 是 Reddit 自己给账号打的标记,trophies_count 是奖杯数量,同时还有显示名称、简介、头像和横幅。
Reddit User Profile API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
usernames | 必填 | 最多 100 个 Reddit 用户名,可带 u/ 前缀;每个用户名由 3–20 个字母、数字、连字符或下划线组成。 |
如何使用 Reddit User Profile API
提交一组 Reddit 用户名,每个存在的账号读取一行资料。
- 向 /v1/reddit/user-profile 发送 {"usernames": ["spez", "GovSchwarzenegger"]}。
- 轮询 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-profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["spez","GovSchwarzenegger"]}'Reddit User Profile API 最佳使用场景
- 联系创作者前先做背景核查: 查看 karma_count、posts_count 和 published_at,确认准备联系的 Reddit 用户确实有长期、活跃的发言记录。
- 排查新号和低 Karma 账号: 一批相似帖子或评论集中出现时,把注册时间很近、karma_count 又很低的作者标记出来重点复核。
- 跟踪细分领域的重点账号: 定期用同一批用户名重新查询,比较 karma_count、posts_count 和 followers_count,看出哪些成员在成长。
- 补全 Reddit 用户名名单: 为从讨论串里收集到的用户名补上显示名称、简介、avatar_url 和主页 url,让表格或 CRM 里每个人都有完整身份。
Reddit User Profile API 使用建议
- 提交前先清洗用户名:去掉 u/ 前缀后必须是 3–20 个字母、数字、连字符或下划线,只要有一个格式不对,整个请求都会被拒绝。
- 按小写用户名把结果对回输入名单,因为同一个名字以不同大小写重复提交时只查询一次、只返回一行。
- 名单超过 100 个时按每批 100 个拆分提交,再用 id 合并结果,id 是账号在 Reddit 上固定不变的标识。
相关 API
除了 Reddit User Profile API,需要其他类型的 Reddit 公开数据时,可以使用以下 API。
- Reddit Posts API — 从受支持的 Reddit URL 采集公开帖子正文、作者、社区信息、媒体、时间和可见互动指标。
- Reddit Subreddit Details API
- Reddit User Posts API — 通过一个用户名按 new、top 或 hot 采集 Reddit 用户的发帖记录,返回标题与正文、分数、评论数和媒体。
- Reddit User Comments API — 通过一个用户名采集 Reddit 用户的评论记录,返回前 300 个字符的摘录、分数、评论链接和帖子 ID。
- Reddit User Active Subreddits API — 通过一个用户名列出 Reddit 用户活跃的版块,附带成员数和简介。
- Reddit Subreddit Rules API — 通过版块链接获取 subreddit 的编号规则,每条包含简短标题和完整正文。