Reddit

Reddit API

搜索 Reddit 帖子,按 subreddit 社区或用户整理发帖,并读取单帖详情与评论文本;保留社区、作者和原帖链接,便于核对讨论出处。

请求发到 POST https://api.everyinfra.com/api/v1/social,platform 填 reddit,action 填下方列表里的能力名,例如 search。

  • 8 个能力
  • 每千次 $0.56 起
  • 失败和空结果都不收费
  • 24h 健康值 92%

平台运行状态

24h 健康值
92%
健康

30 天趋势

Reddit 能力清单

能力做什么单价空白行均为 $0.56 / 千次24 小时运行状态
关键词搜索search用 search 发现帖子线索,不把它当作全站评论检索。少量可用 · 健康值 49%
社区帖子subreddit_posts用 subreddit_posts 保持社区范围,避免把社区名当成作者账号。健康 · 健康值 100%
内容详情post_detail用 post_detail 取得一条帖子的标题、正文与互动字段。正常
评论comments用 comments 读取评论文字和作者,不自行拼凑回复关系。健康 · 健康值 100%
用户内容user_posts用 user_posts 区分一个作者的发帖列表与账号统计。正常
用户评论user_comments用 user_comments 读一个用户留过的公开评论,连同评论所在的帖子。$32.4 / 千次正常
痛点调研painpoint用 painpoint 按产品或话题词读 Reddit 讨论,一次拿到汇总、热门帖和负面评论原文。$72 / 千次正常
全站热帖trending_posts用 trending_posts 读 Reddit 全站此刻的热门帖子,不用填参数。正常

Reddit 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

所有能力都是同步调用。

能力必填参数可选参数单次条数单价空白行均为 $0.56 / 千次返回字段
searchkeywordsort默认 10 · 最多 25id · url · title · text · author_username · community · like_count · comment_count · posted_at · flair · domain · external_link · thumbnail_url · image_urls · platform
subreddit_postssubredditdate_range, sort默认 10 · 最多 100id · url · title · text · author_username · community · like_count · comment_count · posted_at · flair · domain · external_link · thumbnail_url · image_urls · platform
post_detailurl——id · url · title · text · author_username · community · like_count · comment_count · posted_at · flair · domain · external_link · thumbnail_url · image_urls · platform
commentsurl—默认 10 · 最多 100id · text · author_username · like_count · community · url · posted_at · platform
user_postsusernamedate_range, sort默认 10 · 最多 50id · url · title · text · author_username · community · like_count · comment_count · posted_at · flair · domain · external_link · thumbnail_url · image_urls · platform
user_commentsusernamesort默认 20 · 最多 200$32.4 / 千次id · text · author_username · like_count · post_id · post_title · url · posted_at · platform
painpointkeywordsort默认 5 · 最多 15$72 / 千次row_type · posts_scanned · posts_analyzed · comments_collected · negative_comment_count · positive_comment_count · pain_keywords · praise_keywords · communities · platform · id · title · url · community · like_count · comment_count · text · author_username · post_title
trending_posts—page_token每页 25 条next_page_token · id · url · title · text · author_username · community · like_count · comment_count · posted_at · domain · external_link · image_urls · platform

怎么调用 Reddit 社区帖子 API?

subreddit_posts

使用 platform="reddit"、action="subreddit_posts" 调用“社区帖子”能力;返回列表,默认 10 条、单次最多 100 条,主要包含 id、url、title、text、author_username、community 等 15 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Reddit subreddit_posts 的参数分别是什么意思?

subreddit必填
subreddit_posts 的社区名,例如 python 或 r/python,或完整社区 URL。

Reddit 帮助中心区分指定社区内搜索和全站结果,subreddit 指帖子所属社区。此处引用范围术语,不把官方搜索框的布尔运算、Flair 或其他筛选自动移植为本接口能力。官方来源:Reddit:社区范围与全站检索不是同一件事来源核查:

date_range可选
社区帖子的相对时间窗;all_time 不限,past_hour/day/week/month/year 为对应的最近时间。Reddit 在 sort=top 时才会应用该窗口。
查看全部 6 个允许值

all_timepast_daypast_hourpast_monthpast_weekpast_year

