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 Profile | Karma(发帖与评论)、发帖数和评论数、账号注册时间、简介、头像、奖杯数、认证与员工标记 | 每个账号 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 Feed | r/popular 上的帖子,可按 best、hot、new、top 或 rising 排序 | 每条帖子 0.5 credits($0.0025) |
| Trending Searches | Reddit 今日热门搜索,按排名排列 | 每次调用 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
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
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/"]
}'
认证与异步任务流程
每个请求都携带 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 和 Subreddit Posts 有什么区别?
Popular Feed 读取 r/popular,混合了各社区中正在上升的帖子。要读取单个社区,请使用 Subreddit Posts。
用户没有帖子时会收费吗?
按结果计费的接口没有基础费用,空结果不收费。Active Subreddits 和 Trending Searches 是固定 0.5 credits 的调用。
在哪里对比 Reddit 数据服务商?
参见 Reddit API 替代方案。SocQ 全部 Reddit 接口见 Reddit 平台页,当前费率见 价格页。