RedditReddit 用户子版块规则热门趋势API 指南

Reddit 用户 API:用户资料、发帖与评论历史、热门趋势和版规

SocQ 新增 7 个 Reddit 接口:用户资料、发帖和评论历史、活跃子版块、r/popular、热门搜索和子版块规则,附请求示例与按结果计费价格。

SocQ更新于 2026年11月19日阅读约 6 分钟

SocQ 此前已经支持 Reddit 帖子、评论、子版块列表和搜索。2026-11-17 新上线的 7 个接口回答的是另一类问题:这个 Reddit 用户是谁、发了什么、说了什么、活跃在哪些社区,以及整个 Reddit 正在流行什么、每个子版块允许发什么。

本文说明每个新接口返回什么、请求怎么写、价格多少、何时使用。关于 Reddit 官方 API、OAuth 以及更早上线的接口,请阅读 Reddit API 指南 和 Reddit 采集 API 对比。

快速回答: 带上 Authorization: Bearer $SOCQ_API_KEY,把用户名、子版块 URL 或空输入发送到 7 个 POST /v1/reddit/... 接口之一。轮询 GET /v1/tasks/{task_id} 直到 status 为 succeeded,再读取 data.results.items。其中 5 个接口按结果计费(0.3 或 0.5 credits),Active Subreddits 和 Trending Searches 每次调用 0.5 credits。1 credit 为 $0.005。

7 个新的 Reddit 接口

接口返回内容价格
User ProfileKarma(发帖与评论)、发帖数和评论数、账号注册时间、简介、头像、奖杯数、认证与员工标记每个账号 0.5 credits($0.0025)
User Posts用户的帖子,可按 new、top 或 hot 排序,含完整正文、分数、评论数和媒体每条帖子 0.5 credits($0.0025)
User Comments用户的评论,含分数、时间、链接以及评论所在的帖子每条评论 0.3 credits($0.0015)
User Active Subreddits用户活跃的子版块,含成员数和社区简介每次调用 0.5 credits($0.0025)
Popular Feedr/popular 上的帖子,可按 best、hot、new、top 或 rising 排序每条帖子 0.5 credits($0.0025)
Trending SearchesReddit 今日热门搜索,按排名排列每次调用 0.5 credits($0.0025)
Subreddit Rules编号规则,含简短标题和完整规则文本每个子版块 0.5 credits($0.0025)

研究一个 Reddit 用户

Reddit User Profile

Reddit User Profile API 每个账号返回一行:拆分为发帖 karma 与评论 karma 的总 karma、发帖数和评论数、注册时间、简介和头像、奖杯数,以及认证账号和 Reddit 员工标记。可用于外联前核查创作者,或判断一个讨论串里作者的资历。

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"]
  }'

最多传 100 个用户名,带不带 u/ 前缀都可以。参见 User Profile 文档。

Reddit User Posts

Reddit User Posts API 拉取用户的发帖历史,包含文字帖的完整正文、帖子链接、分数、评论数、发布时间以及图片或视频。按 new 排序可跟踪对方最近分享的内容,按 top 排序可看出哪些帖子反响最好。

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
  }'

sort_by 可选 new(默认)、top 或 hot。results_limit 默认 25,可取 1 到 1,000。likes_count 存放帖子分数。参见 User Posts 文档。

Reddit User Comments

评论历史比用户自己的帖子更能体现其真实知识和关注点。Reddit User Comments API 返回每条评论的分数、时间、评论链接,以及评论所在帖子的 post_id。可用于筛选专家和潜在客户,或跟踪某个账号如何谈论你的产品。

curl -X POST "https://api.socq.ai/v1/reddit/user-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "spez",
    "sort_by": "top",
    "results_limit": 100
  }'

results_limit 默认 100,可取 1 到 1,000。text 为最多 300 个字符的预览;url 可打开完整评论。参见 User Comments 文档。

Reddit User Active Subreddits

Reddit User Active Subreddits API 列出用户最近发帖或评论过的社区,每个社区含成员数和简介。它能勾勒出一个人的兴趣,并指向你的受众常去的细分社区。

