如何用 TwexAPI 获取 X 账号粉丝数据
粉丝数据只有在采集方法清楚时才有分析价值。快速查看最近粉丝，可以用 latest followers；需要可复核的数据集，就应该使用分页接口并保存 cursor。
本文使用 elonmusk 作为示例 screen name。实际运行时，请替换成你有合理使用场景的目标账号。
选择合适的端点
| 任务 | 端点 | 什么时候使用 |
|---|---|---|
| 获取最近粉丝 | GET /twitter/latest-followers/{screen_name} | 快速抽样，或观察最近粉丝变化。 |
| 分页获取粉丝 | POST /twitter/followers/page | 需要保存、去重、复核的 cursor 分页导出。 |
| 获取固定数量粉丝 | GET /twitter/followers/{screen_name}/{count} | 已经知道需要多少条的小型一次性任务。 |
如果结果要进入报表、分析或后续处理，优先用分页导出。它比单次大响应更容易留下审计记录。
获取最近粉丝
curl --request GET \
--url https://api.twexapi.io/twitter/latest-followers/elonmusk \
--header 'Authorization: Bearer <token>'这个端点适合快速查看最近粉丝。因为“最近”会随时间变化，建议把采集时间和响应一起保存。
分页获取粉丝
POST /twitter/followers/page 接收 screen_name 和可选的 next_cursor。第一页不传 next_cursor。如果响应里包含下一页 cursor，就把它传入下一次请求。
curl --request POST \
--url https://api.twexapi.io/twitter/followers/page \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"screen_name": "elonmusk"
}'{
"code": 200,
"msg": "success",
"data": [],
"has_next_page": true,
"next_cursor": "1234567890"
}Python 采集器
下面的采集器会拉取有限页数，并把常用粉丝资料字段整理成方便复核的表格行。
1import os
2from typing import Any
3
4import requests
5
6TOKEN = os.environ["TWEXAPI_BEARER_TOKEN"]
7BASE_URL = "https://api.twexapi.io"
8
9def headers() -> dict[str, str]:
10 return {"Authorization": f"Bearer {TOKEN}", "Content-Type": "application/json"}
11
12def get_latest_followers(screen_name: str) -> list[dict[str, Any]]:
13 response = requests.get(
14 f"{BASE_URL}/twitter/latest-followers/{screen_name}",
15 headers=headers(),
16 timeout=30,
17 )
18 response.raise_for_status()
19 return response.json().get("data", [])
20
21def get_followers_page(
22 screen_name: str,
23 *,
24 next_cursor: str | None = None,
25) -> dict[str, Any]:
26 payload: dict[str, Any] = {"screen_name": screen_name}
27 if next_cursor:
28 payload["next_cursor"] = next_cursor
29
30 response = requests.post(
31 f"{BASE_URL}/twitter/followers/page",
32 headers=headers(),
33 json=payload,
34 timeout=30,
35 )
36 response.raise_for_status()
37 return response.json()
38
39def normalize_follower(user: dict[str, Any]) -> dict[str, Any]:
40 return {
41 "user_id": user.get("user_id") or user.get("userId") or user.get("id"),
42 "screen_name": user.get("screen_name") or user.get("username"),
43 "name": user.get("name"),
44 "description": user.get("description") or "",
45 "followers_count": user.get("followers_count") or user.get("followersCount") or 0,
46 "verified": bool(user.get("verified")),
47 "protected": bool(user.get("protected")),
48 "created_at": user.get("created_at_datetime") or user.get("createdAtDatetime") or user.get("createdAt"),
49 }
50
51def collect_followers(screen_name: str, max_pages: int = 3) -> list[dict[str, Any]]:
52 rows: list[dict[str, Any]] = []
53 seen_ids: set[str] = set()
54 cursor = None
55
56 for _ in range(max_pages):
57 page = get_followers_page(screen_name, next_cursor=cursor)
58 for user in page.get("data", []):
59 row = normalize_follower(user)
60 user_id = str(row.get("user_id") or "")
61 if user_id and user_id in seen_ids:
62 continue
63 if user_id:
64 seen_ids.add(user_id)
65 rows.append(row)
66
67 cursor = page.get("next_cursor")
68 if not page.get("has_next_page") or not cursor:
69 break
70
71 return rows
72
73if __name__ == "__main__":
74 followers = collect_followers("elonmusk", max_pages=2)
75 print(len(followers))数据清洁
- 记录每一页的
screen_name、采集时间、端点和 cursor。 - 有稳定用户 ID 时，用它做去重主键。
- 把受保护账号标记、空简介等字段作为数据保留，不要直接当成错误。
- 不要只用粉丝数判断账号质量或意图。
- 如果粉丝导出会用于外联或营销，请先确认同意、隐私和合规要求。
小结
快速检查用 GET /twitter/latest-followers/{screen_name}；需要可复用导出时，用 POST /twitter/followers/page。
更稳的流程是：分页采集、保存 cursor、整理资料字段、按用户 ID 去重，并记录为什么采集这份粉丝列表。