このエンドポイント へアクセスするには特別なアクセス権が必要で、TV放送をする場合にのみ使用できます。アクセス権の申請をする場合は curator.twitter.comからお願いします。
指定した時間範囲における、ストリーム内のツイートとツイート主の数、男女の内訳、トップ用語、トップ地域を取得します。
GET streams/
|
https://curator.twitter.com/broadcast/1/streams/:id/metrics
Resource URL
|
Resource Information
Response formats
JSON
XML
Requires authentication?
Yes
Rate limited?
Yes
Requests / 15-min window (user auth)
3900
Requests / 15-min window (app auth)
3900
|
コンテンツを取得するストリームの id 。
ユーザーの認証トークン。
開始時間をUNIXタイムスタンプ形式のミリ秒単位で表す。指定した時間の範囲が2時間以下だった場合、この値は最も近い分単位になるよう切り捨てが行われます。 指定した時間の範囲が5日以下だった場合、この値は最も近い時間単位になるよう切り捨てが行われます。 それ以外の場合、この値は最も近い日単位になるよう切り捨てが行われます。 180日以上過去の日付を設定することはできません。設定しなかった場合、既定値は end_time - 1時間 になります。
終了時間をUNIXタイムスタンプ形式のミリ秒単位で表す。指定した時間の範囲が2時間以下だった場合、この値は最も近い分単位になるよう切り上げが行われます。 指定した時間の範囲が5日以下だった場合、この値は最も近い時間単位になるよう切り上げが行われます。 それ以外の場合、この値は最も近い日単位になるよう切り上げが行われます。 時間範囲を30日以上にすることはできません。設定しなかった場合、既定値は今の時間になります。
出力形式をリクエストします。このパラメータは jsonか xmlのどちらかを設定できます。既定値は jsonです。
Parameters
id
required
The id of the stream to get content for.
auth
required
Auth token for user.
start_time
optional
The starting unix timestamp in milliseconds. If time range is less than 2 hours will be rounded down to nearest minute, less than 5 days will be rounded down to nearest hour, otherwise will be rounded down to nearest day. Cannot be greater than 30 days in the past. Defaults to
end_time
optional
The ending unix timestamp in milliseconds. If time range is less than 2 hours will be rounded up to nearest minute, less than 5 days will be rounded up to nearest hour, otherwise will be rounded up to nearest day. Range cannot be greater than 30 days. Defaults to now if not specified.
format
optional
The output format request. This param can be either |
ログイン して登録アプリケーションの一覧を参照してください。
OAuth Signature GeneratorSign in to see a list of your registered applications. |
GET
https://curator.twitter.com/broadcast/1/streams/2283/metrics?auth=<auth_token>&start_time=1408399200000&end_time=1408399540168
Example RequestGET
|
{
"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
}
}
}
}
Example Result{
"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
}
}
}
}
|