X のユーザーの全ツイートをダウンロードする

#どの方法を使うべきか

方法は、2つの事実で決まります。誰のツイートが必要か、そして何件必要かです。自分のアカウントの全履歴は、X のアーカイブから無料で入手できます。他人の投稿は、公開タイムラインをたどるエクスポートで取得することになり、どこまで遡れるかは裏にあるエンドポイントによって変わります。

アカウントの最新の投稿なら、無料のツイートエクスポートツールが、20件ずつ CSV、Excel、JSON で保存します。表示回数、いいね、ブックマーク、X のラベルなど25列を含み、サインアップも拡張機能も不要です。下にハンドルを入力して試してみてください。

アカウントがこれまでに書いたすべての投稿を取得するのは、より大きな作業です。ある方法がそれをこなせるかどうかは、5つの数字で決まります。

• どこまで遡れるか。 X 自身のユーザータイムラインエンドポイントが返すのは、最新の3,200投稿だけです。
• 1,000投稿あたりの料金。 公式 X API は1投稿$0.005で課金するため、1,000投稿は$5.00です。
• 利用者に何が必要か。 公式 X API では、開発者アカウント、アプリ、前払いクレジットが必要です。
• 処理の速さ。 長い履歴には数百から数千のリクエストが必要なので、毎秒のリクエスト数が重要です。
• 何を危険にさらすか。 ログイン中の X セッションを通じて読み取るツールは、そのアカウントが自動化された操作として警告される恐れがあります。予備のアカウントからのエクスポートを勧めるツールがあるのは、このためです。

#Sorsa API で全投稿をダウンロードする

公開アカウントの全履歴には、Twitter（X）API 兼スクレイピングツールである Sorsa API を使ってください。POST /user-tweets はタイムライン全体を、3,200件の上限なしで、1リクエスト20投稿ずつ取得します。料金は1,000投稿あたり$0.07からで、公式 X API の$5.00に対する価格です。

残りの3つの数字も満たします。Sorsa API に必要なのは開発者アカウントではなく API キー1つで、無料アカウントを含む全プランで毎秒20リクエストに対応し、X のログイン情報や Cookie も求めません。そのため、ダウンロードに自分の X アカウントが関わることはありません。

Sorsa API を使う4つの方法は、同じキーと同じ100回分の無料リクエストで動きます。無料ツールはキーすら不要で、X のアーカイブはサインインしているアカウントしか対象になりません。

• API プレイグラウンドでの Sorsa API

  用途

  コードなしで、アカウントの全投稿

  得られるもの

  CSV、Excel、JSON 形式の20投稿ずつのページ

  費用

  最初の2,000投稿は無料、その後は1,000件あたり$0.07から

• Sorsa API、POST /user-tweets

  用途

  コードやスケジュール実行で、全投稿

  得られるもの

  タイムライン全体、1リクエスト20投稿

  費用

  最初の2,000投稿は無料、その後は1,000件あたり$0.07から

• Sorsa API、POST /search-tweets

  用途

  アカウントの特定の期間

  得られるもの

  2006年まで遡って、2つの日付の間の投稿

  費用

  1,000件あたり$0.07から

• Sorsa API、POST /tweet-info-bulk

  用途

  すでにリンクを持っている投稿

  得られるもの

  1リクエストで最大100投稿

  費用

  1,000件あたり$0.014から

• ツイートエクスポートツール

  用途

  最新の20投稿を1回だけ

  得られるもの

  20投稿の1ファイル

  費用

  無料

• 自分のデータの X アーカイブ

  用途

  自分のアカウントのすべて

  得られるもの

  HTML と JSON の .zip（DM を含む）

  費用

  無料。X によれば数日かかることがある

#コードを書かずに全ツイートをダウンロードする

API プレイグラウンドは、フォームから Sorsa API のリクエストを送ります。User Tweets を選び、ハンドルを入力して実行し、投稿を CSV、Excel、JSON でエクスポートします。スクリプトを書くまでもない、1回限りのダウンロードに向いています。

1. 無料アカウントを作成する。 サインアップして、ダッシュボードから API キーをコピーします。最初の100リクエストは無料で、カードは不要です。