curl -X POST "https://api.socq.ai/v1/reddit/user-active-subreddits" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "GovSchwarzenegger"
  }'

每次请求 0.5 credits,返回该账号公开活跃列表中的全部社区。参见 Active Subreddits 文档。

关注 Reddit 上的热门内容

Reddit Popular Feed API 按 Reddit 的展示方式读取 r/popular:各社区中正在上升的帖子,含标题和正文、链接、作者、分数、评论数和媒体。把 sort_by 改为 top 并设置 published_within,即可查看一天或一周内冲上来的内容。

curl -X POST "https://api.socq.ai/v1/reddit/popular-feed" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sort_by": "hot",
    "results_limit": 25
  }'

所有字段都是可选的。sort_by 可选 best、hot(默认)、new、top 或 rising;published_within 作用于 top,范围从 hour 到 all。results_limit 默认 25,可取 1 到 500。参见 Popular Feed 文档。

Reddit Trending Searches API 按 Reddit 列出的顺序返回今日热门搜索,通常是正在发生的新闻事件、产品发布和文化热点。每天轮询几次即可驱动趋势看板,再用 Reddit Search 深入某个话题。

curl -X POST "https://api.socq.ai/v1/reddit/trending-searches" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

无需任何输入。每次调用返回当前列表,通常 6 条搜索,从 1 开始排名。参见 Trending Searches 文档。

发帖前查看子版块规则

Reddit Subreddit Rules API 每个子版块返回一行,按顺序列出编号规则,每条含版主在举报菜单中显示的简短标题和完整规则文本。品牌可在发布帖子前确认哪些内容被允许;运营多个账号的团队可为每个社区维护一份规则手册。

curl -X POST "https://api.socq.ai/v1/reddit/subreddit-rules" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://www.reddit.com/r/AskReddit/"]
  }'

参见 Subreddit Rules 文档。

认证与异步任务流程

每个请求都携带 API key 和 JSON 内容类型:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

每次提交都会启动一个后台任务(submit -> task_id -> queued -> running -> succeeded,或 failed)。提交响应返回 data.task_id 和 data.status。轮询任务:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

任务处于 queued、running 或 failed 时,响应只包含任务元数据;failed 时读取 error_message。任务为 succeeded 时,响应包含第一页标准化记录,位于 data.results.items。limit 默认 50,最大 500。若 has_more 为 true,把 results.next_cursor 作为 cursor 传入。fields 最多接受 50 个以逗号分隔的字段或点路径。

客户端超时不会取消任务;请用同一个 task_id 继续查询,避免为重复采集付费。也可以在提交请求中加入 callback_url,任务结束时会收到一次带任务摘要的 POST。

典型任务的费用

  • 查询讨论串中 100 位作者的资料:100 × 0.5 = 50 credits,$0.25。
  • 完整研究一个用户(25 条帖子、100 条评论、活跃子版块):12.5 + 30 + 0.5 = 43 credits,$0.215。
  • 30 天内每天查询 4 次热门搜索:120 × 0.5 = 60 credits,$0.30。

常见问题

可以一次查询多个 Reddit 用户吗?

User Profile 每次请求最多 100 个用户名。User Posts、User Comments 和 Active Subreddits 每次只接受一个 username,因此每个用户提交一个任务。

User Comments 会返回完整评论正文吗?

text 为最多 300 个字符的预览。url 字段可打开完整评论,post_id 标识评论所在的帖子。

Popular Feed 读取 r/popular,混合了各社区中正在上升的帖子。要读取单个社区,请使用 Subreddit Posts。

用户没有帖子时会收费吗?

按结果计费的接口没有基础费用,空结果不收费。Active Subreddits 和 Trending Searches 是固定 0.5 credits 的调用。

在哪里对比 Reddit 数据服务商?

参见 Reddit API 替代方案。SocQ 全部 Reddit 接口见 Reddit 平台页,当前费率见 价格页。

REDDIT API

使用公开的 Reddit 输入测试工作流

提交公开输入,获取带有可追溯来源上下文的标准化记录。

查看 Reddit API