本記事では自動化ツールやAIツールを企画開発するGASラボの「Twitter(X)リストメンバーエクスポートツール」の概要・使い方、入手方法、よくある質問に関するQ&Aについて詳しく解説しております。
【はじめに】Twitter(X)リストメンバーエクスポートツールの概要
本ツールは、Twitter(X)の特定のリストのメンバー（ユーザー）を自動でエクスポートできるツールです。
- Twitter(X)のリストに追加されている全メンバーの情報を自動エクスポート
- アカウント名、アカウントID、フォロー数、フォロワー数、最新投稿URL、固定投稿URLなども取得・出力
- 情報は分析や加工のしやすいGoogleスプレッドシートに出力
Twitter(X)のリストのメンバー（ユーザー）一覧は、標準機能ではエクスポートできません。
そのため、手動で行うかプログラミングスキルによってTwitter APIを利用するしかなく、プログラミングスキルがない方にとっては難しい作業です。
しかし本ツールを使えば、専門的な知識を持たない方でも、簡単にTwitter(X)のリストのメンバー一覧を自動出力することができます。
本ツールは、メンバー一覧情報を取得したいリストのURLを指定するだけで、リスト内の全メンバーの各種情報（アカウント名、アカウントID、フォロー数、フォロワー数、最新投稿URL、固定投稿URLなど）をエクスポートできます。
情報の出力先はGoogleスプレッドシートなので、出力後の分析や加工もスムーズです。
操作も簡単で、画像付きマニュアルもあるため、プログラミングスキルのない方でも問題なくご利用いただけます。
なお、本ツールは買い切り型で、月々の費用などは発生しません。
Googleスプレッドシートが利用できるパソコンがあれば、WindowsでもMacでもご利用可能です。
Twitter(X)のリストメンバー一覧を出力して分析したい方、非公開リストを共有するために出力したい方などにおすすめのツールです。
Twitter(X)リストメンバーエクスポートツールの3つの特徴
任意のTwitter(X)リストのメンバーを自動エクスポート
- 任意のTwitter(X)リストをURLで指定して、Twitter API経由でリスト内のメンバー（ユーザー）一覧を自動エクスポートできるツールです。
- 公開されているリストはもちろん、ご自身のアカウントであれば非公開リストのメンバーのエクスポートにも対応しています。
- リストメンバーの一覧と同時に、各アカウントのフォロー数、フォロワー数、合計投稿数などの分析に利用できる数値データや、最新ツイートや固定ツイートのURLも取得することができます。
データのエクスポート先は分析や加工に便利なスプレッドシート
- 本ツールで取得したリストメンバーデータのエクスポート先はGoogleスプレッドシートです。
- そのため、関数を用いた分析や、並び替え（ソート）、 加工、ExcelやCSVなどへの出力も容易に実行できます。
画像付き設定マニュアルがあるので、初心者でも安心！
- 本ツールはリスト情報やTwitter(X)アカウントの取得操作にTwitterAPI（Basicプラン以上の有料プラン）を利用しております。
- 初心者の方でも簡単にAPIの設定や本ツールの利用のための設定ができるよう、画像付きの丁寧なマニュアルを用意しておりますので、ご安心ください。
Twitter(X)リストメンバーエクスポートツールはこんな方におすすめ
- Twitter(X)の特定のリストメンバーの一覧を出力したい方
- リストメンバーの整理をしたい方
- 非公開リストを他のアカウントや他の人と共有したい方
Twitter(X)リストメンバーエクスポートツールのご利用マニュアル
STEP１：ご購入された本ツール（Googleスプレッドシート形式）をコピー
本ツールは自動化スクリプト「Google Apps Script（GAS）」が実装された「Googleスプレッドシート形式」のツールです。
安全のためご購入当初のツール（スプレッドシート）は「閲覧権限」となっております。
本ツールに実装された「自動化メニュー」をご利用いただくためには、本ツール（スプレッドシート）のコピーを生成する必要がございます。
スプレッドシートのツールバーの「ファイル」→「コピーを作成」をクリックすると、自動化メニューが有効になったコピーツールを生成することができます。
コピーシートにはプログラムも一緒にコピーされますので、コードを編集する必要性は全くありませんので、ご安心ください。
STEP2：Twitter APIの情報を取得し、「設定」シートに貼り付け
本ツールではTwitter APIを利用してリスト情報やユーザー情報の自動取得を実現します。
そのため、Twitter API利用のための情報（API KeyおよびAPI Key Secret）が必要となります。
※参考：Twitter APIの利用に必要な情報の取得方法については下記の記事で詳しく解説しております。ご参照の上、API KeyおよびAPI Key Secretを取得してください。
取得したAPI KeyおよびAPI Key Secretを、本ツールの「設定シート」の「API Key」および「API Key Secret」の欄に貼り付けます。
STEP3：メニューから「アカウント認証」を実行し、認証手続きを進める
次にTwitter APIの利用に必要な「アカウント認証」の手続きを進めます。
ツールバーに用意されている本ツール独自の「メニュー」より「アカウント認証」をクリックします。
初めて本ツール独自の自動化メニューを実行する際には、初回認証プロセスが必要となります。初回認証プロセスの進め方は下記の記事に記載しておりますので、そちらをご参照ください。
その後、アカウント認証用のウインドウが表示されますので、「アカウント認証ページ」のテキストリンクをクリックします。
Twitter(X)の認証画面が表示されますので、「連携アプリを認証」をクリックします。
「認証が許可されました」という表示が出ればTwitterの認証手続きは完了です。
これでTwitterAPIを利用する準備が整いました。
「アカウント認証」でよくあるエラーと解決方法
アカウント認証時に発生するよくあるエラーは下記のようなエラーです。
- 「問題が発生しました アプリにアクセスを許可できません。」
- 「アプリにアクセスを許可できません。」
- 「Could not authenticate you.」
上記のような原因および解決方法は下記の記事に記載しておりますので、ご一読ください。
※補足：「アカウント認証をクリア」機能もご用意しております。
利用するアカウントを変更するシーンなど、アカウント認証をクリアしたいときにご利用できる「アカウント認証をクリア」メニューもご用意しております。必要に応じてご利用ください。
STEP4：設定シートにて、対象のリストURLを指定
次に、メンバーの一覧データを抽出したいTwitter(X)の「リスト」をURLで指定します。
まずは、PCなどから抽出対象の「リストのURL」をコピーして取得します。
その後、本ツールの設定シートの「リストURL」にコピーしたURLを貼り付けます。
※対応するツイートURLについて
本ツールでは、短縮URLには対応しておりません。
下記のURL形式に対応しておりますので、予めご了承下さい。
https://twitter.com/i/lists/{リストID}
STEP5：メニューより「ユーザー一覧取得開始」をクリック
最後に指定したリストのユーザーの一覧を自動で取得・出力します。
本ツール独自の「メニュー」より「ユーザー一覧取得開始」をクリックします。
「ユーザー一覧取得開始」メニューを実行すると、URLで指定したリストのメンバー情報が15分ごとに自動で最大400件ずつ取得され、「リストメンバー」シートへ出力されます。自動で取得・出力されていきますので、本自動化メニューを実行後はツールの画面やPCを閉じていただいて構いません。
指定したリストのユーザーを全件取得した場合や、何かしらエラーが発生した場合に、15分ごとの処理が終了します。ツールによるデータ取得ステータスは「設定」シートの「リストアップ状況」にてご確認いただけます。
本STEPが正しく実行されない場合やエラーが発生する場合は、STEP5までの設定に何らか問題がある可能性が高いため、STEP1からSTEP4までを改めて確認してみてください。
仕様補足
- 本ツールは15分間に5回のリクエスト（リクエスト1回あたり100件の取得：最大：500件）までしか取得できない制限がございます。この最大制限を超えてしまうとエラーが発生しますので、ご注意ください。
- 一度取得したことのあるリストURLとユーザーの情報は更新されません。最新情報が必要な場合は、過去のデータを削除して下さい。
- APIの利用状況の目安をご確認いただけるようにするため、本ツールの「API利用履歴」シートに本ツールでデータ取得した目安件数が自動で記録されていきます。
- 下記のユーザーは取得不可となります。
- 取得しようとしたユーザーアカウントが何かしらの理由で凍結している
- 取得しようとしたユーザーアカウントが何かしらの理由で削除されている
- ブロックなど取得しようとしたユーザーアカウントへのアクセス権限がない
「ユーザー一覧取得開始」メニュー実行時にエラーが発生した場合は？
エラーが発生した場合には、「エラー履歴」シートに情報が出力されますので、内容をご確認いただき、修正のアクションをしてください。
・エラー履歴シートへの出力例
「ユーザー一覧取得開始」に発生するよくあるエラーは下記のようなエラーです。
- 「Too Many Requests」
- 「Error starting OAuth flow」
- 「Could not authenticate you.」
原因および解決方法は下記の記事に記載しておりますので、ご一読ください。
【参考】「ユーザー一覧取得中止」メニューもご用意
リストメンバーの一覧取得開始後、途中で処理を中止・中断したい場合には、メニューより「ユーザー一覧取得中止」を実行してください。
本メニューを実行すると、15分ごとに400件ずつ取得する処理を強制的に中断することができます。
本メニューやエラーで中断された場合は、途中から再開することができませんので、ご注意ください。
【参考】リストメンバーシートをクリアする機能も搭載
本ツールのリストメンバーシートをクリアしたい場合は、「リストメンバーシートクリア」メニューを実行してください。
Twitter(X)リストメンバーエクスポートツールで取得・出力できる項目
本ツールでエクスポートしたリストメンバーの各ユーザーについて下記の項目を取得・出力することが可能です。
分析などに便利なデータが揃っておりますので、是非ご活用ください。
- 対象リストURL
- userId
- アカウント表示名
- ユーザー名
- プロフィール画像URL
- プロフィール画像
- TwitterアカウントURL
- アカウント説明文
- 鍵付きアカウント
- アカウント開設日
- 地域情報
- 固定ツイートID
- 固定ツイートURL
- 最新ツイートID
- 最新ツイートURL
- フォロー数
- フォロワー数
- 合計ツイート数
- 情報取得日時
Twitter(X)リストメンバーエクスポートツール：ご利用上の注意点
- 本ツールの利用には、Googleアカウント、Twitter(X)アカウント、Twitter APIの利用権限が必要になります。
- 本ツールはTwitterAPIを使用して情報を取得しております。場合によっては、一時的に情報が取得できない場合や、情報の取得・操作が失敗するケースもございます。予めご了承ください。
- 本ツールはTwitter APIの有料プラン（Basicプラン）ご利用者向けのツールです。Freeプランのご利用者様はご利用いただけませんので、予めご了承ください。
- Twitter APIの有料プラン（Basicプラン）には、時間あたりに取得できるデータの上限数があります。場合によっては、上限に至り、データの取得に失敗するケースもございます。予めご了承ください。
- 本ツールの利用で発生した問題の責任は負いかねます。事前に使い方をテスト、理解した上で、ご利用ください。
- ツールおよびプログラムの著作はGASラボにあります。無断での転載・再販・配布・共有やソースコードのコピーは固く禁止しております。
- 本ツールは処理時間に上限があります（約6分）。あらかじめご了承ください。
- 本ツールは初回利用時に「認証・許可プロセス」が発生します。認証・許可を下記の記事を参考に進めて下さい。
- 本ツールはTwitterAPIの仕様変更に伴い、ツール自体の仕様が変更になる可能性やアップデートされる可能性、データの取得やAPIを使った操作ができなくなる可能性がございます。予めご了承ください。
Twitter(X)リストメンバーエクスポートツールに関するQ&A
Twitter(X)リストメンバーエクスポートツールはどこで入手できますか？
本ツールでデータを取得すると、TweetCapは消費しますか？
Twitter(X)リストメンバーエクスポートツールの使い方に関する問い合わせ方法は？
ツールを利用中エラーが発生しました。エラーの解消方法はどこに記載されていますか？
本ツールで発生するエラーのほとんどのケースがTwitter APIに関連するエラーと予想されます。
下記の記事のQ&Aセクションでは、発生したエラー別の解消方法を詳しく記載しておりますので、まずはこちらをご参照ください。
本記事では、Twitter API有料化公式アナウンス後である2023年10月最新のTwitter APIの利用に必要な「API Key」＆「API Key Secret」（OAuth1.0a利用の場合）の取得・確認方法、および「Clien[…]
GASラボのTwitter(X)自動化ツールのご紹介
GASラボでは主にGoogle Apps Scriptにて開発した自動化ツールを企画・開発しております。これまで開発したツールは2023年11月現在、100種類以上を超え、今後も随時新規で開発、公開していく予定です。
Twitter(X)の自動化をするツールも複数開発しておりますので、主なツールを紹介します。
その他のTwitter(X)関連の自動化ツール
GASラボではその他Twitter(X)を自動化できるツールを複数ご用意しております。是非ご覧ください。
本記事では業務自動化ツールを企画開発するGASラボの「Twitterツリー形式ツイート予約投稿ツール（自動RT機能付き）」の概要・使い方、よくある質問に関するQ&Aについて詳しく解説しております。Twitterツリー形式ツイート[…]
本記事では自動化ツールやAIツールを企画開発するGASラボの「ツイート一括取得・保存ツール」の概要・使い方について詳しく解説しております。GASラボの「ツイート一括取得・保存ツール」をご存知ではない方向けに、ツールを入手する方法や、[…]
本記事では業務自動化ツールを企画開発するGASラボの「Twitterブックマーク自動エクスポートツール」の概要・使い方、よくある質問に関するQ&Aについて詳しく解説しております。Twitterブックマーク自動エクスポートツールの[…]
本記事では業務自動化ツールを企画開発するGASラボの「いいね済みツイート自動リストアップツール」の概要・使い方、よくある質問に関するQ&Aについて詳しく解説しております。いいね済みツイート自動リストアップツールの概要[…]
