Community(社区)对象

2 个平台的 3 个接口都返回 Community(社区)对象,8 个字段名完全一样,给一个平台写的代码不用改就能读其他平台。每次调用 $0.0004 到 $0.0020。它是预览结构,之后可能调整。

预览对象 · 更新于 2026-10-17在 ChatGPT 里打开在 Claude 里打开

社区(Community)是人们加入、在里面发帖的地方:Reddit 的子版块(subreddit),X 的社群。它有名称、简介,metrics.members 是成员数。

id 可以原样传给取社区资料和取社区帖子的接口;Reddit 的社区编号就是社区名。社区里的帖子按内容对象返回,X 社群的成员按账号对象返回。

字段

平台给不了的字段不会出现在这条数据里,而是写在 meta.unavailable 里。不会用猜的数或 0 顶上。

id 文本

编号,可原样传给取社区资料和取社区帖子的接口

name 文本

社区的名称

url 链接

能直接打开的链接

description 文本

社区的简介

avatar_url 链接 standard

社区的图标

nsfw 是否 standard

是否标为成人内容

created_at 时间 standard

社区创建时间

metrics 对象

社区的数字

metrics.members 整数

成员数

每个数取的是平台上的哪个数

同一个字段名,在不同平台上对应的动作不完全一样。这张表写明这个字段取的是平台自己的哪个数。

字段在那里是什么平台
id社区名:Reddit 的社区凭名字定位,社区帖子接口收的也是它Reddit
社区名,可原样传给社区资料和社区帖子接口Reddit
name社区名,不带 r/;版主写的标题在 ext.titleReddit
社区名,不带 r/Reddit
metrics.members订阅这个社区的人数Reddit

哪些平台给不了哪些字段

一个平台的所有接口都给不了某个字段时,它才列在那个字段后面。

字段给不了的平台
avatar_urlX(推特)
同一个平台上,可能一个接口给不了、另一个接口能给:每个接口的页面列着它给不了的字段,每次返回也都写在 meta.unavailable 里。

返回 Community(社区)的接口

每个平台旁边的数字,是它有几个接口返回这种对象。

接口路径价格
X 社群资料GET/v1/x/communities/get$0.0004
Reddit 社区资料GET/v1/reddit/subreddits/get$0.0020
Reddit 用户活跃社区GET/v1/reddit/users/subreddits/list$0.0020

示例

x.communities.get 返回的一条,录制于 2026-10-12 21:39 UTC。名字、正文和编号是示例,链接也是;数字是原样。

Community(社区) · x.communities.get
{
  "id": "1880166407908944826",
  "name": "Gear talk",
  "url": "https://x.com/i/communities/1880166407908944826",
  "description": "Photos, trails and too much coffee.",
  "nsfw": false,
  "created_at": "2022-02-15T04:47:27.000Z",
  "metrics": { "members": 268685 }
}

完整的返回在这个接口的页面上 →

相关

其他对象