はじめに
v2 の Search Posts エンドポイントでは、 作成した検索クエリに基づいて関心のあるトピックに関する投稿を取得できます。 v2 Search Posts には 2 種類のエンドポイントがあります。承認済みアカウントを持つ すべての開発者が利用でき、過去 7 日以内の投稿を検索できる recent search エンドポイント、そして Academic Research プロダクトトラックを承認された研究者のみが利用でき、2006 年 3 月までさかのぼるすべての投稿アーカイブを検索できる full-archive search エンドポイントです。 検索の全体的な提供内容は search 概要ページでご覧いただけます。 これらの Search Posts エンドポイントは、学術研究者にとって最も一般的な ユースケースの 1 つに対応します。彼らは縦断研究や過去のトピック・イベントの分析のためにこれを使用することがあります。 このチュートリアルでは、full-archive search エンドポイントを使って公開されている X データの全履歴を検索したい研究者向けに、ステップバイステップのガイドを提供します。ジオタグ付き投稿の取得によるデータセットの構築方法や、クエリに対して利用可能な投稿をページ送りする方法など、さまざまな方法も紹介します。前提条件
現時点でこのエンドポイントは、Academic Research プロダクトトラックの一部としてのみ利用可能です。 このエンドポイントを使用するには、アクセスを申請する必要があります。 このトラックの申請および要件について詳しく学びましょう。アプリを Academic プロジェクトに接続する
Academic Research プロダクトトラックの利用が承認されると、Developer Console に Academic の Project が表示されます。「Apps」セクションから「Add App」をクリックし、X アプリ を Project に接続します。
次に、既存のアプリを選択して Project に接続することもできます(下記参照)。
または、新しいアプリを作成し、名前を付けて「complete」をクリックすることで、新しいアプリを Academic Project に接続することもできます。
これにより、full-archive search エンドポイントへ接続する際に使用できる API キーと Bearer Token が発行されます。
注意
上のスクリーンショットではキーが非表示になっていますが、ご自身の Developer Console では、API Key、API Secret Key、Bearer Token の実際の値を確認できます。これらのキーと Bearer Token は、full-archive search エンドポイントを呼び出すために必要となるため、保存しておいてください。
full-archive search エンドポイントへの接続
以下の cURL コマンドは、@XDevelopers アカウントから過去の投稿を取得する方法を示します。$BEARER_TOKEN を自身の Bearer Token に置き換え、リクエスト全体をターミナルに貼り付けて Enter を押してください。クエリの構築
上の呼び出し例で示されているように、query パラメーターを使って検索したいデータを指定できます。たとえば、covid または coronavirus という語を含むすべての投稿を取得したい場合は、括弧内で OR オペレーターを使用し、クエリを(covid OR coronavirus) とできます。したがって API 呼び出しは以下のようになります。