2. プレイグラウンドを開く。 API プレイグラウンドに移動し、上部にキーを貼り付けます。

3. User Tweets を選ぶ。 アカウントのハンドルを、@ を付けずに入力します。

4. ページ数を設定する。 1ページは20投稿の1リクエストなので、100ページで2,000投稿が返ります。実行前に、プレイグラウンドが費用を表示します。

5. 実行してエクスポートする。 結果を CSV、Excel、JSON に切り替えて、ファイルを保存します。

何年分もの履歴があるアカウントは、日付で作業を分けてください。同じプレイグラウンドで、from: と期間を指定したツイート検索を、1回の実行につき1年分ずつ実行します。やり方は、後述の3,200件の上限のセクションで説明します。

#API で全ツイートをダウンロードする手順

コードでは、ダウンロード全体が Sorsa API の POST /user-tweets を囲む1つのループです。ApiKey ヘッダーにキーを1つ入れ、1リクエストで20投稿を取得し、カーソルでアカウントの最初の投稿まで遡ります。カーソルとは、API が各ページと一緒に返すしおりのことで、次のリクエストで送ると、そのページの次が返ります。

1. キーを取得する。 サインアップして、ダッシュボードからキーをコピーします。開発者アカウントの開設も、OAuth も、審査も不要です。

2. 作業の規模を確認する。 GET /info（新しいタブで開きます） は tweets_count を含むプロフィールを返します。これを20で割ると、必要なリクエスト数になります。

   curl -G "https://api.sorsa.io/v3/info" \
     -H "ApiKey: YOUR_API_KEY" \
     --data-urlencode "username=northfield_climatelab"
   

3. 最初のページをリクエストする。 ハンドルを JSON として POST /user-tweets（新しいタブで開きます） に送ります。ハンドルの代わりに、ユーザー ID やプロフィールリンクも使えます。

   curl -X POST "https://api.sorsa.io/v3/user-tweets" \
     -H "ApiKey: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"username": "northfield_climatelab"}'
   

   {
     "tweets": [
       {
         "id": "2116531887928250368",
         "full_text": "October was our warmest month on record. #climatedata",
         "created_at": "2026-10-31T14:05:00Z",
         "lang": "en",
         "likes_count": 812,
         "retweet_count": 240,
         "reply_count": 61,
         "quote_count": 38,
         "view_count": 96400,
         "bookmark_count": 410,
         "is_reply": false,
         "is_quote_status": false,
         "entities": [
           {
             "type": "photo",
             "link": "https://pbs.twimg.com/media/Gx1nQ7aW8AAzk3T.jpg"
           }
         ],
         "user": {
           "username": "northfield_climatelab",
           "display_name": "Northfield Climate Lab",
           "followers_count": 48900,
           "tweets_count": 12400
         }
       }
     ],
     "next_cursor": "DAABCgABG8vZ0Qm__-oKAAIbuv3MBVvA0AgAAwAAAAIAAA"
   }
   

   レスポンス全体を表示

4. カーソルをたどる。 返ってきた next_cursor を、次のリクエストのボディに入れます。カーソルのないレスポンスが最後のページで、タイムラインの取得が完了したことを示します。

