万有引擎
搜索⌘K
中文
登录免费开始

社交内容 · 数据 API

Reddit

Reddit API

搜索 Reddit 帖子，按 subreddit 社区或用户整理发帖，并读取单帖详情与评论文本；保留社区、作者和原帖链接，便于核对讨论出处。 调用 POST /api/v1/social ；返回结构化 JSON，$0.56 / 千次；失败不计费。

免费开始 看文档

5

个能力

$0.56 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Reddit 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordsort默认 10 · 最多 50同步$0.56 / 千次id · url · title · text · author_username · community · like_count · comment_count · posted_at · platform
subreddit_postssubredditdate_range, sort默认 10 · 最多 100同步$0.56 / 千次id · url · title · text · author_username · community · like_count · comment_count · posted_at · platform
post_detailurl——同步$0.56 / 千次id · url · title · text · author_username · community · like_count · comment_count · posted_at · platform
commentsurl—默认 10 · 最多 100同步$0.56 / 千次id · text · author_username · like_count · community · url · posted_at · platform
user_postsusernamedate_range, sort默认 10 · 最多 50同步$0.56 / 千次id · url · title · text · author_username · community · like_count · comment_count · posted_at · platform

Reddit 每个接口分别做什么

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

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

怎么调用 Reddit 社区帖子 API？

subreddit_posts

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

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

subreddit必填
subreddit_posts 的社区名，例如 python，或完整社区 URL。使用 r/ 前缀的短名当前采用字符剥离方式处理，名称以 r 开头时可能被误裁；这类目标优先填写完整 /r/社区名/ 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 特有返回字段与含义（1）
community
所属 subreddit 名称（不含 r/ 前缀）。

怎么调用 Reddit 内容详情 API？

post_detail

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

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

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

url必填
具体 Reddit 帖子 URL，返回该单帖元数据；不接受 sort 或 date_range。
Reddit 特有返回字段与含义（1）
community
所属 subreddit 名称（不含 r/ 前缀）。

怎么调用 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 等 10 个字段。

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

username必填
user_posts 的用户短名或完整 /user/用户名/ URL；以 u 开头的短名可能被当前前缀处理误裁，建议使用完整 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 特有返回字段与含义（1）
community
所属 subreddit 名称（不含 r/ 前缀）。
Reddit search 调用流程一次 Reddit search 调用的全过程：向 POST /api/v1/social 发送 platform="reddit"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、title、text、author_username 等字段；返回列表，单次最多 50 条，计费 $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 等字段；返回列表，单次最多 50 条，计费 $0.56 / 千次，失败与空结果不计费。

Reddit 原始字段名

EveryInfra 统一字段名

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

Reddit 的稀有字段名（当前目录）

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

  • community

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/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 表示平台未公开。
platform
数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。

请求填写示例

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

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

reddit_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的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,
  "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 常见问题

Reddit API 怎么调用？

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

Reddit API 怎么收费？

$0.56 / 千次，Reddit 全部 5 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 1,798 次 Reddit 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

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

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

Reddit API 返回哪些字段？

当前目录为 search 列出 id、url、title、text、author_username、community 等 10 个字段名。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「搜索 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 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 Reddit 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 5 个能力。无需信用卡。

更多社交内容 API

Behance APIB站 APIBluesky APIDailymotion APIDeviantArt APIDiscord API豆瓣 API抖音 API全部 89 平台 ↗

开始调用 Reddit API

加微信领 $1 免费额度，先选一个 Reddit 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始