sort可选
社区帖子排序:newest 最新、popular 热门、top 高分、rising 上升、relevance 相关性。

Reddit 官方将近期互动的 Hot 与历史高票的 Top 分开。本页 popular 对应 Hot,不是 Top;官方网站还有其他排序与时间过滤,并不表示本接口已开放同样的参数或组合。官方来源:Reddit:Relevance、Hot、Top 与 New 的区别来源核查:

查看全部 5 个允许值

newestpopularrelevancerisingtop

Reddit 返回字段与含义(5)
community
所属 subreddit 名称(不含 r/ 前缀)。
flair
帖子的分类标签(flair)原文。
domain
帖子链接的域名(文字帖为 self.版块名 或 reddit.com)。
external_link
链接帖指向的站外地址。
image_urls
帖子里的图片地址。

怎么调用 Reddit 内容详情 API?

post_detail

使用 platform="reddit"、action="post_detail" 调用“内容详情”能力;返回单个对象,主要包含 id、url、title、text、author_username、community 等 15 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Reddit 将 karma 描述为帖子和评论所得投票的近似反映,并说明 upvote 与 karma 不是一比一。本接口没有作者 karma 字段,不把 like_count 或单帖互动计数换算成账号 karma。官方来源:Reddit:帖子互动计数不等于作者 karma来源核查:

Reddit post_detail 的参数分别是什么意思?

url必填
具体 Reddit 帖子 URL,返回该单帖元数据;不接受 sort 或 date_range。
Reddit 返回字段与含义(5)
community
所属 subreddit 名称(不含 r/ 前缀)。
flair
帖子的分类标签(flair)原文。
domain
帖子链接的域名(文字帖为 self.版块名 或 reddit.com)。
external_link
链接帖指向的站外地址。
image_urls
帖子里的图片地址。

怎么调用 Reddit 评论 API?

comments

使用 platform="reddit"、action="comments" 调用“评论”能力;返回列表,默认 10 条、单次最多 100 条,主要包含 id、text、author_username、like_count、community、url 等 8 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Reddit comments 的参数分别是什么意思?

url必填
具体 Reddit 帖子 URL,返回该帖评论;不是全站评论搜索,不接受帖子时间窗。

Reddit 官方介绍了网站和 App 内针对一个帖子的评论搜索。本页 comments 只按帖子 URL 读取评论,没有评论 keyword 参数,也不因为引用官方功能说明就支持评论全文检索。官方来源:Reddit:单帖评论搜索与读取评论的区别来源核查:

Reddit 返回字段与含义(1)
community
所属 subreddit 名称(不含 r/ 前缀)。

怎么调用 Reddit 用户内容 API?

user_posts

使用 platform="reddit"、action="user_posts" 调用“用户内容”能力;返回列表,默认 10 条、单次最多 50 条,主要包含 id、url、title、text、author_username、community 等 15 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Reddit user_posts 的参数分别是什么意思?

username必填
user_posts 的用户名,例如 spez 或 u/spez,或完整 /user/用户名/ URL。

Reddit 的公开内容政策明确区分可浏览和获许可的商业使用,要求商业用途联系平台,并规定删除同步和敏感画像等限制。取得公开帖子不附带平台许可;私信、私有社区及已删除内容也不在其公开内容许可范围内。官方来源:Reddit:公开内容、商业许可与用户权利边界来源核查:

date_range可选
用户发帖的相对时间窗;all_time 不限,past_hour/day/week/month/year 为对应的最近时间。Reddit 在 sort=top 时才会应用该窗口。
查看全部 6 个允许值

all_timepast_daypast_hourpast_monthpast_weekpast_year

sort可选
用户发帖列表排序:newest 最新、popular 热门、top 高分、rising 上升、relevance 相关性。
查看全部 5 个允许值

newestpopularrelevancerisingtop

Reddit 返回字段与含义(5)
community
所属 subreddit 名称(不含 r/ 前缀)。
flair
帖子的分类标签(flair)原文。
domain
帖子链接的域名(文字帖为 self.版块名 或 reddit.com)。
external_link
链接帖指向的站外地址。
image_urls
帖子里的图片地址。

怎么调用 Reddit 用户评论 API?