5. 届いた行を順に書き込む。 次のスクリプトは、各ページを CSV に追記し、メディアのリンクを専用の列に入れ、ページごとにカーソルを保存します。そのため、止まった実行も続きから再開できます。

   import csv
   import os
   import time
   
   import requests
   
   API = "https://api.sorsa.io/v3/user-tweets"
   HEADERS = {"ApiKey": "YOUR_API_KEY"}
   FIELDS = ["id", "created_at", "full_text", "lang", "likes_count",
             "retweet_count", "reply_count", "quote_count", "view_count",
             "bookmark_count", "is_reply", "in_reply_to_username", "media"]
   
   
   def download(username, out="tweets.csv"):
       state = out + ".cursor"
       cursor = open(state).read().strip() if os.path.exists(state) else None
       first_run = not os.path.exists(out)
       with open(out, "a", newline="", encoding="utf-8") as f:
           rows = csv.DictWriter(f, FIELDS, extrasaction="ignore")
           if first_run:
               rows.writeheader()
           while True:
               body = {"username": username}
               if cursor:
                   body["next_cursor"] = cursor
               r = requests.post(API, headers=HEADERS, json=body, timeout=60)
               if r.status_code == 429:  # over 20 requests in a second
                   time.sleep(1)
                   continue
               r.raise_for_status()  # 403: key missing, wrong or used up
               page = r.json()
               for t in page.get("tweets") or []:
                   media = [e["link"] for e in t.get("entities") or []
                            if e.get("type") in ("photo", "video")]
                   rows.writerow({**t, "media": " ".join(media)})
               f.flush()
               cursor = page.get("next_cursor")
               if not cursor:
                   break
               with open(state, "w") as s:
                   s.write(cursor)
       if os.path.exists(state):
           os.remove(state)
   
   
   download("northfield_climatelab")
   

   import fs from "node:fs";
   
   const API = "https://api.sorsa.io/v3/user-tweets";
   const headers = {
     ApiKey: "YOUR_API_KEY",
     "Content-Type": "application/json",
   };
   const out = "tweets.jsonl";
   const state = out + ".cursor";
   const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
   
   let cursor = fs.existsSync(state) ? fs.readFileSync(state, "utf8") : null;
   while (true) {
     const body = { username: "northfield_climatelab" };
     if (cursor) body.next_cursor = cursor;
     const res = await fetch(API, {
       method: "POST",
       headers,
       body: JSON.stringify(body),
     });
     if (res.status === 429) { // over 20 requests in a second
       await sleep(1000);
       continue;
     }
     if (!res.ok) throw new Error(`HTTP ${res.status}`);
     const page = await res.json();
     for (const t of page.tweets ?? []) {
       fs.appendFileSync(out, JSON.stringify(t) + "\n");
     }
     cursor = page.next_cursor;
     if (!cursor) break;
     fs.writeFileSync(state, cursor);
   }
   fs.rmSync(state, { force: true });
   

リプライとリポスト

既定では、POST /user-tweets はアカウント自身の投稿を返します。リプライも含めるには、ボディに "with_replies": true を追加します。リプライだけ、あるいはリポストだけをダウンロードするには、"type" を "replies" または "retweets" に設定します。リポストには、元の投稿が retweeted_status の下に完全な形で含まれます。

403 はキーがない、間違っている、またはリクエスト残量がないことを、429 は1秒に20リクエストを超えたことを示すので、スクリプトは1秒待って再試行します。失敗したリクエストは課金されません。リトライとページネーションについては、ほかのすべてのエンドポイントも含めて、Python での Twitter API のガイドで解説しています。

#ユーザーのツイートを3,200件より多く取得する方法

上限のないエンドポイントを使います。3,200件の制限は公式 X API のユーザータイムラインのもので、アカウントの最新の3,200投稿しか返しません。一方、Sorsa API の POST /user-tweets は、最初の投稿まで遡ってページを取得し続けます。

この数字は、X 自身のタイムラインのドキュメント（新しいタブで開きます）に書かれています（"Up to 3,200 most recent Posts"、つまり最新の最大3,200投稿）。同じドキュメントには、従量課金の利用者向けに、2006年3月まで遡る全期間検索（新しいタブで開きます）も載っていますが、開発者アカウントとアプリが必要で、1投稿$0.005です。つまり、この上限は X のデータではなく1つのエンドポイントの性質であり、3,200件をすべてのツールに共通の壁だと書くガイドは、そのエンドポイントのことを述べているにすぎません。

Sorsa API は、最新ページと同じレートで全履歴を提供します。1万2,400投稿のアカウントなら620リクエストで、$0.87からです。公式 X API の全期間検索で同じ投稿を取得すると$62.00かかり、月300万件の投稿読み取りで止まります。

期間を指定してダウンロードする

履歴の一部だけをダウンロードするには、日付でアカウントを検索します。from:、since:、until: を付けた POST /search-tweets（新しいタブで開きます） は、2006年まで遡って、2つの日付の間のそのアカウントの投稿を、同じカーソルで1リクエスト20件ずつ返します。

