Twitter List Followers
Twitter 列表关注者是为了阅读列表成员的推文而订阅这个 X 列表的账号,每位关注者都有公开主页资料,包括简介、位置、认证状态、注册时间,以及粉丝数、关注数和发帖数。关注一个列表,本身就表明想持续了解这个话题,所以这些资料能看出一个细分领域吸引了哪些人,可以用来比较相关列表的读者,也能找到值得就这个话题去接触的人。
Twitter List Followers API 主要特性
- 任意公开列表的订阅者提交 x.com/i/lists/<id> 链接,返回主动关注每个列表时间线的账号,单个列表最多 2,000 个。
- 每位关注者是谁每行包含用户名、显示名称、text 中的简介、头像、封面图、网站和 location.name,合起来就能看出一个列表吸引的是哪类人。
- 影响力、活跃度、账号年龄与认证metrics.followers_count、following_count、posts_count,加上作为注册时间的 published_at 和 is_verified,可以把成熟活跃的关注者和新号、低活跃账号区分开。
Twitter List Followers API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 一个或多个公开 X 列表链接,格式均为 https://x.com/i/lists/<numeric id>。每个列表的关注者都会采集。 |
results_limit | 可选 | 每个列表采集的关注者数,须为 20 的倍数,范围 20 到 2,000,默认 100。 |
如何使用 Twitter List Followers API
用一个或多个列表链接创建任务,然后分页读取关注每个列表的账号。
- 以 POST 方式向 /v1/x/list-followers 发送 {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100},记下返回的 task_id。
- 定时调用 GET /v1/tasks/{task_id},直到 status 变为 succeeded。
- 从 results.items 收取关注者;只要 has_more 为 true,就在下一次调用中带上 results.next_cursor。
curl -X POST "https://api.socq.ai/v1/x/list-followers" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'
# 每条结果都是关注该列表的账号;列表成员请调用 /v1/x/list-members。Twitter List Followers API 最佳使用场景
- 看看谁在关注你的列表: 采集你整理的公开列表的关注者,了解谁在读它,以及其中按 followers_count 计受众最大的是哪些人。
- 描绘一个话题的受众: 读取“气候科技”或“SaaS 创始人”列表关注者的简介和 location.name,概括对这个话题感兴趣的人群。
- 筛选可以联系的人: 按 text 里的关键词和 followers_count 筛选关注者,挑出已经在关注你所在领域的账号。
- 比较同类列表的读者: 在一个任务里采集两个同主题列表的关注者,按 id 匹配,找出共同读者和各自独有的读者。
- 为相似人群定向准备种子: 从一个挑选得当的列表导出关注者的用户名和 id,作为广告工具里相似人群或兴趣定向的种子名单。
Twitter List Followers API 使用建议
- 用 id 把关注者和 Twitter List Members API 返回的列表成员对上,找出同时关注了列表的成员,以及列表之外的读者。
- 比较多个列表时,给每个列表设同一个 results_limit,让各自的受众按相同深度采集。
- 每次采集都保存关注者 id,之后再导出同一个列表,就能看出这段时间新增了哪些关注者。
相关 API
除了 Twitter List Followers API,需要其他类型的 X 公开数据时,可以使用以下 API。
- Twitter Profile Scraper API — 按 username 获取公开账号身份、简介、头像、封面、账号状态和可见受众统计。
- X Followers List API — 按一个或多个 X 用户名采集公开关注者账号身份与可见资料指标。
- X Following List API — 采集 X 公开账号关注的个人资料,包括身份、简介、账号状态、可见计数和来源 username。
- X Post Retweeters API — 采集转发已知 X 或 Twitter status URL 的公开账号,并在整个任务中按账号去重后返回标准化主页记录。
- X List Tweets API — 按时间从新到旧读取列表时间线,转发帖会标出原作者。
- Twitter List Members API — 把列表成员导出为完整的主页资料,含简介、位置和各项计数。
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X Community Members API
- X Community Moderators 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