user_comments

使用 platform="reddit"、action="user_comments" 调用“用户评论”能力;返回列表,默认 20 条、单次最多 200 条,主要包含 id、text、author_username、like_count、post_id、post_title 等 9 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Reddit user_comments 的参数分别是什么意思?

username必填
要读评论历史的 Reddit 用户名,spez、u/spez 或 https://www.reddit.com/u/spez 都可以;一次一个用户。
sort可选
评论排序:newest 最新(默认)、top 高分、popular 热门、controversial 争议。
查看全部 4 个允许值

controversialnewestpopulartop

Reddit 返回字段与含义(2)
post_id
评论所在帖子的 ID(user_comments)。
post_title
评论所在帖子的标题(user_comments;painpoint 的 pain_comment 行)。

怎么调用 Reddit 痛点调研 API?

painpoint

使用 platform="reddit"、action="painpoint" 调用“痛点调研”能力;返回列表,默认 5 条、单次最多 15 条,主要包含 row_type、posts_scanned、posts_analyzed、comments_collected、negative_comment_count、positive_comment_count 等 19 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Reddit painpoint 的参数分别是什么意思?

keyword必填
要调研的产品或话题词,例如 standing desk;按它找 Reddit 帖子,再读这些帖子下的评论。
sort可选
找帖子的排序:relevance 相关性(默认)、popular 热门、top 高分、newest 最新、most_commented 评论最多。
查看全部 5 个允许值

most_commentednewestpopularrelevancetop

Reddit 返回字段与含义(11)
community
所属 subreddit 名称(不含 r/ 前缀)。
post_title
评论所在帖子的标题(user_comments;painpoint 的 pain_comment 行)。
row_type
行类型(painpoint):summary 汇总行(每次一行)、post 热门帖、pain_comment 痛点评论(点赞最多的几条负面评论原文)。
posts_scanned
按关键词找到并查看的帖子数(painpoint 汇总行)。
posts_analyzed
实际读了评论、参与统计的帖子数(painpoint 汇总行),不超过 limit。
comments_collected
参与统计的评论条数(painpoint 汇总行);只读这些帖子的顶层评论。
negative_comment_count
负面评论条数(painpoint 汇总行):按词表判,含负面词、不含正面词的算负面,反讽和褒贬混杂判不准,是粗略计数,不是不满意率。
positive_comment_count
正面评论条数(painpoint 汇总行),同样按词表判,是粗略计数。
pain_keywords
负面评论里反复出现的词,每项含 word(词)和 count(次数),按次数从高到低(painpoint 汇总行);是词频统计,会混进 any、it's 这类常用词,不是人工归纳的问题清单。
praise_keywords
正面评论里出现最多的词,每项含 word 和 count,按次数从高到低(painpoint 汇总行)。
communities
这些帖子来自的社区名列表,不含 r/ 前缀(painpoint 汇总行)。
Reddit search 调用流程一次 Reddit search 调用的全过程:向 POST /api/v1/social 发送 platform="reddit"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、title、text、author_username 等字段;返回列表,单次最多 25 条,计费 $0.56 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "reddit"action: "search"keywordEveryInfra$0.56 / 千次2 · 响应 · 列表idurltitletextauthor_username
一次 Reddit search 调用的全过程:向 POST /api/v1/social 发送 platform="reddit"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、title、text、author_username 等字段;返回列表,单次最多 25 条,计费 $0.56 / 千次,失败与空结果不计费。

Reddit 原始字段名

EveryInfra 统一字段名

左边是 Reddit 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。106 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

Reddit 的独有字段名(当前目录)

