[中文]

用途:

• 执行Reddit APP动态搜索,支持搜索帖子、社区、评论、媒体和用户

参数:

• query: 搜索关键词或搜索表达式；帖子搜索默认可匹配标题或正文中的部分关键词，详细语法见下方说明
• search_type: 搜索类型,可选值:
  • post: 搜索帖子(默认)
  • community: 搜索社区/版块
  • comment: 搜索评论
  • media: 搜索媒体(图片/视频/GIF)
  • people: 搜索用户
• sort: 排序方式(仅适用于post/comment/media类型),可选值:
  • RELEVANCE: 相关性
  • HOT: 热门
  • TOP: 最受欢迎
  • NEW: 最新
  • COMMENTS: 评论数(仅适用于post类型)
• time_range: 时间范围(仅适用于post/media类型),可选值:
  • all: 所有时间
  • year: 去年
  • month: 上个月
  • week: 上周
  • day: 今天
  • hour: 过去1小时
• safe_search: 安全搜索设置,"unset"或"strict"
• allow_nsfw: 是否允许NSFW内容,"0"或"1"
• after: 分页游标；need_format=true时，将pageInfo.endCursor原样传入以获取下一页
• need_format: 默认false；true时将data精简为children和pageInfo，保留结果核心内容及翻页参数

返回:

• need_format=false: 返回原始嵌套搜索结果数据
• need_format=true: data仅包含:
  • children: 结果列表，按search_type包含post、comment、community或author等对应内容
  • pageInfo: 分页信息，保留endCursor、startCursor、hasNextPage和hasPreviousPage等可用字段
• children为空列表时表示没有结果；hasNextPage为true时，可继续使用endCursor翻页
• 精简结果保留ID、标题、正文、时间、统计、作者、社区和媒体等核心内容；正文优先保留markdown，移除重复正文表示和重复尺寸头像

注意:

• community和people类型不支持sort和time_range参数
• COMMENTS排序方式仅适用于post类型
• time_range参数仅适用于post和media类型
• 帖子搜索中，TOP和NEW分别按受欢迎程度和发布时间排序，不保证结果包含query的全部关键词；需要全部匹配时请使用AND
• time_range限制结果的时间范围，不改变关键词匹配条件
• need_format=true移除冗余字段、辅助展示信息、用户交互状态和空值，保留false和0等有效值，以及分页中的null结束游标
• 翻页时保持query、search_type、sort及其他筛选条件与上一页一致

精简结果示例:

{
  "children": [{"post": {"id": "t3_abc123", "postTitle": "Rust borrow checker", "score": 0}}],
  "pageInfo": {"endCursor": "<cursor>", "hasNextPage": true, "hasPreviousPage": false}
}

帖子搜索语法:

• AND、OR、NOT必须大写；字段冒号后不要加空格，例如subreddit:rust
• 字段中的多词短语需要引号，例如title:"borrow checker"
• 可组合字段，例如title:"borrow checker" subreddit:rust，再配合sort=TOP或sort=NEW
• 使用HTTP客户端的查询参数编码功能传递query，保留空格、引号和括号
• Reddit官方搜索语法说明
• Reddit官方排序说明

[English]

Purpose:

• Perform Reddit APP dynamic search, supporting posts, communities, comments, media, and users

Parameters:

• query: Search keywords or expression; post searches may match only some terms in titles or post bodies. See the syntax reference below
• search_type: Search type, options:
  • post: Search posts (default)
  • community: Search communities/subreddits
  • comment: Search comments
  • media: Search media (images/videos/GIFs)
  • people: Search users
• sort: Sort method (only for post/comment/media types), options:
  • RELEVANCE: By relevance
  • HOT: Hot/trending
  • TOP: Most popular
  • NEW: Newest
  • COMMENTS: By comment count (only for post type)
• time_range: Time range (only for post/media types), options:
  • all: All time
  • year: Past year
  • month: Past month
  • week: Past week
  • day: Today
  • hour: Past hour
• safe_search: Safe search setting, "unset" or "strict"
• allow_nsfw: Allow NSFW content, "0" or "1"
• after: Pagination cursor; when need_format=true, pass pageInfo.endCursor unchanged to fetch the next page
• need_format: Defaults to false; true reduces data to children and pageInfo, retaining core result content and pagination

Returns:

• need_format=false: Original nested search result data
• need_format=true: data contains only:
  • children: Results containing the corresponding post, comment, community or author content for search_type
  • pageInfo: Available pagination fields, including endCursor, startCursor, hasNextPage and hasPreviousPage
• An empty children list means no results; when hasNextPage is true, continue using endCursor
• Compact results retain IDs, titles, content, timestamps, statistics, authors, communities and media. Markdown is preferred for bodies; duplicate body representations and avatar sizes are removed

Notes:

• community and people types do not support sort and time_range parameters
• COMMENTS sort option only applies to post type
• time_range parameter only applies to post and media types
• For post searches, TOP and NEW sort by popularity and publication time respectively; results may match only some query terms. Use AND when all terms are required
• time_range limits the age of results without changing keyword matching conditions
• need_format=true removes redundant fields, auxiliary presentation details, user interaction state and empty values; valid false and 0 values and null terminal pagination cursors are retained
• Keep query, search_type, sort and other filters unchanged when fetching subsequent pages

Compact result example:

{
  "children": [{"post": {"id": "t3_abc123", "postTitle": "Rust borrow checker", "score": 0}}],
  "pageInfo": {"endCursor": "<cursor>", "hasNextPage": true, "hasPreviousPage": false}
}

Post search syntax:

• AND, OR and NOT must be uppercase. Do not add spaces after field colons, e.g. subreddit:rust
• Quote multi-word field values, e.g. title:"borrow checker"
• Combine fields, e.g. title:"borrow checker" subreddit:rust, with sort=TOP or sort=NEW
• Use your HTTP client's query parameter encoding to preserve spaces, quotes and parentheses in query
• Official Reddit search syntax
• Official Reddit sorting reference

[示例/Example]

query="python programming" search_type="post" sort="RELEVANCE" time_range="all" safe_search="unset" allow_nsfw="0" after="" need_format=false