X Community Moderators
X 社区管理员和版主负责让社区讨论不跑题,社区规则由他们制定,哪些帖子和成员能留下也由他们决定;每个人都有公开主页,可以看到简介、网站、位置、认证状态和粉丝数。弄清楚管理团队里有谁、每个人自己的影响力有多大,就知道一个社区该找谁沟通,以及它背后到底是谁在运营。
X Community Moderators API 主要特性
- 一次拿到完整管理团队每个社区链接会在同一个任务里返回全部管理员和版主,返回多少人由管理团队本身的规模决定。
- 可直接用于联系的资料每位团队成员都带有用户名、显示名称、text 中的简介、网站、位置、头像和封面图,通常足以判断该通过什么方式联系到对方。
- 每位版主的分量粉丝数、关注数、发帖数与 is_verified 和 published_at(账号注册时间)放在一起,可以判断社区是否由成熟账号在运营。
X Community Moderators API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 要查询管理员和版主的公开 X 社区链接,格式为 https://x.com/i/communities/<numeric_id>。 |
如何使用 X Community Moderators API
提交社区链接,读取它的管理团队。
- 向 /v1/x/community-moderators 发送 {"urls": ["https://x.com/i/communities/1493446837214187523"]}。
- 轮询 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-moderators" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/i/communities/1493446837214187523"]}'
# 管理员和版主以主页资料的形式一起返回,每个社区都是完整的管理团队。X Community Moderators API 最佳使用场景
- 向社区提出赞助或 AMA 合作: 根据版主的名称、简介和网站链接,联系真正决定社区信息流内容的人。
- 投入之前先摸清社区底细: 在发帖、赞助或加入之前,先看管理团队是否认证、published_at 显示的账号有多老、他们自己的粉丝规模有多大。
- 找出同时管理多个社区的人: 采集某个细分领域里各个社区的管理团队,按 id 匹配,找出同时管理不止一个社区的账号。
X Community Moderators API 使用建议
- 需要知道谁管理哪个社区时,每个社区单独建一个任务:资料记录只描述这个人,社区要靠提交的链接来对应。
- 保存或使用 website 之前先展开链接,因为它存的是 X 主页上显示的 t.co 短链接。
- 版主是品牌或项目账号时,留意 text 中的简介是否写了 @账号,背后的真人往往写在那里,例如 "Tweets by @marckohlbrugge"。
相关 API
除了 X Community Moderators API,需要其他类型的 X 公开数据时,可以使用以下 API。
- Twitter Profile Scraper API — 按 username 获取公开账号身份、简介、头像、封面、账号状态和可见受众统计。
- Twitter User Tweets Scraper API — 按 username 采集近期公开帖子、作者、媒体、标签、提及和互动指标,并排除回复。
- X Followers List API — 按一个或多个 X 用户名采集公开关注者账号身份与可见资料指标。
- X Following List API — 采集 X 公开账号关注的个人资料,包括身份、简介、账号状态、可见计数和来源 username。
- X Community API — 通过社区链接读取主题说明、成员数量、规则和加入政策。
- X Community Members API — 把社区成员导出为完整的主页资料,含简介和粉丝数。
- Twitter Tweet 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 Account Location 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