全站 106 个平台的当前目录中,这 10 个字段名只在 Reddit 出现。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • flair
  • row_type
  • posts_scanned
  • posts_analyzed
  • comments_collected
  • negative_comment_count
  • positive_comment_count
  • pain_keywords
  • praise_keywords
  • communities

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
url
该记录在原平台上的可访问链接。
title
标题。平台无标题概念时(如纯文本帖)为 null。
text
正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。
author_username
作者用户名(@handle),通常可用于拼 URL。
community
所属 subreddit 名称(不含 r/ 前缀)。
like_count
点赞数。null 表示该平台或该接口不公开此数据,不等于 0。
comment_count
评论数。null 表示不公开,不等于 0。
posted_at
发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
flair
帖子的分类标签(flair)原文。
domain
帖子链接的域名(文字帖为 self.版块名 或 reddit.com)。
external_link
链接帖指向的站外地址。
thumbnail_url
缩略图链接,分辨率低于 image_url。
image_urls
帖子里的图片地址。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
post_id
评论所在帖子的 ID(user_comments)。
post_title
评论所在帖子的标题(user_comments;painpoint 的 pain_comment 行)。
row_type
行类型(painpoint):summary 汇总行(每次一行)、post 热门帖、pain_comment 痛点评论(点赞最多的几条负面评论原文)。
posts_scanned
按关键词找到并查看的帖子数(painpoint 汇总行)。
posts_analyzed
实际读了评论、参与统计的帖子数(painpoint 汇总行),不超过 limit。
comments_collected
参与统计的评论条数(painpoint 汇总行);只读这些帖子的顶层评论。
negative_comment_count
负面评论条数(painpoint 汇总行):按词表判,含负面词、不含正面词的算负面,反讽和褒贬混杂判不准,是粗略计数,不是不满意率。
positive_comment_count
正面评论条数(painpoint 汇总行),同样按词表判,是粗略计数。
pain_keywords
负面评论里反复出现的词,每项含 word(词)和 count(次数),按次数从高到低(painpoint 汇总行);是词频统计,会混进 any、it's 这类常用词,不是人工归纳的问题清单。
praise_keywords
正面评论里出现最多的词,每项含 word 和 count,按次数从高到低(painpoint 汇总行)。
communities
这些帖子来自的社区名列表,不含 r/ 前缀(painpoint 汇总行)。

当前目录另列出 next_page_token,这些字段尚无逐项释义;请先核对 Reddit 对应接口的用例与实际响应,不按字段名猜测类型或含义。

请求填写示例

这里检索公开帖子;subreddit 与账号参数不可互换。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

reddit_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"reddit","action":"search","params":{"keyword":"mechanical keyboard"}}'

记录字段预览(非真实响应)

仅展示 search 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "id": null,
  "url": null,
  "title": null,
  "text": null,
  "author_username": null,
  "community": null,
  "like_count": null,
  "comment_count": null,
  "posted_at": null,
  "flair": null,
  "domain": null,
  "external_link": null,
  "thumbnail_url": null,
  "image_urls": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

搜索 Reddit 帖子,分清相关性与热度

用 search 发现帖子线索,不把它当作全站评论检索。

查看 search 的 sort 参数
  • keyword 是帖子搜索词;sort=relevance 按相关性、newest 按最新、popular 按 Hot 热度,rising 按上升趋势,top 按高分。popular 不是 Top 历史高票榜;search 未开放 date_range,不承诺覆盖不限时的全部帖子。
  • title、text 与 community 分别保留标题、帖子文字和所属 subreddit。comment_count 是评论数量,不是评论正文;需要某帖评论时,再把该帖 url 交给 comments。

读取指定 subreddit 的帖子

用 subreddit_posts 保持社区范围,避免把社区名当成作者账号。

查看 subreddit_posts 的 subreddit 参数
  • subreddit 填社区名或完整 https://www.reddit.com/r/社区名/ URL;当前短名前缀兼容仍有待修项,尤其名称以 r 开头时,优先填写完整社区 URL 并核对返回的 community。不是传入一个词就跨社区搜索。
  • date_range 表示列表时间窗口,不是评论发表时间条件;与 sort 组合后的筛选效果尚未逐路径验证。用 id、url、posted_at 保存本次取得的条目,不把列表长度当作社区规模或全量历史。

读取 Reddit 单帖详情,而不是完整讨论树

用 post_detail 取得一条帖子的标题、正文与互动字段。

查看 post_detail 的 url 参数
  • url 应指向含 /r/社区/comments/帖子ID/ 的具体帖子;返回是单个对象,不是帖子与评论合并后的树。text 可能缺失,尤其不要把链接帖理解成一定包含链接目标网页的全文。
  • like_count 当前可能是帖子得分,不能直接当作独立点赞人数或作者 karma;comment_count 也不是已返回评论数。出现 sort / date_range 不代表单帖详情可以据此筛选或排列评论。

