このエンドポイント へアクセスするには特別なアクセス権が必要で、TV放送をする場合にのみ使用できます。アクセス権の申請をする場合は curator.twitter.comからお願いします。
ストリームのツイート数、もしくは重複を省いたツイート主数を目標数値と比較し、目標数値に占めるパーセンテージを取得します。
GET streams/
|
https://curator.twitter.com/broadcast/1/streams/compare_to_target
Resource URL
|
Resource Information
Response formats
JSON
XML
Requires authentication?
Yes
Rate limited?
Yes
Requests / 15-min window (user auth)
3750
Requests / 15-min window (app auth)
3750
|
stream_ids
か project_id
のどちらかは必ず設定してください。
ストリームIDをコンマ区切りでまとめた一覧。
stream IDの一覧を指定するのではなく、代わりにプロジェクトIDを一つ設定してプロジェクト内の全てのストリームを対象とすることができます。
TWEETS か AUTHORS のどちらかの値を設定します。tweets と設定すると、ツイート数と目標数値を比較します。authorsと設定すると、重複を省いたツイート主数と目標数値を比較します。
ツイートや重複を省いたツイート主の目標数値。
ユーザーの認証トークン。
開始時間をUNIXタイムスタンプ形式のミリ秒単位で表す。指定した時間の範囲が2時間以下だった場合、この値は最も近い分単位になるよう切り捨てが行われます。 指定した時間の範囲が5日以下だった場合、この値は最も近い時間単位になるよう切り捨てが行われます。 それ以外の場合、この値は最も近い日単位になるよう切り捨てが行われます。 180日以上過去の日付を設定することはできません。設定しなかった場合、既定値は end_time
- 1時間 になります。
終了時間をUNIXタイムスタンプ形式のミリ秒単位で表す。指定した時間の範囲が2時間以下だった場合、この値は最も近い分単位になるよう切り上げが行われます。 指定した時間の範囲が5日以下だった場合、この値は最も近い時間単位になるよう切り上げが行われます。 それ以外の場合、この値は最も近い日単位になるよう切り上げが行われます。 時間範囲を30日以上にすることはできません。設定しなかった場合、既定値は今の時間になります。
出力形式をリクエストします。このパラメータは json
か xml
のどちらかを設定できます。既定値は json
です。
ParametersEither
stream_ids
required
A comma separated list of stream IDs.
project_id
required
Instead of specifying a list of stream IDs, you can instead specify a single project ID and all streams in that project will be included.
mode
required
Either TWEETS or AUTHORS. When tweets specified, will compare number of tweets to the target. When authors specified, will compare number of unique authors to the target.
target
required
The target value for tweets or unique authors.
auth
required
Auth token for user.
start_time
optional
The starting unix timestamp in milliseconds. If time range is less than or equal to 2 hours will be rounded down to nearest minute, less than or equal to 5 days will be rounded down to nearest hour, otherwise will be rounded down to nearest day. Cannot be greater than 180 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/compare_to_target?auth=<auth_token>&stream_ids=2283,2284&target=5&mode=tweets
Example RequestGET
|
{ "start_time": 1408401180000, "end_time": 1408404840000, "data": [ { "id": 2283, "title": "Top Gear", "percent_of_goal": 90 }, { "id": 2284, "title": "Top Gear - w/o Friends", "percent_of_goal": 60 } ] }
Example Result{ "start_time": 1408401180000, "end_time": 1408404840000, "data": [ { "id": 2283, "title": "Top Gear", "percent_of_goal": 90 }, { "id": 2284, "title": "Top Gear - w/o Friends", "percent_of_goal": 60 } ] } |