如何通过 API 获取 X 账号粉丝数据

curl --request GET \
  --url https://api.twexapi.io/twitter/latest-followers/elonmusk \
  --header 'Authorization: Bearer <token>'

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"
}

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))