读取 Reddit 帖子下的评论,保持结果为平铺列表

用 comments 读取评论文字和作者,不自行拼凑回复关系。

查看 comments 的 url 参数
  • url 填具体帖子链接,不是社区主页;当前返回 id、text、author_username、url 与 posted_at 的平铺列表,没有 parent_id 或嵌套 replies,不能仅靠相邻顺序还原谁回复了谁。
  • 请求处理设有最多五层回复的范围,但不保证完整取得该深度内的全部内容。sort / date_range 尚不能保证控制评论排序或发表时间;Reddit 网站的评论搜索功能也不等于本接口提供评论关键词搜索。

按 Reddit 用户主页整理其公开帖子

用 user_posts 区分一个作者的发帖列表与账号统计。

查看 user_posts 的 username 参数
  • username 可填用户短名或完整 /user/用户名/ URL;当前短名前缀兼容仍有未修复问题,名称以 u 开头时优先填写完整 URL,并逐条核对 author_username。community 标明每条帖子的所属社区,不是用户所在地。
  • 这里不返回该用户的全部评论、karma、私信或私有社区内容。公开可见不等于获得商业使用许可;使用前需核对 Reddit 授权和内容删除要求,不据此构建敏感个人画像或声称已获 Reddit 背书。

Reddit 用户评论 API 如何读取一个用户的评论历史?

用 user_comments 读一个用户留过的公开评论,连同评论所在的帖子。

查看 user_comments 的 sort 参数
  • username 填 spez、u/spez 或 https://www.reddit.com/u/spez 都可以,一次一个用户;sort 可选 newest(默认)、top、popular、controversial,limit 1–200,默认 20。
  • 每行一条评论:like_count 是评论得分,post_id、post_title 与 url 指评论所在的帖子(url 是帖子链接,不是评论自己的链接)。已删除的评论和私密动态不在其中;公开可见不等于获得商业使用许可,不据此构建敏感个人画像。

Reddit 痛点调研 API 如何找出用户对一个产品抱怨最多的点?

用 painpoint 按产品或话题词读 Reddit 讨论,一次拿到汇总、热门帖和负面评论原文。

查看 painpoint 的 sort 参数
  • keyword 填产品或话题词(如 standing desk);limit 是要分析的帖子数,2–15,默认 5;sort 决定挑哪些帖子:relevance(默认)、popular、top、newest、most_commented(评论最多),冷门词没结果时可改 top。
  • 行平铺、用 row_type 区分:一行 summary 汇总(扫了几帖、分析了几帖、评论条数、负面 / 正面评论数、pain_keywords 与 praise_keywords 词频、communities),若干 post 热门帖,若干 pain_comment 点赞最多的负面评论原文。只读这些帖子的顶层评论;正负面按词表判,反讽和褒贬混杂判不准,计数和词频都是粗略信号,不是不满意率。

Reddit 全站热帖 API 如何读当前全站在热的帖子?

用 trending_posts 读 Reddit 全站此刻的热门帖子,不用填参数。

查看 trending_posts 的 page_token 参数
  • 每页 25 帖,翻页把 next_page_token 作为 page_token 传回;推广帖已去掉。
  • community 是所在版块,like_count 是分数,comment_count 是评论数;external_link 只在外链帖出现;image_urls 只在有图的帖子出现,单图帖里是那张图的地址,图集帖视来源可能列出全部图片,也可能没有这个字段。

Reddit 教程与实战

先在本页核对 action、参数和字段,再按你的任务看下面的完整步骤或相关做法。文章里的示例和边界说明只作参考,以本页的参数和字段为准。

Blog

Reddit 评论采集为什么不完整:别把 MoreComments 当成空数据

解释 Reddit 评论树、PRAW replace_more 的 limit 含义、未展开占位与评论数差异,并说明如何把采集缺口、回复关系和删除处理传递到分析结果。

阅读完整文章
指南

多平台口碑监控蓝图:先记录采集范围,再判断负面变化

