Reddit 帖子、评论与社区数据 API

在 url 中传入一篇 Reddit 公开讨论的完整链接。响应包含 meta.status、meta.totalComments、body.post 与 body.post_comments。已观察到的帖子字段包括 id、title、author、subreddit、selftext、created_utc、score、ups、upvote_ratio、num_comments、permalink 与 url。返回的评论节点使用 id、author、content、up_votes、score、created_utc，以及可继续包含评论节点的 replies 数组。部分嵌套回复中，看起来是数值的字段实际为字符串，计算前应统一类型。 实测的历史讨论来自 wallstreetbets，帖子 ID 为 p0esdp；meta.totalComments 为 194，返回了 76 个顶层评论对象以及嵌套回复。报告总数与顶层数组长度是不同指标，任何一个都不能证明已获取全部评论。本接口没有 cursor 参数，也没有文档化的缺失评论展开方式。部分帖子的正文可能为空或不可用，投票字段也应视为查询时的快照，而非固定分数。

在 url 中传入子版块的完整链接。filter 可选 hot、new 或 top，文档默认值为 hot。首个请求省略 cursor；有下一页时，将响应的 meta.cursor 与相同的 url、filter 一起传回。响应包含 meta.status、meta.total、meta.cursor 与 body 数组。已观察到的帖子字段包括 id、name、title、author、subreddit、selftext、created_utc、score、ups、num_comments、permalink 与 url。created_utc 是以秒为单位的 Unix 时间戳，selftext 可能为空。 对 AskReddit 的 filter=new 实测返回了 25 篇帖子，其中有帖子在请求前数秒创建。这不代表固定页大小或送达时效保证；hot 与 top 排序尚未经过实测。对一个不存在的子版块进行测试时，返回 meta.status=200、meta.total=0、meta.cursor=null 与 body=[]。应将这种结果正常显示为空列表，不要混入无关帖子，也不要据此推断所有不可访问社区都会返回相同结构。游标列表不承诺覆盖完整历史档案。

在 subreddit 中仅传社区名，例如 AskReddit，不要附带 r/ 或完整链接。首个请求省略 cursor，之后使用响应中的 meta.cursor 在同一社区内续页。已观察到的响应包含 meta.status、meta.subreddit、meta.cursor 与评论记录组成的 body 数组。记录字段包括 id、name、author、body、body_html、created_utc、subreddit、score、ups、parent_id、link_id、link_title、link_permalink 与 permalink。评论正文读取 body，创建时间读取以 Unix 秒表示的 created_utc。 实测 AskReddit 列表返回了 25 条近期评论，其中有评论在请求前数秒创建。这是跨帖子的评论列表，不是完整回复树；观察到的记录中，replies 为空字符串。可用 link_permalink 将选定评论对应的讨论交给帖子详情接口读取。该结果不能证明固定送达间隔或完整的子版块评论历史。关键词匹配、告警和情感标签需由客户端自行处理。

仅传子版块名称，例如 AskReddit。已观察到的响应包含 meta.status、meta.subreddit 与 body 对象，其中有 name、title、public_description、description、subscribers、created_utc、subreddit_type、over18、lang、url、icon_img、community_icon、banner_img 和 banner_background_image。实测 AskReddit 被标记为公开社区，创建时间戳为 1201233135，链接为 /r/AskReddit/。public_description 适合短介绍，description 则包含较长的社区说明。 订阅人数与图片链接可能变化，其他社区的图片字段也可能为空或不可用。subscribers 不是活跃用户数，响应也不是订阅人数增长历史。社区年龄或人数变化需根据时间戳及本地保存的快照自行计算。lang 等字段应按返回的元数据理解，不要据此推断每篇讨论的语言。本查询不需要 Reddit 账号会话，也不会修改社区。

无需必填输入，即可请求文档化的热门社区列表。唯一可选参数是 cursor：首个请求省略，仅在实际返回续页值时使用。本接口尚未经过实测验证，使用前需确认当前响应结构、排序与分页行为。 文档样本中的 body 数组由社区对象组成，包含 display_name、display_name_prefixed、id、name、title、description、public_description、subscribers、created_utc、subreddit_type、url，以及 icon_img、community_icon 等图片字段。短简介和图片可能为空。popular 标签不能证明列表按订阅人数排序，也不代表增长最快或经过测算的趋势分数。可用 subreddit-info 逐个了解选定社区；历史对比需基于自己保存的快照计算。

无需必填输入，即可请求文档化的新建社区列表。cursor 为可选续页值，首个请求应省略。本接口尚未经过实测验证；用于时效敏感的社区发现前，请确认当前响应结构、游标行为与排序含义。 文档样本展示了由社区对象组成的 body 数组，包含 display_name、display_name_prefixed、id、name、title、description、public_description、created_utc、subscribers、subreddit_type、url 及可选图片字段。样本中有订阅人数很少的受限社区，因此出现在列表中，不等于允许公开访问、已有稳定受众或存在活跃讨论。请区分社区创建时间与自己的采集时间，并用 subreddit-info 了解候选社区，不要假设这是完整或严格按最新创建排序的社区目录。

仅传 Reddit 用户名，例如 spez，不要附带 u/ 或个人主页链接。已观察到的响应包含 meta.status、meta.username 与 body 对象，字段有 name、total_karma、link_karma、comment_karma、awardee_karma、awarder_karma、created_utc、is_gold、is_mod、verified 和 profile。profile 中包含 icon_img，以及带有 display_name、public_description、title、url 等公开资料字段的 subreddit 对象。实测 spez 的账号创建时间戳为 1118030400，公开个人主页链接为 /user/spez/。 karma 数值与公开资料文本均为可变化的快照。账号年龄需在自己的应用中根据 created_utc 计算。verified、is_mod 与 is_gold 只是返回的账号元数据，不是对身份、真实性或可信度的独立判定。本接口不返回用户的帖子和评论；活动列表见单独文档化的 user-data 接口，该接口的实时行为尚未经过验证。

传入不带前缀的用户名，使用文档化的公开活动列表。filter 选择 comments 或 posts，sortType 选择 new、hot 或 top，cursor 是可选续页值。配置默认值为 filter=comments、sortType=new。本接口尚未经过实测验证，上线前需确认筛选、排序、分页与当前可用性。 文档提供的评论样本包含 body 数组，记录字段有 id、name、author、body、body_html、created_utc、subreddit、parent_id、link_id、link_title、link_permalink、permalink 与 score。这是评论记录示例，不是所有模式均已验证的响应结构。不要假设帖子行也使用相同正文字段，或每个文档选项都会返回预期实体。续页只能使用实际返回的值，结果应视为有边界的公开活动样本，而不是完整账号档案，也不包含私密活动。