サイトのトップへ戻る

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

GET streams/compare

このエンドポイント へアクセスするには特別なアクセス権が必要で、TV放送をする場合にのみ使用できます。アクセス権の申請をする場合は curator.twitter.comからお願いします。

指定した時間範囲内における、指定したストリームにおけるツイートとツイート主の数を取得します。 特定のストリームを対象とするstream_idsか、プロジェクト内全てのストリームを対象とする project_id のどちらかを設定してください。 また、指定した各ストリームごとにツイートとツイート主の全体に占める割合を計算します。



リソースURL

https://curator.twitter.com/broadcast/1/streams/compare



リソース情報Information

応答形式
JSON
XML
認証は必要ですか?
はい
レート制限はありますか?
はい
リクエスト回数 / 15分枠 (ユーザー認証の場合)
3750
リクエスト回数 / 15分枠 (アプリケーション認証の場合)
3750


パラメータ

stream_idsproject_id のどちらかは必ず設定してください。

stream_ids 必須

ストリームIDをコンマ区切りでまとめた一覧。

project_id 必須

stream IDの一覧を指定するのではなく、代わりにプロジェクトIDを一つ設定してプロジェクト内の全てのストリームを対象とすることができます。

auth 必須

ユーザーの認証トークン。

start_time 任意

開始時間をUNIXタイムスタンプ形式のミリ秒単位で表す。指定した時間の範囲が2時間以下だった場合、この値は最も近い分単位になるよう切り捨てが行われます。 指定した時間の範囲が5日以下だった場合、この値は最も近い時間単位になるよう切り捨てが行われます。 それ以外の場合、この値は最も近い日単位になるよう切り捨てが行われます。 180日以上過去の日付を設定することはできません。設定しなかった場合、既定値は end_time - 1時間 になります。

end_time 任意

終了時間をUNIXタイムスタンプ形式のミリ秒単位で表す。指定した時間の範囲が2時間以下だった場合、この値は最も近い分単位になるよう切り上げが行われます。 指定した時間の範囲が5日以下だった場合、この値は最も近い時間単位になるよう切り上げが行われます。 それ以外の場合、この値は最も近い日単位になるよう切り上げが行われます。 時間範囲を30日以上にすることはできません。設定しなかった場合、既定値は今の時間になります。

format 任意

出力形式をリクエストします。このパラメータは jsonxmlのどちらかを設定できます。既定値は jsonです。



OAuth 署名ジェネレータ

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



リクエスト例

GET

https://curator.twitter.com/broadcast/1/streams/compare?auth=<auth_token>&stream_ids=3218,3219



応答結果の例

{
  start_time: 1408980840000,
  end_time: 1408984500000,
  data: [
    {
      id: 3218,
      title: "happy",
      tweets: 7864,
      authors: 6222,
      tweets_percent: 86,
      authors_percent: 83
    },
    {
      id: 3219,
      title: "sad",
      tweets: 1327,
      authors: 1231,
      tweets_percent: 14,
      authors_percent: 17
    }
  ]
}