{
  "query": "from:northfield_climatelab since:2019-01-01 until:2020-01-01",
  "order": "latest"
}

1年ごとに期間を分けると、1回の実行が短くなり、再試行もしやすくなります。写真や動画のある投稿だけに絞るには filter:media を、リプライを除外するには -filter:replies を追加します。そのほかの演算子は、Twitter 検索演算子のガイドに一覧があります。2006年までのすべてのアカウントの、あるテーマの投稿を検索するのは別の作業で、Twitter の過去データで解説しています。

#全ダウンロードの費用

全ダウンロードの費用は、20投稿につき1リクエストです。1万2,400投稿のアカウントは620リクエストで、Sorsa API なら$0.87から、公式 X API は同じ投稿に1件$0.005で$62.00を課金します。

どの規模でも、Sorsa API は1,000投稿あたり$0.07から、公式 X API は$5.00です。100回分の無料リクエストで、2,000投稿までのアカウントなら取得できます。

• 3,200

  リクエスト数

  160

  Sorsa API（から）

  $0.22

  公式 X API

  $16.00

• 1万2,400

  リクエスト数

  620

  Sorsa API（から）

  $0.87

  公式 X API

  $62.00

• 5万

  リクエスト数

  2,500

  Sorsa API（から）

  $3.50

  公式 X API

  $250.00

• 20万

  リクエスト数

  1万

  Sorsa API（から）

  $14.00

  公式 X API

  $1,000.00

任意のプロフィールにある投稿数を入力すると、自分のダウンロードの費用を試算できます。

課金は投稿ごとではなく、リクエストごとです。20件のページも、3件しかない最後のページも同じ料金で、失敗したリクエストには費用がかかりません。Starter プランの月間10,000リクエストで20万投稿を取得でき、各プランの1,000リクエストあたりの料金は料金ページに載っています。

1つのアカウントのページは、1つずつ順番に処理されます。各リクエストが直前のリクエストのカーソルを必要とするからです。複数のアカウントは並行してダウンロードでき、無料アカウントを含む全プランでキーあたり毎秒20リクエストまでです。

#ファイルの各行に入る内容

投稿は1件ずつ、テキスト、日時、カウント、メディア、投稿者を含む1つの JSON オブジェクトとして返るため、CSV の1行を作るのに2回目のリクエストは要りません。次のフィールドは、上のスクリプトが書き出すもので、公開 API リファレンスに基づいています。

• id

  内容

  投稿の ID（文字列）。スプレッドシートで丸められないよう、テキストのまま保持する

  例

  "2116531887928250368"

• created_at

  内容

  投稿日時（UTC の ISO 8601）

  例

  "2026-10-31T14:05:00Z"

• full_text

  内容

  長い投稿を含む全文

  例

  "October was our warmest..."

• likes_count、retweet_count、reply_count、quote_count

  内容

  エンゲージメント数

  例

  812

• view_count、bookmark_count

  内容

  表示回数とブックマーク数

  例

  96400

• is_reply、in_reply_to_username

  内容

  誰かへの返信かどうかと、その相手

  例

  false

• quoted_status、retweeted_status

  内容

  引用またはリポストされた投稿の全体

  例

  オブジェクト

• entities

  内容

  写真、動画、リンク（それぞれ type と link を持つ）

  例

  "photo"

• made_with_ai、paid_partnership

  内容

  投稿に付く X のラベル

  例

  false

• user

  内容

  投稿者の完全なプロフィール

  例

  オブジェクト

CSV は、Excel や Google スプレッドシートでそのまま開けます。Node.js タブの JSON Lines ファイルは、ノートブックや AI のデータセットに向いています。スケジュールで自動的にシートを更新したい場合は、Twitter データを Google スプレッドシートにエクスポートをご覧ください。

知っておきたいこと

ダウンロードできるのは公開投稿だけです。非公開アカウントの投稿、削除された投稿、投稿にいいねした人の一覧、アカウントがいいねやブックマークした投稿は X では非公開のため、どの API でも取得できません。ダウンロードの後に削除された投稿は、手元のファイルに残ります。

