Twitterの検索API & Twitterでの検索術(search/tweetsとsearch/universal)

2017.08.18
SNS Twitter
API

search/tweets では一週間以上前のツイートは検索できないので注意
search/universal は公式のConsumerKey/ConsumerSecretでないと使用できない
———————-
———————-
■ 使いそうなクエリ群
“ほげほげふがふが” – “ほげほげふがふが”が含まれるツイートの検索
ほげほげ OR ふがふが – “ほげほげ”か“ふがふが”が含まれるツイートの検索
ほげほげ -ふがふが – “ほげほげ”が含まれ“ふがふが”が含まれないツイートの検索
#ほげほげ – ハッシュタグ“ほげほげ”が含まれるツイートの検索
from:user – ユーザーuserのツイートを検索
to:user – 宛先がユーザーuserのツイートを検索
@user – リプライ@userが含まれるツイートの検索
ほげほげ since:2015-02-23 – 2015年2月23日以降の“ほげほげ”が含まれるツイートを最新から順に検索(search/tweetsでは1週間以上前のツイートは検索不可)
ほげほげ until:2015-02-23 – 2015年2月23日以前の“ほげほげ”が含まれるツイートを最新から順に検索(search/tweetsでは1週間以上前のツイートは検索不可)
ほげほげ：) – “ほげほげ”が含まれ内容がポジティブなツイートの検索
ほげほげ：( – “ほげほげ”が含まれ内容がネガティブなツイートの検索
ほげほげ ? – “ほげほげ”が含まれ内容が疑問形なツイートの検索
ほげほげ source:flantter – “ほげほげ”が含まれFlantterからつぶやかれたツイートの検索
ほげほげ lang:ja – “ほげほげ”が含まれ日本語のツイートを検索(他en等)
ほげほげ include:retweets – “ほげほげ”が含まれるリツイートを含むツイートを検索
ほげほげ exclude:retweets – “ほげほげ”が含まれるリツイートを含まないツイートを検索
ほげほげ exclude:nativeretweets – “ほげほげ”が含まれるリツイートを含まないツイートを検索?
ほげほげ list:user/listname – userのlistnameというリスト内で“ほげほげ”が含まれるツイートを検索
ほげほげ geocode:37.78115,-122.39872,1mi – “ほげほげ”を含み、緯度、経度、範囲を指定して検索(単位はkm,mi等)
ほげほげ near:me – “ほげほげ”を含み自分に近いところにいる人間のツイートを検索 (ドキュメントに書いてない)
ほげほげ near:新潟 – “ほげほげ”を含み新潟付近でつぶやかれたツイートの検索
ほげほげ near:新潟 within:10km – “ほげほげ”を含み新潟付近でつぶやかれたツイートの検索(範囲を10kmに指定、単位はkm,mi等)
ほげほげ filter:links – “ほげほげ”とリンクが含まれるツイートの検索
ほげほげ filter:verified – “ほげほげ”が含まれ認証されたアカウントからつぶやかれたツイートを検索
ほげほげ filter:images – “ほげほげ”と画像が含まれるツイートの検索
ほげほげ filter:twimg – “ほげほげ”とツイッターの画像が含まれるツイートの検索
ほげほげ filter:videos – “ほげほげ”と動画が含まれるツイートの検索
ほげほげ filter:media – “ほげほげ”とメディア(画像と動画)が含まれるツイートの検索
ほげほげ filter:vine – “ほげほげ”とVineが含まれるツイートの検索 (ドキュメントに書いてない)
ほげほげ filter:news – “ほげほげ”が含まれ、ニュースだと思われるツイートの検索 (ドキュメントに書いてない)
ほげほげ filter:safe – “ほげほげ”が含まれ、possibly_sensitiveフラグが0のツイートの検索？
ほげほげ filter:periscope – “ほげほげ”が含まれ、periscopeで配信しているツイートの検索
ほげほげ filter:native_video – “ほげほげ”が含まれ、periscope,vineまたはTwitterにアップロードされた動画の検索
ほげほげ card_name:animated_gif – “ほげほげ”が含まれ、GIFが含まれるツイートを検索 (ドキュメントに書いてない)
ほげほげ min_retweets:100 – “ほげほげ”が含まれリツイートが100以上のツイートを検索 (ドキュメントに書いてない)
ほげほげ min_faves:100 – “ほげほげ”が含まれお気に入りが100以上のツイートを検索 (ドキュメントに書いてない)
ほげほげ min_replies:5 – “ほげほげ”が含まれリプライが5以上のツイートを検索 (ドキュメントに書いてない)
———————-
■ 備考
filter関連の検索はNOTと併用できる
———————-
■ 使用例
ほげほげ filter:media exclude:retweets – “ほげほげ”が含まれメディアが含まれるツイートの検索
from:user filter:images min_faves:100 – userの画像で100ふぁぼ以上のツイートを検索
ほげほげ filter:images min_faves:100 exclude:retweets – “ほげほげ”が含まれ100ふぁぼ以上のツイートを検索
ほげほげ filter:images -filter:safe – “ほげほげ”が含まれpossibly_sensitiveフラグが1のツイートの検索(おそらくR-18な絵が多いと思われる)
search/universalの軽い使い方
———————-
■ 重要なパラメータ
q – 検索する文字列 (上記のクエリ使用可)
modules – モジュールを指定(statusを指定でツイートのみが流れてくる,指定しない場合はユーザーなども含まれる)
count – 取得するツイート数(ツイートのみ,ユーザーなどは別で流れてくる)
result_type – search/tweetsと同じ?