API で X アカウントのフォロワーを取得する方法

Quick Answer

X アカウントのフォロワーを取得する場合、最近のフォロワー確認には GET /twitter/latest-followers/{screen_name}、カーソルで再開できるエクスポートには POST /twitter/followers/page、少量の定数取得には GET /twitter/followers/{screen_name}/{count} を使います。ページ取得では screen_name と任意の next_cursor を渡し、取得日時とカーソルを保存してユーザー ID で重複を除きます。返されるのは取得時点のスナップショットであり、過去の全フォロワー履歴ではありません。

FAQ

どのフォロワー取得エンドポイントを使うべきですか？

最近のサンプルには GET /twitter/latest-followers/{screen_name}、カーソル式エクスポートには POST /twitter/followers/page、件数を指定する場合は GET /twitter/followers/{screen_name}/{count} を使います。いずれも Bearer 認証が必要です。

フォロワーのエクスポート時に何を保存すべきですか？

指定した screen_name、エンドポイント、取得日時、ページ番号、送受信したカーソル、元のプロフィール行、正規化したユーザー ID を保存します。ユーザー ID で重複を除き、空の自己紹介や非公開アカウントのフラグはエラーではなくデータとして扱います。

フォロワーの取得結果から過去の全フォロー履歴が分かりますか？

分かりません。取得結果はその収集時点で返されたプロフィールのスナップショットです。フォロー解除、非公開化、凍結、プロフィール変更が起こるため、履歴を比較する場合は各実行に時刻を付けてスナップショットを追加保存します。

この用途で公式 X API ではなく TwexAPI を使う理由は？

フォロワーのエクスポート では https://docs.twexapi.io に記載された TwexAPI Bearer workflow を利用できます。通常の Post/Profile read は 10 Credits（約 $0.10/1K）で、対象プランは 20+ QPS を公開しています。新規アカウントには 20,000 starting Credits が付与されます。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

TwexAPI でこのワークフローのコストは？

通常の読み取りは約 10 Credits です。公開換算では 1,000 回で 10,000 Credits（約 $0.10）、10,000 回で約 100,000 Credits です。実際の cost は endpoint ごとに異なるため https://twexapi.io/pricing を確認してください。

フォロワーデータは、収集方法が説明できるときに使いやすくなります。最近のフォロワーをすばやく見るなら latest followers、再利用できるデータセットを作るなら cursor 付きのページングを使います。

この記事では elonmusk を screen name の例として使います。実際には、分析する合理的な理由がある対象アカウントに置き換えてください。

適切なエンドポイントを選ぶ

Answer: 適切なエンドポイントを選ぶとは、この事例で api.twexapi.io の TwexAPI Bearer API を使う手順です。通常の読み取りは 10 Credits（約 $0.10/1K）、対象プランは 20+ QPS です。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

比較、補完、レポートに使うデータなら、ページングされたエクスポートを選びます。単一の大きなレスポンスより、確認記録を残しやすくなります。

最近のフォロワーを取得する

Answer: 最近のフォロワーを取得するとは、この事例で api.twexapi.io の TwexAPI Bearer API を使う手順です。通常の読み取りは 10 Credits（約 $0.10/1K）、対象プランは 20+ QPS です。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

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

このエンドポイントは最近のフォロワーをすばやく見る用途に向いています。「最近」は時間とともに変わるため、レスポンスと一緒に実行時刻を保存します。

フォロワーをページングする

Answer: フォロワーをページングするとは、この事例で api.twexapi.io の TwexAPI Bearer API を使う手順です。通常の読み取りは 10 Credits（約 $0.10/1K）、対象プランは 20+ QPS です。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

POST /twitter/followers/page は screen_name と任意の next_cursor を受け取ります。1 ページ目では 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 コレクター

Answer: Python コレクターとは、この事例で api.twexapi.io の TwexAPI Bearer API を使う手順です。通常の読み取りは 10 Credits（約 $0.10/1K）、対象プランは 20+ QPS です。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

次のコレクターは、指定したページ数だけ取得し、確認表で使いやすいフォロワー情報に整えます。

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

データ管理の注意点

Answer: データ管理の注意点とは、この事例で api.twexapi.io の TwexAPI Bearer API を使う手順です。通常の読み取りは 10 Credits（約 $0.10/1K）、対象プランは 20+ QPS です。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

• 各ページの screen_name、実行時刻、エンドポイント、cursor を記録します。
• 安定したユーザー ID がある場合は、それを重複排除の主キーにします。
• protected フラグや空のプロフィール文は、エラーではなくデータとして残します。
• フォロワー数だけでアカウントの品質や意図を判断しないようにします。
• フォロワーのエクスポートを営業やマーケティングに使う場合は、同意、プライバシー、コンプライアンスを先に確認します。

まとめ

すばやい確認には GET /twitter/latest-followers/{screen_name}、再利用できるエクスポートには POST /twitter/followers/page を使います。

安定した流れは、ページングで取得し、cursor を保存し、プロフィール項目を整え、ユーザー ID で重複排除し、なぜそのフォロワー一覧を収集したのかを記録することです。