雑多開発ブログ(仮)

Twitter Search APIの種類とPremium Search APIを使うための準備

すっごく昔のツイートをSearch APIで取得しようとしたらなぜかできませんでした。なので、Search APIの詳細を調べてみることにしました。

Search APIの概要

Overview — Twitter Developers

こちらはTwitterが提供する検索用APIの情報です。(上記サイトママ)

Category Product name Supported history Query capability Counts endpoint Data fidelity
Standard Standard Search API
7 days Standard operators Not available Incomplete
Premium Search Tweets: 30-day endpoint
30 days Premium operators Available Full
Premium Search Tweets: Full-archive endpoint Tweets from as early as 2006 Premium operators
Available Full
Enterprise 30-day Search API
30 days Premium operators
Included Full
Enterprise Full-archive Search API
Tweets from as early as 2006
Premium operators
Included Full

無料で使えるStandard APIではツイートを過去七日間までしか遡ることができません。私が使っていたのはどうやらこれのようです。
対してPremium API及びEnterprise APIでは過去30日のツイートを検索できる30-day endpointと2006年以降の全期間のツイートを検索できるFull Archive endpointが提供されています。こちらを使えばひと昔のツイートも取得することができそうです。

Standard APIの使い方はいろいろな所で紹介されているので割愛します。また、Enterprise APIはその名の通り企業向けです。
したがって、過去のツイートを個人で取得するにはPremium APIを使うのがよさそうです。

Premium APIを使うための準備

TwitterAPIを使うためのtokenやkeyを発行するにはTwitterのDevelopers accountを取得する必要があります。

Developer — Twitter Developers

Developerへの登録はこちらを参考にしました。

qiita.com

Developerの登録を終え、アプリを作成したら右上の[アカウント名]→[Dev Environments]を開きます。

f:id:lilacxi:20190518185236p:plain

f:id:lilacxi:20190518185450p:plain

使いたいendpointの[Set up dev environment]を押すと以下の画面が出てきます。

f:id:lilacxi:20190518185750p:plain

ここで、Dev environment labelとAppを選択します。labelはAPIURIに含まれます。お好みで設定してください。Appは選択するか、新しいのを作成してください。
この設定をすると、選択したAppでそのendpointが使えるようになります。

また、Premium APIは無料枠が一月ごとに決まっています。これは右上のDashbordから確認することができます。

f:id:lilacxi:20190518190408p:plain

無料枠では足りない方はSubscriptionでUpgradeすることができます。

これでPremium APIが使えるようになりました。
APIのリファレンスはこちらにあります。

Premium search APIs — Twitter Developers

使い方などはまた別記事でまとめる予定です。