サイトのトップへ戻る

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

サイト内検索

GET streams/:id/trendline

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

指定された時間範囲における、ストリーム内のツイートとツイート主の数、男女の内訳を分単位や時間単位や日単位で取得します。 各値がタイムスタンプの付いた配列になっていることを除けば、metrics とほとんど同じです。



リソースURL

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



リソース情報

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


パラメータ

id 必須

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

auth 必須

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

start_time 任意

開始時間をUNIXタイムスタンプ形式のミリ秒単位で表す。最も近いgranularityの倍数に切り捨てされます。 30日以上過去の日付を設定することはできません。設定しなかった場合、既定値は end_time - 1時間 になります。

end_time optional

終了時間をUNIXタイムスタンプ形式のミリ秒単位で表す。最も近いgranularityの倍数に切り上げされます。 指定する時間範囲について、分粒度(MINUTE)の場合は2時間を超えて指定することはできず、時間粒度(HOUR)の場合は5日を超えて指定することはできず、日粒度(DAY)の場合は30日を超えて指定することはできません。 設定しなかった場合、既定値は今の時間になります。

granularity 任意

MINUTEHOURDAYのどれかを設定します。時間単位のサイズを指定します。設定しなかった場合、既定値はMINUTEになります。

format 任意

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



OAuth 署名ジェネレータ

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



リクエスト例

GET

https://curator.twitter.com/broadcast/1/streams/2283/trendline?auth=<auth_token>&start_time=1408399380000&end_time=1408403040000



応答結果の例

{
  "start_time": 1408399380000,
  "end_time": 1408403040000,
  "data": {
    "id": 2283,
    "total": [
      {
        "timestamp": 1408399380000,
        "value": {
          "tweets": 0,
          "unique_authors": 0
        }
      },
      {
        "timestamp": 1408399440000,
        "value": {
          "tweets": 1,
          "unique_authors": 1
        }
      },
      ...
      }
    ],
    "by_gender": {
      // gender counts are rounded to nearest 100
      "male": [
        {
          "timestamp": 1408399380000,
          "value": {
            // gender counts less than 100 show up as null
            "tweets": null,
            "unique_authors": null
          }
        },
        {
          "timestamp": 1408399440000,
          "value": {
            "tweets": 100,
            "unique_authors": 100
          }
        },
        ...
      ],
      "female": [
        {
          "timestamp": 1408399380000,
          "value": {
            "tweets": null,
            "unique_authors": null
          }
        },
       ...
      ],
      "unknown": [
        {
          "timestamp": 1408399380000,
          "value": {
            "tweets": 100,
            "unique_authors": 100
          }
        },
       ...
      ]
    }
  }
}