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
提交社区链接,分页读取成员资料。
- 向 /v1/x/community-members 发送 {"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 100}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
- 从 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 字段经常为空。
相关 API
除了 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 — 获取运营社区的管理员和版主的完整主页资料。
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API