提供已选 Reddit 帖子或评论链接，也可使用帖子 ID，设置每帖评论上限及可选排序、筛选条件，再让 Agent 按实际取得的讨论记录整理研究资料。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
提供已选 Reddit 帖子或评论链接，也可使用帖子 ID，设置每帖评论上限及可选排序、筛选条件，再让 Agent 按实际取得的讨论记录整理研究资料。
评论记录可能包含正文、公开用户名、净得分、发布时间、链接与回复关系，以及来源提供的编辑或管理标记。可选原帖记录另行补充帖子背景；针对特定评论的定向请求可包含其上级评论。Agent 可以归纳实际反馈，并保留来源背景。
请从[Reddit 帖子或评论链接]获取[最多 20 条评论和回复]，按[较新的评论优先]读取并只总结实际返回的内容。仅在我要求时才附上[原帖]；结果可能不完整。
访问限制、数量上限或筛选可能使结果不完整，缺少上级评论也可能导致对话断裂。请求条数不保证实际返回数量，原帖显示的评论总数不等于取得的子集条数。定向评论请求不包含下级回复；删除或移除标记不能恢复原文。得分与选定观点不证明内容真实或代表整体舆论，媒体地址也不是已下载文件。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
评论获取请求body | object | 必填 | 必填请求对象，包含至少一个帖子或评论目标，可设置评论上限、排序与筛选。
|
仅原帖作者评论body.onlyOP | boolean | 选填 | 默认 false。开启后仅保留原帖作者撰写的评论。这是作者筛选，不是只取顶层评论或指定回复深度。
|
包含作者body.authors | array | 选填 | 可选 Reddit 用户名列表，匹配不区分大小写。空列表关闭此包含筛选；作者排除条件随后生效，同时出现在两表中的用户名会被排除。 |
包含正文词句body.keywords | array | 选填 | 可选词语或短语，通过不区分大小写的子串匹配，保留正文包含任意一项的评论。不是语义或整词匹配，排除条件优先；空列表关闭此筛选。 |
最大回复深度body.maxDepth | integer | 选填 | 可选最深保留层级，范围 0–100：0 仅顶层评论，1 加上直接回复，2 再加回复的回复。省略时不设此深度上限，其他限制仍生效。
|
最小回复深度body.minDepth | integer | 选填 | 可选最浅保留层级，范围 0–100：0 包含顶层评论，1 保留回复及更深层，2 保留回复的回复及更深层。省略时不设此深度下限。
|
帖子或评论目标body.postUrls | array | 必填 | 必填非空列表。支持 Reddit 完整或简短帖子链接、特定评论链接、分享链接、redd.it 短链、old.reddit.com 链接，以及可带 t3_ 前缀的帖子 ID。无效项可能被跳过；预填目标是示例。
|
最少奖励数量body.minAwards | integer | 选填 | 可选奖励总数下限，包含边界值，范围 0–1,000,000；省略时不设此条件。奖励数是来源记录，不评定内容质量或真实性。
|
评论排序模式body.commentSort | string | 选填 | 默认 confidence（最佳）。另有 top（高分）、new（新）、controversial（争议）、old（旧）和 qa（问答）。请求来源排序，不保证全局最新、最热门或最负面的观点。
|
附带独立原帖记录body.includePost | boolean | 选填 | 默认 false。开启后，每个输入讨论先返回独立原帖记录，不计入评论上限。可用标题、正文、汇总计数或媒体地址属于帖子背景，不是额外评论或已交付文件。
|
每帖评论数量上限body.maxComments | integer | 选填 | 每个帖子的请求上限，包含嵌套回复，范围 1–100,000，默认 100。预填 30 是示例，不是默认值。筛选或访问限制可能使记录更少；这不是费用上限或完整讨论保证。
|
发布起始日期body.postedAfter | string | 选填 | 可选 YYYY-MM-DD 日期，按 UTC 保留该日及之后创建的评论，包含边界。筛选的是原始发布时间，不是编辑或获取时间；所示示例不是默认值。 |
发布结束日期body.postedBefore | string | 选填 | 可选 YYYY-MM-DD 日期，按 UTC 保留该日结束及之前创建的评论，包含边界。作用于原始发布时间，不是编辑或获取时间。 |
上级评论背景层数body.commentContext | integer | 选填 | 目标评论之上的上级评论层数，范围 0–8，默认 3。仅在开启 focusOnTargetComment 且提供特定评论链接时生效，其他情况下忽略。请求上级评论，不是下级回复。
|
排除作者body.excludeAuthors | array | 选填 | 可选 Reddit 用户名排除列表，不区分大小写。在 authors 之后生效，两表重叠的用户名被排除。空列表关闭此排除条件，其他筛选和访问限制仍适用。 |
排除正文词句body.excludeKeywords | array | 选填 | 可选正文子串排除列表，不区分大小写。包含任意所列词句的评论被丢弃，即使也匹配 keywords。空列表关闭此排除条件。 |
排除置顶评论body.excludeStickied | boolean | 选填 | 默认 false。开启后丢弃版主置顶的评论，例如置顶通知；不等于识别或排除版主撰写的全部评论。
|
净得分上限body.maxCommentScore | integer | 选填 | 可选净得分上限，包含边界值，范围 −1,000,000 至 1,000,000。净得分为赞成票减反对票，不是原始赞成票数。省略时不设此条件；隐藏或缺失得分仍分别处理。
|
净得分下限body.minCommentScore | integer | 选填 | 可选净得分下限，包含边界值，范围 −1,000,000 至 1,000,000。零和负数是有效值，不是缺失。省略时不设此条件。
|
排除折叠评论body.excludeCollapsed | boolean | 选填 | 默认 false。开启后丢弃 Reddit 默认折叠的评论。该状态不独立证明折叠原因，也不证明正文不真实。
|
正文长度上限body.maxCommentLength | integer | 选填 | 可选正文字符数上限，包含边界值，范围 0–10,000。按长度筛选评论，不截断正文。省略时不设此条件。
|
正文长度下限body.minCommentLength | integer | 选填 | 可选正文字符数下限，包含边界值，范围 0–10,000。按长度筛选，不分析含义或情绪。省略时关闭此条件；填写 0 不等于省略。
|
仅来源标记的争议评论body.controversialOnly | boolean | 选填 | 默认 false。开启后仅保留 Reddit 标记为争议的评论，标记与赞反票接近相关，不等于负面情绪、错误信息或真假判断。
|
官方身份评论标记body.distinguishedFilter | string | 选填 | 默认 any 不限制此标记。moderator（版主）或 admin（平台管理员）筛选带相应官方身份标记发布的评论；none 选择无此标记的评论。没有标记不证明作者本人不是版主或平台管理员。
|
定向获取特定评论body.focusOnTargetComment | boolean | 选填 | 默认 false。针对特定评论链接，开启后请求目标及其上级评论链，不获取讨论中的其他评论或下级回复。对普通帖子链接无效，也不保证取得不可访问的内容。
|
排除删除或移除标记body.excludeDeletedRemoved | boolean | 选填 | 默认 false。开启后，正文或作者显示删除、移除标记的评论被丢弃，因此作者标记也可能排除仍保留的正文。关闭时可能保留标记，但不能恢复已删除原文。
|
{
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"title": "Reddit Comment Scraper Input",
"required": [
"postUrls"
],
"properties": {
"onlyOP": {
"type": "boolean",
"title": "Only original poster's comments",
"default": false,
"prefill": false,
"description": "默认 false。开启后仅保留原帖作者撰写的评论。这是作者筛选，不是只取顶层评论或指定回复深度。"
},
"authors": {
"type": "array",
"title": "Filter by comment author(s)",
"editor": "stringList",
"example": [
"spez"
],
"description": "可选 Reddit 用户名列表，匹配不区分大小写。空列表关闭此包含筛选；作者排除条件随后生效，同时出现在两表中的用户名会被排除。"
},
"keywords": {
"type": "array",
"title": "Filter by keyword(s) in comment body",
"editor": "stringList",
"example": [
"thanks",
"great point"
],
"description": "可选词语或短语，通过不区分大小写的子串匹配，保留正文包含任意一项的评论。不是语义或整词匹配，排除条件优先；空列表关闭此筛选。"
},
"maxDepth": {
"type": "integer",
"title": "Maximum reply depth",
"example": 2,
"maximum": 100,
"minimum": 0,
"description": "可选最深保留层级，范围 0–100：0 仅顶层评论，1 加上直接回复，2 再加回复的回复。省略时不设此深度上限，其他限制仍生效。"
},
"minDepth": {
"type": "integer",
"title": "Minimum reply depth",
"example": 1,
"maximum": 100,
"minimum": 0,
"description": "可选最浅保留层级，范围 0–100：0 包含顶层评论，1 保留回复及更深层，2 保留回复的回复及更深层。省略时不设此深度下限。"
},
"postUrls": {
"type": "array",
"title": "Reddit Post URLs",
"editor": "stringList",
"example": [
"https://www.reddit.com/r/programming/comments/1vqukkf/nothing_like_a_monday_morning_github_outage/",
"https://www.reddit.com/comments/1tlh5aj"
],
"prefill": [
"https://www.reddit.com/r/programming/comments/1vqukkf/"
],
"minItems": 1,
"description": "必填非空列表。支持 Reddit 完整或简短帖子链接、特定评论链接、分享链接、redd.it 短链、old.reddit.com 链接，以及可带 t3_ 前缀的帖子 ID。无效项可能被跳过；预填目标是示例。"
},
"minAwards": {
"type": "integer",
"title": "Minimum total awards received",
"example": 1,
"maximum": 1000000,
"minimum": 0,
"description": "可选奖励总数下限，包含边界值，范围 0–1,000,000；省略时不设此条件。奖励数是来源记录，不评定内容质量或真实性。"
},
"commentSort": {
"enum": [
"confidence",
"top",
"new",
"controversial",
"old",
"qa"
],
"type": "string",
"title": "Sort comments by",
"default": "confidence",
"prefill": "confidence",
"enumTitles": [
"Best (Confidence)",
"Top",
"New",
"Controversial",
"Old",
"Q&A"
],
"description": "默认 confidence（最佳）。另有 top（高分）、new（新）、controversial（争议）、old（旧）和 qa（问答）。请求来源排序，不保证全局最新、最热门或最负面的观点。"
},
"includePost": {
"type": "boolean",
"title": "Include the parent post record",
"default": false,
"prefill": false,
"description": "默认 false。开启后，每个输入讨论先返回独立原帖记录，不计入评论上限。可用标题、正文、汇总计数或媒体地址属于帖子背景，不是额外评论或已交付文件。"
},
"maxComments": {
"type": "integer",
"title": "Maximum comments per post",
"default": 100,
"example": 100,
"maximum": 100000,
"minimum": 1,
"prefill": 30,
"description": "每个帖子的请求上限，包含嵌套回复，范围 1–100,000，默认 100。预填 30 是示例，不是默认值。筛选或访问限制可能使记录更少；这不是费用上限或完整讨论保证。"
},
"postedAfter": {
"type": "string",
"title": "Comments created on or after (YYYY-MM-DD)",
"editor": "datepicker",
"example": "2025-01-01",
"description": "可选 YYYY-MM-DD 日期，按 UTC 保留该日及之后创建的评论，包含边界。筛选的是原始发布时间，不是编辑或获取时间；所示示例不是默认值。"
},
"postedBefore": {
"type": "string",
"title": "Comments created on or before (YYYY-MM-DD)",
"editor": "datepicker",
"example": "2025-12-31",
"description": "可选 YYYY-MM-DD 日期，按 UTC 保留该日结束及之前创建的评论，包含边界。作用于原始发布时间，不是编辑或获取时间。"
},
"commentContext": {
"type": "integer",
"title": "Ancestor context depth (mode = focusOnTargetComment)",
"default": 3,
"maximum": 8,
"minimum": 0,
"prefill": 3,
"description": "目标评论之上的上级评论层数，范围 0–8，默认 3。仅在开启 focusOnTargetComment 且提供特定评论链接时生效，其他情况下忽略。请求上级评论，不是下级回复。"
},
"excludeAuthors": {
"type": "array",
"title": "Exclude comment author(s)",
"editor": "stringList",
"example": [
"AutoModerator"
],
"description": "可选 Reddit 用户名排除列表，不区分大小写。在 authors 之后生效，两表重叠的用户名被排除。空列表关闭此排除条件，其他筛选和访问限制仍适用。"
},
"excludeKeywords": {
"type": "array",
"title": "Exclude keyword(s) in comment body",
"editor": "stringList",
"example": [
"I am a bot",
"check out my"
],
"description": "可选正文子串排除列表，不区分大小写。包含任意所列词句的评论被丢弃，即使也匹配 keywords。空列表关闭此排除条件。"
},
"excludeStickied": {
"type": "boolean",
"title": "Exclude stickied comments",
"default": false,
"prefill": false,
"description": "默认 false。开启后丢弃版主置顶的评论，例如置顶通知；不等于识别或排除版主撰写的全部评论。"
},
"maxCommentScore": {
"type": "integer",
"title": "Maximum comment score",
"example": 1000,
"maximum": 1000000,
"minimum": -1000000,
"description": "可选净得分上限，包含边界值，范围 −1,000,000 至 1,000,000。净得分为赞成票减反对票，不是原始赞成票数。省略时不设此条件；隐藏或缺失得分仍分别处理。"
},
"minCommentScore": {
"type": "integer",
"title": "Minimum comment score",
"example": 1,
"maximum": 1000000,
"minimum": -1000000,
"description": "可选净得分下限，包含边界值，范围 −1,000,000 至 1,000,000。零和负数是有效值，不是缺失。省略时不设此条件。"
},
"excludeCollapsed": {
"type": "boolean",
"title": "Exclude collapsed comments",
"default": false,
"prefill": false,
"description": "默认 false。开启后丢弃 Reddit 默认折叠的评论。该状态不独立证明折叠原因，也不证明正文不真实。"
},
"maxCommentLength": {
"type": "integer",
"title": "Maximum comment length (characters)",
"example": 2000,
"maximum": 10000,
"minimum": 0,
"description": "可选正文字符数上限，包含边界值，范围 0–10,000。按长度筛选评论，不截断正文。省略时不设此条件。"
},
"minCommentLength": {
"type": "integer",
"title": "Minimum comment length (characters)",
"example": 20,
"maximum": 10000,
"minimum": 0,
"description": "可选正文字符数下限，包含边界值，范围 0–10,000。按长度筛选，不分析含义或情绪。省略时关闭此条件；填写 0 不等于省略。"
},
"controversialOnly": {
"type": "boolean",
"title": "Only controversial comments",
"default": false,
"prefill": false,
"description": "默认 false。开启后仅保留 Reddit 标记为争议的评论，标记与赞反票接近相关，不等于负面情绪、错误信息或真假判断。"
},
"distinguishedFilter": {
"enum": [
"any",
"moderator",
"admin",
"none"
],
"type": "string",
"title": "Filter by distinguished status",
"editor": "select",
"default": "any",
"prefill": "any",
"enumTitles": [
"Any (default)",
"Moderator only",
"Admin only",
"Regular users only (exclude mod/admin)"
],
"description": "默认 any 不限制此标记。moderator（版主）或 admin（平台管理员）筛选带相应官方身份标记发布的评论；none 选择无此标记的评论。没有标记不证明作者本人不是版主或平台管理员。"
},
"focusOnTargetComment": {
"type": "boolean",
"title": "Focus on the specific comment in the URL",
"default": false,
"prefill": false,
"description": "默认 false。针对特定评论链接，开启后请求目标及其上级评论链，不获取讨论中的其他评论或下级回复。对普通帖子链接无效，也不保证取得不可访问的内容。"
},
"excludeDeletedRemoved": {
"type": "boolean",
"title": "Exclude deleted/removed comments",
"default": false,
"prefill": false,
"description": "默认 false。开启后，正文或作者显示删除、移除标记的评论被丢弃，因此作者标记也可能排除仍保留的正文。关闭时可能保留标记，但不能恢复已删除原文。"
}
},
"schemaVersion": 1
}
},
"additionalProperties": false
}暂未配置返回字段说明。
评论发布时间与编辑时间、获取时间不同，比较记录时应分别保留。回复关系缺少节点时，不用推测评论补全。
来源：Reddit 评论获取文档。
粘贴[想查看的 Reddit 帖子或评论链接]。如果想查看某条评论及其上文，请提供[该评论的分享链接]。
请从[Reddit 帖子或评论链接]获取[最多 20 条评论和回复]，按[较新的评论优先]读取并只总结实际返回的内容。仅在我要求时才附上[原帖]；结果可能不完整。
阅读实际返回的评论正文和发布时间；在信息可用时，查看每条回复对应的评论。部分评论或回复可能缺失，已删除的正文无法恢复。
原帖总数是独立来源计数，可能包含不可访问或已移除评论，也可能滞后。本次结果受访问、每帖上限和筛选影响。上限包含嵌套回复；可选原帖属于另一类记录，不计入该上限。
开启定向模式时，请求该评论及所选层数的上级评论，不取其下级回复。不开启时，评论链接用于普通讨论获取。两种模式都不恢复不可访问内容，也不保证完整对话。
不能。只能保留来源仍提供的删除或移除标记，不能恢复原文。开启排除时也检查作者标记，因此可能丢弃正文仍保留的评论。应把实际标记与推测的移除原因区分。