サイトのトップへ戻る

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




GET streams/:id/metrics

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

指定した時間範囲における、ストリーム内のツイートとツイート主の数、男女の内訳、トップ用語、トップ地域を取得します。



リソースURL

https://curator.twitter.com/broadcast/1/streams/:id/metrics



リソース情報

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


パラメータ

id 必須

コンテンツを取得するストリームの id 。

auth 必須

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

start_time 任意

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

end_time 任意

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

format 任意

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



OAuth 署名ジェネレータ

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



リクエスト例

GET

https://curator.twitter.com/broadcast/1/streams/2283/metrics?auth=<auth_token>&start_time=1408399200000&end_time=1408399540168

応答結果の例

{
  "start_time": 1408395960000,
  "end_time": 1408399620000,
  "data": {
    "id": 2283,
    "total": {
      "tweets": 54,
      "unique_authors": 45
    },
    "by_gender": {
      // gender counts are rounded to nearest 100
      "male": {
        "tweets": 200,
        "unique_authors": 200
      },
      "female": {
        "tweets": 100,
        "unique_authors": 100
      },
      "unknown": {
        // gender counts less than 100 show up as null
        "tweets": null,
        "unique_authors": null
      }
    }
  }
}