#X アカウントのメディアをすべてダウンロードする方法

POST /user-tweets でアカウントの投稿を読み、type が photo または video のエンティティをすべて保存します。各エンティティにはファイルへの直接の link が付いているので、テキストを保存するループでメディアも保存できます。

import os

import requests


def save_media(tweets, folder="media"):
    os.makedirs(folder, exist_ok=True)
    for t in tweets:
        for e in t.get("entities") or []:
            if e.get("type") not in ("photo", "video"):
                continue
            name = t["id"] + "-" + e["link"].split("/")[-1].split("?")[0]
            data = requests.get(e["link"], timeout=60).content
            with open(os.path.join(folder, name), "wb") as f:
                f.write(data)

ダウンロードのループの中で、各ページの tweets を渡して呼び出します。開始前に GET /info でアカウントの media_count がわかるので、何個のファイルが来るかを把握できます。

各エンティティには preview（サムネイル）も付いており、投稿された内容を確認するだけなら、動画全体の代わりにこれを保存できます。スニペットのように、各ファイルに投稿の ID を付けておくと、各行の media 列に同じリンクが載っているので、後でメディアフォルダを CSV と結び付けられます。1件の投稿のメディアなら、投稿のリンクを無料のメディアダウンローダーに貼り付けてください。より大規模なメディアの処理は、API で Twitter のメディアをダウンロードのガイドで解説しています。

#ツイートをリンクで保存する

最大100件の投稿リンクまたは ID を POST /tweet-info-bulk（新しいタブで開きます） に送ると、すべての投稿が1リクエストで返ります。料金は1,000投稿あたり$0.014からで、公式 X API の$5.00の250分の1です。

curl -X POST "https://api.sorsa.io/v3/tweet-info-bulk" \
  -H "ApiKey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tweet_links": [
        "https://x.com/northfield_climatelab/status/2116531887928250368",
        "2115035779691450372"]}'

手作業で集めた投稿、レポートの出典、残しておきたいスレッドに使えます。リンクは x.com または twitter.com の完全なアドレスでも、ID だけでも構わず、1つのリストに混在させられます。1,000投稿の保存は10リクエストです。各投稿は、投稿者を含め、タイムラインのページと同じフィールドで届きます。

大事な投稿は、見つけた日に保存してください。削除された、または非公開になった投稿のリンクは単に返ってこず、バッチの残りは通常どおり届きます。また、X で削除された投稿は、その後は誰も取得できません。

#自分のツイートをすべてダウンロードする方法

自分のアカウントなら、X のアーカイブをリクエストしてください。無料で、最初の投稿以降のすべての投稿に加え、DM、メディア、フォロワー、リストが、HTML と JSON のファイルとして .zip に入っています。X ヘルプセンター（新しいタブで開きます）には、次の手順が載っています。

1. 自分の X データを開く。 「設定とプライバシー」、「アカウント」、「X のデータ」の順に開きます。

2. 本人確認をする。 X がメールまたは電話に送るコードを入力します。

3. データをリクエストする。 「データをダウンロード」の下で、X の横にある「データをリクエスト」を押します。

4. .zip をダウンロードする。 ファイルの準備ができると、X がリンクをメールで送るか、プッシュ通知を送ります。ヘルプページによれば、数日かかることがあります。

アーカイブは、「これまで投稿したすべて」に応えるものです。今すぐ公開投稿をスプレッドシートで、表示回数やブックマーク数を列に入れて取得したい場合は、自分のハンドルに対して上の API の手順を実行してください。1リクエスト20投稿は同じで、メールを待つ必要はありません。

#今日、最初のアカウントをダウンロードする

公開アカウントのすべての投稿は、ハンドル1つとループ1つで取得できます。Sorsa API は、3,200件の上限なしで1リクエスト20投稿を返し、1,000件あたり$0.07からです。公式 X API は$5.00で、最初の2,000投稿は無料です。まず今必要なアカウントから始め、毎秒20リクエストで次のアカウントを並行して追加してください。そのほかの種類のダウンロードも、X からツイート、フォロワー、プロフィールを取得する方法のガイドで同じように扱っています。

#よくある質問