做多平台口碑监控:从目标清单、评论身份和增量游标开始,设计可追溯的采集流程;用离线样本演示去重和采集缺口怎么发现,关键判断一律保留人工复核。

阅读完整文章
指南

统一数据 API 入门:从能力目录到第一条可用结果

用 platform、action、params 接入多平台数据:读懂能力目录,完成最小请求,处理异步任务、部分结果与计费,并建立可追溯的数据记录。

阅读完整文章

Reddit API 常见问题

Reddit API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="reddit"、action 和 params。以 search 为例,必填 keyword,可选 sort。这里检索公开帖子;subreddit 与账号参数不可互换。 Reddit 共 8 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 106 个平台。

Reddit API 怎么收费?

每千次 $0.56 起,按能力不同(清单里逐条标了)。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 13 次 Reddit 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

Reddit API 一次能返回多少条数据?

Reddit 有 7 个列表接口,包括 search、subreddit_posts、comments、user_posts、user_comments、painpoint、trending_posts。其余 1 个接口返回单个对象;对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

Reddit API 返回哪些字段?

当前目录为 search 列出 id、url、title、text、author_username、community 等 15 个字段名。按全站当前目录统计,10 个字段名只在 Reddit 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

「搜索 Reddit 帖子,分清相关性与热度」怎样接入 Reddit API?

用 search 发现帖子线索,不把它当作全站评论检索。 keyword 是帖子搜索词;sort=relevance 按相关性、newest 按最新、popular 按 Hot 热度,rising 按上升趋势,top 按高分。popular 不是 Top 历史高票榜;search 未开放 date_range,不承诺覆盖不限时的全部帖子。 title、text 与 community 分别保留标题、帖子文字和所属 subreddit。comment_count 是评论数量,不是评论正文;需要某帖评论时,再把该帖 url 交给 comments。

「读取指定 subreddit 的帖子」怎样接入 Reddit API?

用 subreddit_posts 保持社区范围,避免把社区名当成作者账号。 subreddit 填社区名或完整 https://www.reddit.com/r/社区名/ URL;当前短名前缀兼容仍有待修项,尤其名称以 r 开头时,优先填写完整社区 URL 并核对返回的 community。不是传入一个词就跨社区搜索。 date_range 表示列表时间窗口,不是评论发表时间条件;与 sort 组合后的筛选效果尚未逐路径验证。用 id、url、posted_at 保存本次取得的条目,不把列表长度当作社区规模或全量历史。

「读取 Reddit 单帖详情,而不是完整讨论树」怎样接入 Reddit API?

用 post_detail 取得一条帖子的标题、正文与互动字段。 url 应指向含 /r/社区/comments/帖子ID/ 的具体帖子;返回是单个对象,不是帖子与评论合并后的树。text 可能缺失,尤其不要把链接帖理解成一定包含链接目标网页的全文。 like_count 当前可能是帖子得分,不能直接当作独立点赞人数或作者 karma;comment_count 也不是已返回评论数。出现 sort / date_range 不代表单帖详情可以据此筛选或排列评论。

「读取 Reddit 帖子下的评论,保持结果为平铺列表」怎样接入 Reddit API?

用 comments 读取评论文字和作者,不自行拼凑回复关系。 url 填具体帖子链接,不是社区主页;当前返回 id、text、author_username、url 与 posted_at 的平铺列表,没有 parent_id 或嵌套 replies,不能仅靠相邻顺序还原谁回复了谁。 请求处理设有最多五层回复的范围,但不保证完整取得该深度内的全部内容。sort / date_range 尚不能保证控制评论排序或发表时间;Reddit 网站的评论搜索功能也不等于本接口提供评论关键词搜索。

可以先免费试用 Reddit API 吗?

可以。注册免费,在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星,就能在控制台「余额与充值」领取 $1 额度(≈720 次数据调用),直接进赠送余额,不用输码,24 小⁠时内有效。请先选择 Reddit 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 8 个能力。无需信用卡。

开始调用 Reddit API

在 GitHub 给两个仓库点星领 $1 额度,注册后在控制台领取,24 小⁠时内有效,先选一个 Reddit 接口验证结果。

免费开始

自有访问统计常开;Google Analytics 仅在你点「同意分析」后启用。 隐私政策