本記事では自動化ツールやAIツールを企画開発するGASラボの「Twitter(X)動画検索リサーチツール」の概要・使い方、入手方法、よくある質問に関するQ&Aについて詳しく解説しております。
【はじめに】Twitter(X)動画検索リサーチツールの概要
本ツールは、Twitter(X)の特定の検索キーワードにヒットする動画付き投稿データを自動取得するツールです。
- 指定した任意の検索キーワードにヒットするTwitter(X)の直近1週間の動画付き投稿データを自動取得
- 取得したデータはGoogleスプレッドシートに出力
- 本ツール専用の分析用Looker Studioテンプレート＆自動レポート生成機能つき
任意の検索キーワードを指定すると、直近1週間の動画付き投稿データを自動で取得できます。
検索キーワードはAND検索や完全一致検索も可能なので、ニッチな領域の動画付き投稿のリサーチも可能です。
また、取得データには動画の視聴数やインプレッション数のほか、いいね数やリツイート数など主要なパフォーマンスデータが含まれており、すべてGoogleスプレッドシートに出力されます。
そのため、フィルターやソートを使った並べ替えや分析も簡単に実施できます。
加えて、本ツールには取得したデータの可視化・分析にご利用いただけるGoogleの無料BIツール「Looker Studio」の本ツール専用の分析用テンプレートも付属しています。また、本ツールにはレポート自動生成機能が備わっているため、クリック操作のみでLooker Studioレポートが作成可能です。
なお、本ツールはあらかじめ「Google Apps Script（GAS）」を実装したGoogleスプレッドシート形式のツールとなっており、プログラムコードの編集やコピペは不要です。
Googleスプレッドシートが利用可能なパソコンであれば、WindowsでもMacでもご利用いただけます。
Twitter(X)の特定の領域の動画付き投稿を効率良く調査したい方、Twitter(X)の動画付き投稿を伸ばしたい方、Looker Studioを使ってTwitter(X)の動画付き投稿を分析したい方におすすめのツールです。
【本ツール専用】分析用Looker Studioテンプレートについて
本ツールでは、専用Looker Studioテンプレートを用いた分析用レポートを自動で生成することが可能です。
本テンプレートを利用すれば、ツールで取得した投稿データを簡単に下記の分析観点をグラフを用いて可視化できます。
- 投稿別
- 動画別
- Twitter(X)アカウント別
- 時間帯別
- 曜日別
Twitter(X)動画検索リサーチツールの3つの特徴
Twitter(X)の任意の検索キーワードで動画付き投稿のみを自動取得
- お好きな検索キーワードにマッチするTwitter(X)の動画付き投稿を自動で取得＆自動出力できるツールです。
- AND検索、完全一致検索にも対応しております。
- 取得した投稿データは分析や加工に便利なスプレッドシートに出力します。
- 視聴数やインプレッション数などの各種主要なパフォーマンス指標を取得可能です。
本ツール専用分析用BIツールテンプレートつき
- 取得したデータを簡単に可視化・分析できるようにするため、Googleの無料BIツール「Looker Studio」の分析用テンプレートをご用意しております。
- セットアップも本ツールで実装された「自動生成機能」を利用してレポートを生成するため、クリック操作のみで簡単に分析を開始することができます。
画像付き設定マニュアルがあるので、初心者でも安心！
- 本ツールはリスト情報やTwitter(X)アカウント情報の取得、フォロー操作にTwitterAPI（Basicプラン以上の有料プラン）を利用しております。
- 初心者の方でも簡単にAPIの設定や本ツールの利用のための設定ができるよう、画像付きの丁寧なマニュアルを用意しておりますので、ご安心ください。
- プログラミングコードの編集やコピー＆ペーストは不要です。どなたでもご利用いただけます。
Twitter(X)動画検索リサーチツールはこんな方にオススメ！
- Twitter(X)の特定領域の動画付き投稿のリサーチを効率化したい方
- 今後Twitter(X)にて動画付き投稿を注力していきたい方
- BIツール「Looker Studio」での分析にチャレンジしてみたい方
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(X)の認証手続きは完了です。
これでTwitter APIを利用する準備が整いました。
「アカウント認証」でよくあるエラーと解決方法
アカウント認証時に発生するよくあるエラーは下記のようなエラーです。
- 「問題が発生しました アプリにアクセスを許可できません。」
- 「アプリにアクセスを許可できません。」
- 「Could not authenticate you.」
上記のような原因および解決方法は下記の記事に記載しておりますので、ご一読ください。
※補足：「アカウント認証をクリア」機能もご用意しております。
利用するアカウントを変更するシーンなど、アカウント認証をクリアしたいときにご利用できる「アカウント認証をクリア」メニューもご用意しております。必要に応じてご利用ください。
STEP4：設定シートにて、リサーチオプションを設定
次に、Twitter(X)の動画を検索・リサーチするための設定を進めます。
本ツールの「設定」シートの下記4点の項目を設定してください。
リサーチオプション設定の設定項目
- ツイート取得期間：開始日
- 任意設定項目です。
- 指定される場合は、直近過去7日間以内の日付にて、有効な日付を入力してください。
- 例：2024/4/1
- 何も設定しない場合のデフォルトは、直近過去7日前となります。
- 過去7日よりも前の日付はAPIの仕様上取得不可となります。
- ツイート取得期間：終了日
- 任意設定項目です。
- 指定される場合は、直近過去7日間以内の日付にて、有効な日付を入力してください。
- 例：2024/4/7
- 何も設定しない場合のデフォルトは、「現在の日付」となります。
- 過去7日よりも前の日付はAPIの仕様上取得不可となります。
- 検索キーワード
- 必須設定項目です。
- 動画つきツイート（投稿）を検索するキーワードを設定してください。
- AND検索や完全一致検索などが可能です。
- 通常検索：半角スペースなしでキーワードを入力します
- テキストボックス入力例：「自動化ツール」
- AND検索：半角スペースでワードを繋げると、AND検索になります。
- テキストボックス入力例：「自動化 ツール」
- 完全一致検索：ダブルクオーテーションで括ると、完全一致検索になります。
- テキストボックス入力例：「”自動化 ツール”」
- 通常検索：半角スペースなしでキーワードを入力します
- 投稿取得上限数指定
- 任意設定項目です。
- 取得する投稿の上限数をプルダウンで指定することができます。
- 選択できる上限数は「100」〜「6,000」の100刻みの数字です。
- 何も設定しない場合のデフォルトは、「6,000」となります。
STEP5：メニューより「投稿データ取得」をクリック
最後に指定したリサーチオプション設定にて、動画付き投稿を自動取得します。
本ツール独自の「メニュー」より「投稿データ取得」をクリックします。
本自動化メニューを実行すると、キーワード検索にヒットする動画付き投稿が指定された上限数まで取得され、「取得結果一覧」シートへ出力されます。
本STEPが正しく実行されない場合やエラーが発生する場合は、STEP5までの設定に何らか問題がある可能性が高いため、STEP1からSTEP4までを改めて確認してみてください。
仕様補足
- 本ツールでは、APIの仕様上、直近過去7日までの投稿データを最大6,000件までが取得できます。
- リツイート（リポスト）やリプライの投稿は取得しない仕様となっております。
- 本ツールでは、Twitter(X)に直接アップロードされた、ネイティブのTwitter(X)動画を含む投稿のみを取得します。Periscopeで作成された動画や、他のビデオホスティングサイトへのリンクを含む投稿は取得しません。
- 本ツールでは、取得したツイートの数だけ、Basicプランの10,000件のツイート取得枠（Tweet Cap）を消費します。
- APIの利用状況の目安をご確認いただけるようにするため、本ツールの「API利用履歴」シートに本ツールでデータ取得した目安件数が自動で記録されていきます。（あくまで目安となりますので、詳細については、Twitter Developer Portalのダッシュボードにてご確認ください。）
- Tweet Capを超える数のデータの取得はできません。（原則エラーとなります）
- 本ツールでは、15分間に60回のリクエスト（リクエスト1回あたり100件の取得：最大：6,000件）までしか取得できない制限がございます。この最大制限を超えてしまうとエラーが発生しますので、ご注意ください。
- 一度取得したことのある投稿のデータは更新される仕様となっています。
- 下記のユーザーアカウントのツイートは取得不可となります。
- 取得しようとしたユーザーアカウントが何かしらの理由で凍結している
- 取得しようとしたユーザーアカウントが何かしらの理由で削除されている
- ブロックなど取得しようとしたユーザーアカウントへのアクセス権限がない
- 取得しようとしたユーザーアカウントが非公開である
- 取得しようとしたツイートが削除などされている
- ツイートが削除されている場合など、ツイートが取得できないケースもございます。合計の投稿数（ポスト数）と取得できた投稿数の合計が一致しないこともございますので、ご了承ください。
「投稿データ取得」メニュー実行時にエラーが発生した場合は？
「投稿データ取得」に発生するよくあるエラーは下記のようなエラーです。
- 「Too Many Requests」
- 「Error starting OAuth flow」
- 「Could not authenticate you.」
原因および解決方法は下記の記事に記載しておりますので、ご一読ください。
【参考】取得結果一覧シートをクリアする機能も搭載
本ツールの取得結果一覧シートをクリアしたい場合は、「取得結果一覧シートクリア」メニューを実行してください。
本ツール専用の分析用Looker Studioテンプレートの利用方法（自動生成方法）
Twitter(X)動画検索リサーチツールには、Googleの無料BIツール「Looker Studio（旧Googleデータポータル ）」の専用テンプレートを利用した分析用レポートの自動生成機能をご用意しております。
Twitter(X)動画検索リサーチツールで取得した動画つき投稿データを簡単に可視化・分析できるようになっています。本ツールのGoogleスプレッドシートをデータソースとして利用しているため、自動的に情報が更新されるようになっております。是非ご利用ください。
STEP1：メニューより「レポート自動生成」をクリック
※本作業を進める前に、既に動画付き投稿データを取得完了し、「取得結果一覧シート」にデータが出力されていることを確認してください。
本ツール独自の「メニュー」より「レポート自動生成」をクリックします。
「レポート自動生成」メニューを実行すると、レポートのリンクが自動で生成され、ポップアップウィンドウで表示されるので、リンクをクリックしてください。
STEP2：生成されたレポートの「保存して共有」をクリック
次に、「取得結果一覧シート」に出力されたデータをもとにLooker Studioレポートが自動生成された画面が表示されますので、画面右上の「保存して共有」ボタンをクリックします。
STEP3：「同意して保存する」をクリック
最後に「データアクセスを確認してから保存」の画面が表示されますので、内容を確認の上、画面右下の「同意して保存する」をクリックします。
これで、本ツール専用のLooker Studioテンプレートを利用したレポートの自動生成は完了です。
Twitter(X)動画検索リサーチツールで取得・出力できる項目
本ツールでは、Twitter(X)の動画付き投稿の下記の項目を取得・出力することが可能です。
分析などに便利なデータが揃っておりますので、是非ご活用ください。
- リサーチ対象キーワード
- ツイート日時
- ツイートID
- ツイート
- 長文ツイート
- ツイートURL
- メディアキー
- サムネイルURL
- サムネイル画像
- 動画の長さ（ミリ秒）
- 動画サイズ（縦）
- 動画サイズ（横）
- 視聴数
- インプレッション数
- いいね数
- リツイート数
- リプライ数
- 引用数
- ブックマーク数
- userId
- ユーザー名
- アカウント表示名
- プロフィール画像URL
- プロフィール画像
- Twitterアカウント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（GAS）にて開発した自動化ツールを企画・開発しております。これまで開発したツールは2024年3月現在、100種類以上を超え、今後も随時新規で開発、公開していく予定です。
Twitter(X)の自動化をするツールも複数開発しておりますので、主なツールを紹介します。
その他のTwitter(X)関連の自動化ツール
GASラボではその他Twitter(X)を自動化できるツールを複数ご用意しております。是非ご覧ください。
本記事では自動化ツールやAIツールを企画開発するGASラボの「Twitter(X)自動フォローツール」の概要・使い方、入手方法、よくある質問に関するQ&Aについて詳しく解説しております。【はじめに】Twitter(X)自動フォロ[…]
本記事では業務自動化ツールを企画開発するGASラボの「Twitterツリー形式ツイート予約投稿ツール（自動RT機能付き）」の概要・使い方、よくある質問に関するQ&Aについて詳しく解説しております。Twitterツリー形式ツイート[…]
本記事では自動化ツールやAIツールを企画開発するGASラボの「ツイート一括取得・保存ツール」の概要・使い方について詳しく解説しております。GASラボの「ツイート一括取得・保存ツール」をご存知ではない方向けに、ツールを入手する方法や、[…]
本記事では業務自動化ツールを企画開発するGASラボの「Twitterブックマーク自動エクスポートツール」の概要・使い方、よくある質問に関するQ&Aについて詳しく解説しております。Twitterブックマーク自動エクスポートツールの[…]
本記事では業務自動化ツールを企画開発するGASラボの「いいね済みツイート自動リストアップツール」の概要・使い方、よくある質問に関するQ&Aについて詳しく解説しております。いいね済みツイート自動リストアップツールの概要[…]
