按主题搜索 Reddit，或从社区、帖子、用户主页链接开始，整理工具可获取的帖子、评论、账号或社区公开资料。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
按主题搜索 Reddit，或从社区、帖子、用户主页链接开始，整理工具可获取的帖子、评论、账号或社区公开资料。
帖子记录可能包含标题、正文、链接、作者和社区背景、日期、来源投票数与评论数量。已获取评论可能包含正文及原帖背景。社区或用户记录视所选采集方式和设置，可能提供描述、链接、成员数量、账号资料或 karma。媒体仅以可用引用地址呈现。
查找提到[电动汽车充电]的 Reddit 评论，最多[5 条]；整理评论内容及其所属帖子（如能获取）。
关键词评论搜索先找到匹配帖子，再筛选这些帖子的评论，不是对全部 Reddit 评论的完整检索。数量上限按每个查询或链接任务计算，不是整次请求总上限，也不保证固定条数或完整对话。资料缺失或采集失败不代表内容或账号不存在。投票、karma 和成员数量不验证身份、去重受众规模或代表性舆论。重复采集可能包含重复记录，媒体引用不等于已交付文件。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
Reddit 采集设置body | object | 选填 | 可选关键词、链接、记录类型、顺序、帖子时间范围及评论和账号设置。要进行有用采集，需提供可用查询或支持的 Reddit 链接。所选模式和链接类型决定可用记录。 |
结果顺序body.sort | string | 选填 | 可选，默认 relevance（相关性）。关键词搜索支持 relevance、new（新帖）、top（高排名）、hot（热门）、comments（评论排序）；社区内容列表支持 hot、new、top、controversial（争议）、rising（上升）。社区列表使用 relevance 时回退为 hot。relevance 和 comments 仅用于搜索，不应假设关键词搜索支持 controversial 或 rising，也不保证完整或精确排名。
|
帖子创建时间范围body.time | string | 选填 | 可选，默认 all（不限时间）。选项为 all、day（日范围）、hour（小时范围）、month（月范围）、week（周范围）或 year（年范围），作用于关键词搜索和社区列表中的帖子创建时间。all 不限制时间，不代表无限数量。它不筛选评论发布时间或账号年龄，未明确具体时区和日历边界。
|
每个采集任务的记录上限body.maxItems | integer | 选填 | 可选整数，范围 1–100，默认 25。按每个查询、社区或链接任务请求结果上限，多项输入可能使总记录数更高。这不是整次请求或费用上限，不保证固定条数、去重，或为每个嵌套评论及所选记录类型分别提供独立上限。
|
搜索查询列表body.searches | array | 选填 | 可选关键词或短语列表。每条查询独立运行，按启用的搜索类型请求记录；没有社区范围时搜索 Reddit。社区链接与查询合用可限定该社区，忽略链接时则不保留此范围。引号按来源说明请求精确短语匹配；预填 apify 是示例，不是默认值。 |
单条搜索查询body.searches[] | string | — | searches 中的字符串关键词或短语，所选搜索模式决定请求的记录类型。增加一条查询会增加一个采集任务，可能提高总返回数量或用量。 |
已选 Reddit 链接body.startUrls | array | 选填 | 可选对象列表，每项包含 url。社区链接请求内容列表，帖子链接请求该帖及可选评论，用户链接请求账号资料及可选近期帖子。社区链接可限定已提供的查询；即使同时有查询，帖子和用户链接仍直接获取。ignorestartUrls 为 true 时忽略全部链接。预填 JavaScript 社区是示例，不是默认值。 |
单个链接条目body.startUrls[] | object | — | startUrls 中的对象；每个已提供条目必须包含 url 字符串。使用支持的社区、帖子或用户链接；提供条目不保证内容可访问。
|
条目中的 Reddit 链接body.startUrls[].url | string | — | 每个已提供链接条目内的必填字符串，可指向 Reddit 社区、帖子或用户页，例如 https://www.reddit.com/r/javascript/。Reddit 链接模式检查形式，不证明存在、可访问或完整覆盖。ignorestartUrls 为 true 时忽略该链接。
|
包含 NSFW 标记内容body.includeNSFW | boolean | 选填 | 可选，默认 false。true 包含平台标为 NSFW 的可用内容，不绕过访问限制，也不证明安全性、年龄或完整覆盖此类内容。
|
搜索帖子记录body.searchPosts | boolean | 选填 | 可选，默认 true。请求标题或正文匹配查询的帖子及其可用文字和来源计数。仅需其他搜索类型时可关闭；关闭不会取消评论搜索内部查找匹配帖子的步骤，也不会自动取得每个帖子的评论正文。
|
搜索用户记录body.searchUsers | boolean | 选填 | 可选，默认 false。请求匹配查询的 Reddit 账号，以及可用账号资料、karma 或账号年龄背景。这是搜索类型选择，不独立验证身份，也不保证完整账号历史。
|
跳过直接帖子评论body.skipComments | boolean | 选填 | 可选，默认 false。对直接帖子链接，false 请求可用评论，可能包含回复；true 获取帖子而不采集这些评论，不保证完整讨论。它不会关闭 fetchPostComments，也不是评论搜索的全局开关。
|
跳过额外社区资料body.skipCommunity | boolean | 选填 | 可选，默认 true。采集社区内容列表时跳过额外社区资料请求；false 可能附带可用成员数、描述或链接背景。它不关闭 searchCommunities，也不取消社区帖子采集。
|
跳过直接账号的近期帖子body.skipUserPosts | boolean | 选填 | 可选，默认 false。对直接用户主页链接，false 另请求可用近期帖子；true 仅请求账号资料，不附带这些帖子。不保证完整历史，也不关闭 searchUsers。
|
搜索匹配评论body.searchComments | boolean | 选填 | 可选，默认 false。先寻找匹配查询的帖子，再从这些帖子中过滤匹配查询的评论，因此可能漏掉其他帖子的评论，不是完整全站评论检索。比帖子搜索使用更多 API 请求，与 fetchPostComments 分开。
|
忽略全部起始链接body.ignorestartUrls | boolean | 选填 | 可选，默认 false。true 忽略全部 startUrls，只按查询采集，同时移除社区链接提供的搜索范围；该模式需提供 searches。false 保留支持的链接与查询采集方式。
|
为帖子附加顶层评论body.fetchPostComments | boolean | 选填 | 可选，默认 false。true 为社区列表或关键词搜索返回的每个帖子另请求可用顶层评论，每帖增加一次 API 请求；不按关键词过滤这些评论，也不保证完整回复树。它与直接链接的 skipComments 和匹配评论搜索分开。
|
搜索社区记录body.searchCommunities | boolean | 选填 | 可选，默认 false。请求名称或描述匹配查询的社区，以及可用成员数量、描述和链接。它与 skipCommunity 控制的额外社区资料分开，不保证取得所有匹配社区。
|
{
"type": "object",
"required": [],
"properties": {
"body": {
"type": "object",
"title": "Reddit Scraper Input Schema",
"required": [],
"properties": {
"sort": {
"enum": [
"relevance",
"hot",
"new",
"top",
"comments",
"controversial",
"rising"
],
"type": "string",
"title": "Sort By",
"editor": "select",
"default": "relevance",
"description": "可选，默认 relevance（相关性）。关键词搜索支持 relevance、new（新帖）、top（高排名）、hot（热门）、comments（评论排序）；社区内容列表支持 hot、new、top、controversial（争议）、rising（上升）。社区列表使用 relevance 时回退为 hot。relevance 和 comments 仅用于搜索，不应假设关键词搜索支持 controversial 或 rising，也不保证完整或精确排名。"
},
"time": {
"enum": [
"all",
"day",
"hour",
"month",
"week",
"year"
],
"type": "string",
"title": "Time Filter",
"editor": "select",
"default": "all",
"description": "可选，默认 all（不限时间）。选项为 all、day（日范围）、hour（小时范围）、month（月范围）、week（周范围）或 year（年范围），作用于关键词搜索和社区列表中的帖子创建时间。all 不限制时间，不代表无限数量。它不筛选评论发布时间或账号年龄，未明确具体时区和日历边界。"
},
"maxItems": {
"type": "integer",
"title": "Max Items",
"default": 25,
"maximum": 100,
"minimum": 1,
"description": "可选整数，范围 1–100，默认 25。按每个查询、社区或链接任务请求结果上限，多项输入可能使总记录数更高。这不是整次请求或费用上限，不保证固定条数、去重，或为每个嵌套评论及所选记录类型分别提供独立上限。"
},
"searches": {
"type": "array",
"items": {
"type": "string"
},
"title": "Search Queries",
"editor": "stringList",
"prefill": [
"apify"
],
"description": "可选关键词或短语列表。每条查询独立运行，按启用的搜索类型请求记录；没有社区范围时搜索 Reddit。社区链接与查询合用可限定该社区，忽略链接时则不保留此范围。引号按来源说明请求精确短语匹配；预填 apify 是示例，不是默认值。"
},
"startUrls": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL",
"pattern": "^(https?:\\/\\/)?(www\\.)?reddit\\.com\\/.+$",
"description": "每个已提供链接条目内的必填字符串，可指向 Reddit 社区、帖子或用户页，例如 https://www.reddit.com/r/javascript/。Reddit 链接模式检查形式，不证明存在、可访问或完整覆盖。ignorestartUrls 为 true 时忽略该链接。"
}
}
},
"title": "Start URLs",
"editor": "requestListSources",
"prefill": [
{
"url": "https://www.reddit.com/r/javascript/"
}
],
"description": "可选对象列表，每项包含 url。社区链接请求内容列表，帖子链接请求该帖及可选评论，用户链接请求账号资料及可选近期帖子。社区链接可限定已提供的查询；即使同时有查询，帖子和用户链接仍直接获取。ignorestartUrls 为 true 时忽略全部链接。预填 JavaScript 社区是示例，不是默认值。"
},
"includeNSFW": {
"type": "boolean",
"title": "Include NSFW",
"default": false,
"description": "可选，默认 false。true 包含平台标为 NSFW 的可用内容，不绕过访问限制，也不证明安全性、年龄或完整覆盖此类内容。"
},
"searchPosts": {
"type": "boolean",
"title": "Search Posts",
"default": true,
"description": "可选，默认 true。请求标题或正文匹配查询的帖子及其可用文字和来源计数。仅需其他搜索类型时可关闭；关闭不会取消评论搜索内部查找匹配帖子的步骤，也不会自动取得每个帖子的评论正文。"
},
"searchUsers": {
"type": "boolean",
"title": "Search Users",
"default": false,
"description": "可选，默认 false。请求匹配查询的 Reddit 账号，以及可用账号资料、karma 或账号年龄背景。这是搜索类型选择，不独立验证身份，也不保证完整账号历史。"
},
"skipComments": {
"type": "boolean",
"title": "Skip Comments (for direct post URLs)",
"default": false,
"description": "可选，默认 false。对直接帖子链接，false 请求可用评论，可能包含回复；true 获取帖子而不采集这些评论，不保证完整讨论。它不会关闭 fetchPostComments，也不是评论搜索的全局开关。"
},
"skipCommunity": {
"type": "boolean",
"title": "Skip Community Info",
"default": true,
"description": "可选，默认 true。采集社区内容列表时跳过额外社区资料请求；false 可能附带可用成员数、描述或链接背景。它不关闭 searchCommunities，也不取消社区帖子采集。"
},
"skipUserPosts": {
"type": "boolean",
"title": "Skip User Posts",
"default": false,
"description": "可选，默认 false。对直接用户主页链接，false 另请求可用近期帖子；true 仅请求账号资料，不附带这些帖子。不保证完整历史，也不关闭 searchUsers。"
},
"searchComments": {
"type": "boolean",
"title": "Search Comments",
"default": false,
"description": "可选，默认 false。先寻找匹配查询的帖子，再从这些帖子中过滤匹配查询的评论，因此可能漏掉其他帖子的评论，不是完整全站评论检索。比帖子搜索使用更多 API 请求，与 fetchPostComments 分开。"
},
"ignorestartUrls": {
"type": "boolean",
"title": "Ignore Start URLs",
"default": false,
"description": "可选，默认 false。true 忽略全部 startUrls，只按查询采集，同时移除社区链接提供的搜索范围；该模式需提供 searches。false 保留支持的链接与查询采集方式。"
},
"fetchPostComments": {
"type": "boolean",
"title": "Fetch Comments for Each Post",
"default": false,
"description": "可选，默认 false。true 为社区列表或关键词搜索返回的每个帖子另请求可用顶层评论，每帖增加一次 API 请求；不按关键词过滤这些评论，也不保证完整回复树。它与直接链接的 skipComments 和匹配评论搜索分开。"
},
"searchCommunities": {
"type": "boolean",
"title": "Search Communities",
"default": false,
"description": "可选，默认 false。请求名称或描述匹配查询的社区，以及可用成员数量、描述和链接。它与 skipCommunity 控制的额外社区资料分开，不保证取得所有匹配社区。"
}
},
"description": "可选关键词、链接、记录类型、顺序、帖子时间范围及评论和账号设置。要进行有用采集，需提供可用查询或支持的 Reddit 链接。所选模式和链接类型决定可用记录。",
"schemaVersion": 1,
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
账号创建日期描述账号年龄，帖子或评论发布日期描述内容，采集日期描述获取过程。应保留各日期及其实际单位，并放在对应返回背景中。
搜索[主题短语，例如电动汽车充电]。工具会先找到提到该短语的帖子，再筛选其中的评论，因此其他帖子里的相关评论可能会遗漏。
查找提到[电动汽车充电]的 Reddit 评论，最多[5 条]；整理评论内容及其所属帖子（如能获取）。
粘贴[Reddit 社区、帖子或用户主页链接]即可，不需要知道账号或帖子编号。帖子链接可获取其中可用的评论；返回内容可能不完整。
这项搜索先寻找匹配查询的帖子，再过滤这些帖子的评论。评论虽匹配，但所属帖子不在初始选择范围时可能被遗漏。searchPosts 控制返回的帖子结果，关闭它不会绕过内部匹配帖子步骤。直接帖子链接通过 skipComments 请求可用评论；fetchPostComments 则另为社区列表或搜索帖子附加顶层评论。这些方式不保证完整对话，也可能增加请求用量。
可以。社区链接与查询合用时，将查询限定在该社区；没有该范围时搜索 Reddit。即使同时有查询，帖子和用户链接仍直接获取。ignorestartUrls 为 true 时忽略所有链接，也移除社区范围。实际记录由采集方式和开关决定，不应假设每组混合输入都会同时产生限定搜索和额外的未筛选社区列表。
maxItems 范围为 1–100，默认 25，按每个查询、社区或链接任务计算；多项输入的总记录数可能更高。它不保证精确条数，也不是附加获取的费用上限。time 控制搜索和社区列表的帖子创建时间，不控制评论发布时间或账号年龄；all 不限制该时间，但不保证完整历史。重复采集可能返回重复内容，来源计数也不是经验证的受众或情绪指标。