x/
community-members

用 /i/communities/ 链接导出公开 X 社区的成员,返回每位成员的简介、位置、网站、认证标记和粉丝数等数据,每个社区最多 2,000 人。

X Community Members API

社区链接输入
每位成员一条资料
每个社区最多 2,000 人
每条结果 0.7 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

X Community Members

X 社区成员是主动加入某个主题社区的账号,每个人都有公开的主页资料:简介、位置、网站、认证状态、账号注册时间,以及粉丝数、关注数和发帖数。加入社区本身就是围绕某个话题的主动选择,因此这些资料描绘的是一群自我筛选出来的受众,可以估算规模、按影响力或地区细分,也可以和相邻社区的成员放在一起比较。

X Community Members API 主要特性

  • 凭社区链接拿到成员名单提交一个或多个 https://x.com/i/communities/<id> 链接,每个社区的每位成员都会作为一条独立的主页资料返回。
  • 看清每位成员是谁每条记录包含用户名、显示名称、text 中的简介、头像、封面图、网站和自填的位置,只看导出结果就能认出并描述这位成员。
  • 每位成员的影响力metrics 里有 followers_count、following_count 和 posts_count,能把社区里声量大的账号和大多数普通成员区分开。
  • 认证状态与账号年龄is_verified、is_private 和 published_at(成员 X 账号的注册时间)放在一起,一眼就能看出名单里每个人的账号有多成熟。

X Community Members API 参数

参数必填描述
urls必填公开 X 社区链接,格式为 https://x.com/i/communities/<numeric_id>,每行一个。
results_limit可选每个社区返回的成员数,取 20 到 2,000 之间 20 的倍数,默认 100。

如何使用 X Community Members API

提交社区链接,分页读取成员资料。

  1. 向 /v1/x/community-members 发送 {"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 100}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
  3. 从 results.items 读取成员资料;has_more 为 true 时,带上 results.next_cursor 继续读取。
curl -X POST "https://api.socq.ai/v1/x/community-members" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/communities/1493446837214187523"],"results_limit":100}'

# results_limit 分别作用于 urls 里的每个社区,这里提交两个链接最多可返回 200 位成员。

X Community Members API 最佳使用场景

  • 画出社区的受众画像: 按 location.name 给成员分组,从 text 里的简介找出职业和兴趣关键词,再看 followers_count 的分布,弄清楚到底是哪些人加入了这个社区。
  • 筛选值得合作的成员: 按 metrics.followers_count 排序,保留已认证账号,再结合 website 和简介,挑出某个细分领域里值得联系的创作者。
  • 计算两个社区的成员重合度: 分别导出两个相关社区的成员,按 id 匹配,统计同时加入两个社区的人数。
  • 排查社区里的新注册账号: 把较新的 published_at 与较低的 posts_count、followers_count 结合起来,估算社区成员中新注册或几乎不活跃账号的比例。

X Community Members API 使用建议

  • 打算比较不同社区的成员时,每个任务只提交一个社区:成员记录里只有主页资料,要靠任务输入才能知道每条记录属于哪个社区。
  • 先用 X Community 或 X Communities Search 查到 members_count,再把 results_limit 设成大于它的下一个 20 的倍数,一个任务就能请求完整名单。
  • 按国家分组前先清洗 location.name:它是成员自己填写的地点文字,例如 "Sydney",city 和 country 字段经常为空。

除了 X Community Members API,需要其他类型的 X 公开数据时,可以使用以下 API。

  • Twitter Profile Scraper API — 按 username 获取公开账号身份、简介、头像、封面、账号状态和可见受众统计。
  • X Followers List API — 按一个或多个 X 用户名采集公开关注者账号身份与可见资料指标。
  • X Following List API — 采集 X 公开账号关注的个人资料,包括身份、简介、账号状态、可见计数和来源 username。
  • X Community API — 通过社区链接读取主题说明、成员数量、规则和加入政策。
  • X Account Location API — 查询账号所在的国家或地区、连接 X 的方式、注册时间和改名次数。
  • X Community Moderators API — 获取运营社区的管理员和版主的完整主页资料。

探索其他平台

还可以将 X 数据与其他已支持社交平台的公开数据结合使用。

X Community Members API — 常见问题

X Community Members API 是一个用于通过 /i/communities/ 链接导出公开 X 社区成员的 API。它为每位成员返回一条主页资料,包括用户名、简介、位置、网站、认证状态,以及粉丝数、关注数和发帖数。

能。社区链接是唯一的输入,所以即使你从没加入过某个公开社区,也可以导出它的成员,整个过程也不涉及登录 X。

用 X Communities Search 搜关键词。每条结果都带有社区的 url,原样传给本接口即可。

最多 2,000 人。results_limit 取 20 到 2,000 之间 20 的倍数,默认 100,并且对请求里的每个社区链接分别计算。

不是。published_at 是这位成员 X 账号的注册时间,结果里没有加入社区的时间。

如果一次请求里的社区全都找不到,任务失败,积分全额退还;如果只是部分找不到,其余社区的成员照常返回。