サイトのトップへ戻る

Twitter 開発者 ドキュメント日本語訳

POST statuses/filter

一つ以上のフィルタ用語に合致したツイートを取得します。複数のパラメータを設定可能で、これによりクライアントはストリーミングAPIへの接続を一回で済ませることができます。 GET リクエストと POST リクエストの両方をサポートしていますが、 GET リクエストにたくさんのパラメータを設定するとURLが長くなりすぎてリクエストが拒否されることがあります。 URLが長くなるのを防ぐにはPOSTリクエストを使用してください。

trackと followとlocations は、OR演算子を使ってつなげていると見なされます。 track=foo&follow=1234 と指定すると、 “foo”に合致するツイートもしくはユーザー 1234によってつぶやかれたツイートを取得します。

既定のアクセスレベルでは、最大で400個の検索キーワード、5000個のフォローユーザーID、25個の位置ボックス(0.1度から360度の範囲)を使用できます。 ストリームAPIへのアクセスを向上させる必要がある場合は、Twitter data Certified-Data-Productsのパートナープロバイダーを探してください。



リソースURL

https://stream.twitter.com/1.1/statuses/filter.json



リソース情報

応答形式
JSON
認証は必要ですか?
はい (user context only)
速度制限はありますか?
はい


パラメータ

*注意: 少なくとも一つは predicate パラメータ (followlocationstrack)を設定しなければなりません。

follow *注意 を参照してください

ストリーム内でツイートを取得するユーザーを表すユーザーIDをコンマ区切った一覧。詳細情報については follow を参照してください。

track *注意 を参照してください

検索するキーワード。キーワードのフレーズはコンマ区切りの一覧で指定します。詳細情報については track を参照してください。

locations *注意 を参照してください

検索する領域範囲を指定します。詳細情報については locations を参照してください。

delimited 任意

メッセージを length-delimited にするかどうか設定します。詳細情報については delimited を参照してください。

stall_warnings 任意

速度低下警告 を通知するかどうかを設定します。詳細情報についてはstall_warningsを参照してください。



OAuth 署名ジェネレータ

ログイン して登録アプリケーションの一覧を参照してください。



リクエスト例

https://stream.twitter.com/1.1/statuses/filter.json?track=twitter