Tweets

Tweets とは、Twitterにおける全てのものを構成する基本原子です。 Tweetsはまた、一般的には “status updates.”として知られています。 Tweets は埋め込んだり、リプライしたり、お気に入り登録したり、お気に入りを解除したり、削除したりすることができます。

URLの先頭にある “http://” は、ブラウザへのコマンドです。 It stands for “head to this place:” followed by two laser-gun noises.
— Brian Sutorius (@bsuto) February 21, 2012

フィールドの説明

Tweets を使用する際には、新たにフィールドが追加されるケースやフィールドの並び順がばらばらになるケースを想定してプログラムを組む必要があります。コンテクストによっては表示されないフィールドもあります。フィールドがnullになっている、emptyと設定されている、フィールド自体が存在しないといった事象は全て同じものと考えて処理を組むのが安全です。検索結果で取得されるTweets はこのドキュメントで説明した構造とは少し変わっているので注意してください。

フィールド	型	説明
annotations	Object	未使用。 Future/beta home for status annotations.
contributors	Contributorsの集まり	この値はNullとなる場合があります。公式のツイート主に代わってこのツイートを寄稿したユーザーを表す、簡単な User オブジェクト集(大抵の場合は一つだけです)。 Discussion. 例: "contributors": [ { "id":819797, "id_str":"819797", "screen_name":"episod" } ]
coordinates	Coordinates	この値はNullとなる場合があります。ユーザーやクライアントアプリケーションから報告されたツイートの地理情報を表します。内部の座標配列はgeoJSON形式 (一つ目に経度、二つ目に緯度を記載)になります。例: "coordinates": { "coordinates": [ -75.14310264, 40.05701649 ], "type":"Point" }
created_at	String	このツイートが作成された時のUTC時間。例: "created_at":"Wed Aug 27 13:08:45 +0000 2008"
current_user_retweet	Object	Perspectival. `include_my_retweet` パラメータをサポートしているメソッドで、そのパラメータに trueを設定した場合にのみ表示されます。リツイートがあれば、このツイートをリツイートしているユーザーのツイートID。例: "current_user_retweet": { "id": 26815871309, "id_str": "26815871309" }
entities	Entities	ツイート文から抽出したEntities 。Twitter オブジェクト内のEntities も合わせて参照してください。例: "entities": { "hashtags":[], "urls":[], "user_mentions":[] }
favorite_count	Integer	この値はNullとなる場合があります. Twitterユーザーによってこのツイートが“お気に入り登録された” おおよその回数を示します。例: "favorite_count":1138
favorited	Boolean	この値はNullとなる場合があります. Perspectival. 認証ユーザーによって、このツイートがお気に入り登録されたかどうかを示します。例: "favorited":true
filter_level	String	Indicates the maximum value of the filter_level parameter which may be used and still stream this Tweet. So a value of `medium` will be streamed on `none`, `low`, and `medium` streams. 例: "filter_level": "medium"
geo	Object	非推奨です。この値はNullとなる場合があります。代わりに “coordinates” フィールドを使用してください。 Discussion
id	Int64	このユーザーのユニークIDを表す数字。この数字は53ビット以上なので、プログラミング言語によってはこの数字を扱う際に、対処が難しく気づきにくいバグが発生する可能性があります。このIDは符号付64ビット整数に格納して使用するのが安全です。IDを取得する際に `id_str` を使用するのも良いでしょう。Twitter IDs、 JSON とSnowflakeを参照してください。例: "id":114749583439036416
id_str	String	このユーザーのユニークIDを表す文字列。`id`の数値が大きすぎてプログラムで実装できない場合は、数値ではなくこの文字列を使ってください。 Discussion. Example: "id_str":"114749583439036416"
in_reply_to_screen_name	String	この値はNullとなる場合があります。このツイートがリプライの場合、このフィールドにはオリジナルツイートのつぶやき主のスクリーンネームが入ります。 Example: "in_reply_to_screen_name":"twitterapi"
in_reply_to_status_id	Int64	この値はNullとなる場合があります。このツイートがリプライの場合、このフィールドにはオリジナルツイートのIDを表す数値が入ります。例: "in_reply_to_status_id":114749583439036416
in_reply_to_status_id_str	String	この値はNullとなる場合があります。このツイートがリプライの場合、このフィールドにはオリジナルツイートのIDを表す文字列が入ります。例: "in_reply_to_status_id_str":"114749583439036416"
in_reply_to_user_id	Int64	この値はNullとなる場合があります。このツイートがリプライの場合、このフィールドにはオリジナルツイートのつぶやき主のIDを表す数値が入ります。これは、必ずしもツイート内で直接言及している相手のIDが入るとは限りません。例: "in_reply_to_user_id":819797
in_reply_to_user_id_str	String	この値はNullとなる場合があります。このツイートがリプライの場合、このフィールドにはオリジナルツイートのつぶやき主のIDを表す文字列が入ります。これは、必ずしもツイート内で直接言及している相手のIDが入るとは限りません。例: "in_reply_to_user_id_str":"819797"
lang	String	この値はNullとなる場合があります。このフィールドが存在する場合、それはツイート文から自動的に特定したBCP 47 言語識別子を表します。または、言語が特定できなかった場合は “`und`” になります。例: "lang": "en"
place	Places	この値はNullとなる場合があります。このフィールドが存在する場合、このツイートにはPlace情報が関連付けられていることを表します(必ずしもツイートの発信場所が設定されるわけではありません)。例: "place": { "attributes":{}, "bounding_box": { "coordinates": [[ [-77.119759,38.791645], [-76.909393,38.791645], [-76.909393,38.995548], [-77.119759,38.995548] ]], "type":"Polygon" }, "country":"United States", "country_code":"US", "full_name":"Washington, DC", "id":"01fbe706f872cb32", "name":"Washington", "place_type":"city", "url": "http://api.twitter.com/1/geo/id/01fbe706f872cb32.json" }
possibly_sensitive	Boolean	この値はNullとなる場合があります。このフィールドは、ツイート内にリンクが含まれている場合にのみ表示されます。このフィールドがtrueになっていたとしても、ツイート文の内容自体がデリケートな事柄となっているとは限りません。ツイート内のURLの内容がデリケートな事柄である可能性があります。例: "possibly_sensitive":true
quoted_status_id	Int64	このフィールドは、ツイートが引用ツイートだった場合に表示されます。このフィールドには引用元ツイートの数値型ツイートIDが設定されます。例: "quoted_status_id":114749583439036416
quoted_status_id_str	String	このフィールドは、ツイートが引用ツイートだった場合に表示されます。このフィールドには引用元ツイートのツイートIDを表す文字列設定されます。例: "quoted_status_id_str":"114749583439036416"
quoted_status	Tweet	このフィールドは、ツイートが引用ツイートだった場合に表示されます。この属性には引用元ツイートのTweetオブジェクトが設定されます。
scopes	Object	A set of key-value pairs indicating the intended contextual delivery of the containing Tweet.現在はTwitterのPromoted Productsで使用されています。例: "scopes":{"followers":false}
retweet_count	Int	このツイートがリツイートされた回数。 This field is no longer capped at 99 and will not turn into a String for “100+” 例: "retweet_count":1585
retweeted	Boolean	Perspectival.このツイートが、認証ユーザーによってリツイートされたかどうかを示します。例: "retweeted":false
retweeted_status	Tweet	ユーザーはリツイートすることによって、ほかのユーザーがつぶやいたツイートを拡散することができます。`retweeted_status`属性があるかどうかによって、リツイートと通常のツイートを区別することができます。この属性には、リツイートされたオリジナル Tweetの内容が記載されています。リツイートをリツイートしてもその間にあるリツイートは記載は表示されず、オリジナルのツイートのみが表示されるので注意してください。 (ユーザーはリツイートを削除することによって、作成したリツイートを解除することもできます。)
source	String	Utility used to post the Tweet, as an HTML-formatted string. Tweets from the Twitter website have a source value of `web`. 例: "source":"Twitter for Mac<\/a>"
text	String	ステータスの更新に使う UTF-8 文。現状で使用できる文字の詳細についてはtwitter-text を参照してください。例: "text":"Tweet Button, Follow Button, and Web Intents javascript now support SSL http:\/\/t.co\/9fbA0oYy ^TS"
truncated	Boolean	例えばリツイートの内容が140文字を超過した場合など、`text`パラメータの値が切り捨てられいるかどうかを示します。切り捨てが発生したテキストは`...`のような省略記号が文末に付きます。現在Twitterでは長すぎるツイートを投稿できないようになっているので、大多数のツイートではこの値は`false`となっています。 Note that while native retweets may have their toplevel `text` property shortened, the original text will be available under the `retweeted_status` object and the `truncated` parameter will be set to the value of the original status (in most cases, `false`). Example: "truncated":true
user	Users	このツイートを投稿したユーザー。このオブジェクト内に埋め込まれた Perspectival 属性は不確かな情報です。 Why are embedded objects stale or inaccurate?を参照してください。例: "user":{"statuses_count":3080, "favourites_count":22, "protected":false, "profile_text_color":"437792", "profile_image_url":"...", "name":"Twitter API", "profile_sidebar_fill_color":"a9d9f1", "listed_count":9252, "following":true, "profile_background_tile":false, "utc_offset":-28800, "description":"The Real Twitter API. I tweet about API changes, service issues and happily answer questions about Twitter and our API. Don't get an answer? It's on my website.", "location":"San Francisco, CA", "contributors_enabled":true, "verified":true, "profile_link_color":"0094C2", "followers_count":665829, "url":"http:\/\/dev.twitter.com", "default_profile":false, "profile_sidebar_border_color":"0094C2", "screen_name":"twitterapi", "default_profile_image":false, "notifications":false, "display_url":null, "show_all_inline_media":false, "geo_enabled":true, "profile_use_background_image":true, "friends_count":32, "id_str":"6253282", "entities":{"hashtags":[], "urls":[], "user_mentions":[]}, "expanded_url":null, "is_translator":false, "lang":"en", "time_zone":"Pacific Time (US & Canada)", "created_at":"Wed May 23 06:01:13 +0000 2007", "profile_background_color":"e8f2f7", "id":6253282, "follow_request_sent":false, "profile_background_image_url_https":"...", "profile_background_image_url":"...", "profile_image_url_https":"..."}
withheld_copyright	Boolean	このフィールドが存在してなおかつ “true”が設定されていた場合は、このコンテンツの一部がDMCA からのクレームによって制限状態になっていることを示します。 Example: "withheld_copyright": true
withheld_in_countries	Stringの配列	このフィールドが存在した場合、このコンテンツが制限されている国の二文字国コード(大文字)を一覧にしたものを表します。 Twitter はこのフィールドで、以下の国以外の値をサポートしています。: “XX” - このコンテンツは全ての国で制限されています。 “XY” - コンテンツは DMCA の要求により制限されています。例: "withheld_in_countries": ["GR", "HK", "MY"]
withheld_scope	String	このフィールドが存在した場合、制限されているコンテンツが “status”単位の制限か “user”単位の制限かを表します。例: "withheld_scope": "status"

Field Guide

Consumers of Tweets should tolerate the addition of new fields and variance in ordering of fields with ease. Not all fields appear in all contexts. It is generally safe to consider a nulled field, an empty set, and the absence of a field as the same thing. Please note that Tweets found in Search results vary somewhat in structure from this document.

Field	Type	Description
annotations	Object	Unused. Future/beta home for status annotations.
contributors	Collection of Contributors	Nullable. An collection of brief user objects (usually only one) indicating users who contributed to the authorship of the tweet, on behalf of the official tweet author. Discussion. Example: "contributors": [ { "id":819797, "id_str":"819797", "screen_name":"episod" } ]
coordinates	Coordinates	Nullable. Represents the geographic location of this Tweet as reported by the user or client application. The inner coordinates array is formatted as geoJSON (longitude first, then latitude). Example: "coordinates": { "coordinates": [ -75.14310264, 40.05701649 ], "type":"Point" }
created_at	String	UTC time when this Tweet was created. Example: "created_at":"Wed Aug 27 13:08:45 +0000 2008"
current_user_retweet	Object	Perspectival. Only surfaces on methods supporting the `include_my_retweet` parameter, when set to true. Details the Tweet ID of the user’s own retweet (if existent) of this Tweet. Example: "current_user_retweet": { "id": 26815871309, "id_str": "26815871309" }
entities	Entities	Entities which have been parsed out of the text of the Tweet. Additionally see Entities in Twitter Objects. Example: "entities": { "hashtags":[], "urls":[], "user_mentions":[] }
favorite_count	Integer	Nullable. Indicates approximately how many times this Tweet has been “favorited” by Twitter users. Example: "favorite_count":1138
favorited	Boolean	Nullable. Perspectival. Indicates whether this Tweet has been favorited by the authenticating user. Example: "favorited":true
filter_level	String	Indicates the maximum value of the filter_level parameter which may be used and still stream this Tweet. So a value of `medium` will be streamed on `none`, `low`, and `medium` streams. Example: "filter_level": "medium"
geo	Object	Deprecated. Nullable. Use the “coordinates” field instead. Discussion
id	Int64	The integer representation of the unique identifier for this Tweet. This number is greater than 53 bits and some programming languages may have difficulty/silent defects in interpreting it. Using a signed 64 bit integer for storing this identifier is safe. Use `id_str` for fetching the identifier to stay on the safe side. See Twitter IDs, JSON and Snowflake. Example: "id":114749583439036416
id_str	String	The string representation of the unique identifier for this Tweet. Implementations should use this rather than the large integer in `id`. Discussion. Example: "id_str":"114749583439036416"
in_reply_to_screen_name	String	Nullable. If the represented Tweet is a reply, this field will contain the screen name of the original Tweet’s author. Example: "in_reply_to_screen_name":"twitterapi"
in_reply_to_status_id	Int64	Nullable. If the represented Tweet is a reply, this field will contain the integer representation of the original Tweet’s ID. Example: "in_reply_to_status_id":114749583439036416
in_reply_to_status_id_str	String	Nullable. If the represented Tweet is a reply, this field will contain the string representation of the original Tweet’s ID. Example: "in_reply_to_status_id_str":"114749583439036416"
in_reply_to_user_id	Int64	Nullable. If the represented Tweet is a reply, this field will contain the integer representation of the original Tweet’s author ID. This will not necessarily always be the user directly mentioned in the Tweet. Example: "in_reply_to_user_id":819797
in_reply_to_user_id_str	String	Nullable. If the represented Tweet is a reply, this field will contain the string representation of the original Tweet’s author ID. This will not necessarily always be the user directly mentioned in the Tweet. Example: "in_reply_to_user_id_str":"819797"
lang	String	Nullable. When present, indicates a BCP 47 language identifier corresponding to the machine-detected language of the Tweet text, or “`und`” if no language could be detected. Example: "lang": "en"
place	Places	Nullable. When present, indicates that the tweet is associated (but not necessarily originating from) a Place. Example: "place": { "attributes":{}, "bounding_box": { "coordinates": [[ [-77.119759,38.791645], [-76.909393,38.791645], [-76.909393,38.995548], [-77.119759,38.995548] ]], "type":"Polygon" }, "country":"United States", "country_code":"US", "full_name":"Washington, DC", "id":"01fbe706f872cb32", "name":"Washington", "place_type":"city", "url": "http://api.twitter.com/1/geo/id/01fbe706f872cb32.json" }
possibly_sensitive	Boolean	Nullable. This field only surfaces when a tweet contains a link. The meaning of the field doesn’t pertain to the tweet content itself, but instead it is an indicator that the URL contained in the tweet may contain content or media identified as sensitive content. Example: "possibly_sensitive":true
quoted_status_id	Int64	This field only surfaces when the Tweet is a quote Tweet. This field contains the integer value Tweet ID of the quoted Tweet. Example: "quoted_status_id":114749583439036416
quoted_status_id_str	String	This field only surfaces when the Tweet is a quote Tweet. This is the string representation Tweet ID of the quoted Tweet. Example: "quoted_status_id_str":"114749583439036416"
quoted_status	Tweet	This field only surfaces when the Tweet is a quote Tweet. This attribute contains the Tweet object of the original Tweet that was quoted.
scopes	Object	A set of key-value pairs indicating the intended contextual delivery of the containing Tweet. Currently used by Twitter’s Promoted Products. Example: "scopes":{"followers":false}
retweet_count	Int	Number of times this Tweet has been retweeted. This field is no longer capped at 99 and will not turn into a String for “100+” Example: "retweet_count":1585
retweeted	Boolean	Perspectival. Indicates whether this Tweet has been retweeted by the authenticating user. Example: "retweeted":false
retweeted_status	Tweet	Users can amplify the broadcast of tweets authored by other users by retweeting. Retweets can be distinguished from typical Tweets by the existence of a `retweeted_status` attribute. This attribute contains a representation of the original Tweet that was retweeted. Note that retweets of retweets do not show representations of the intermediary retweet, but only the original tweet. (Users can also unretweet a retweet they created by deleting their retweet.)
source	String	Utility used to post the Tweet, as an HTML-formatted string. Tweets from the Twitter website have a source value of `web`. Example: "source":"Twitter for Mac<\/a>"
text	String	The actual UTF-8 text of the status update. See twitter-text for details on what is currently considered valid characters. Example: "text":"Tweet Button, Follow Button, and Web Intents javascript now support SSL http:\/\/t.co\/9fbA0oYy ^TS"
truncated	Boolean	Indicates whether the value of the `text` parameter was truncated, for example, as a result of a retweet exceeding the 140 character Tweet length. Truncated text will end in ellipsis, like this `...` Since Twitter now rejects long Tweets vs truncating them, the large majority of Tweets will have this set to `false`. Note that while native retweets may have their toplevel `text` property shortened, the original text will be available under the `retweeted_status` object and the `truncated` parameter will be set to the value of the original status (in most cases, `false`). Example: "truncated":true
user	Users	The user who posted this Tweet. Perspectival attributes embedded within this object are unreliable. See Why are embedded objects stale or inaccurate?. Example: "user":{"statuses_count":3080, "favourites_count":22, "protected":false, "profile_text_color":"437792", "profile_image_url":"...", "name":"Twitter API", "profile_sidebar_fill_color":"a9d9f1", "listed_count":9252, "following":true, "profile_background_tile":false, "utc_offset":-28800, "description":"The Real Twitter API. I tweet about API changes, service issues and happily answer questions about Twitter and our API. Don't get an answer? It's on my website.", "location":"San Francisco, CA", "contributors_enabled":true, "verified":true, "profile_link_color":"0094C2", "followers_count":665829, "url":"http:\/\/dev.twitter.com", "default_profile":false, "profile_sidebar_border_color":"0094C2", "screen_name":"twitterapi", "default_profile_image":false, "notifications":false, "display_url":null, "show_all_inline_media":false, "geo_enabled":true, "profile_use_background_image":true, "friends_count":32, "id_str":"6253282", "entities":{"hashtags":[], "urls":[], "user_mentions":[]}, "expanded_url":null, "is_translator":false, "lang":"en", "time_zone":"Pacific Time (US & Canada)", "created_at":"Wed May 23 06:01:13 +0000 2007", "profile_background_color":"e8f2f7", "id":6253282, "follow_request_sent":false, "profile_background_image_url_https":"...", "profile_background_image_url":"...", "profile_image_url_https":"..."}
withheld_copyright	Boolean	When present and set to “true”, it indicates that this piece of content has been withheld due to a DMCA complaint. Example: "withheld_copyright": true
withheld_in_countries	Array of String	When present, indicates a list of uppercase two-letter country codes this content is withheld from. Twitter supports the following non-country values for this field: “XX” - Content is withheld in all countries “XY” - Content is withheld due to a DMCA request. Example: "withheld_in_countries": ["GR", "HK", "MY"]
withheld_scope	String	When present, indicates whether the content being withheld is the “status” or a “user.” Example: "withheld_scope": "status"

Contributors

ツイートに寄稿者がいない場合、 empty もしくは以下のようになります。

"contributors" : {}

このフィールドは、ユーザーのアカウント上に有効な寄稿者が登録されている場合にのみ表示されます。 — これは、まだ一般では全開放されていないベータ機能です。

フィールド	型	説明
id	Int64	このツイートを寄稿したユーザーのIDを表す数値。例: "id":819797
id_str	String	このツイートを寄稿したユーザーのIDを表す文字列。例: "id_str":"819797"
screen_name	String	このツイートを寄稿したユーザーのスクリーンネーム。例: "screen_name":"episod"

フィールド

型

説明

Int64

このツイートを寄稿したユーザーのIDを表す数値。

例:

"id":819797

id_str

String

このツイートを寄稿したユーザーのIDを表す文字列。

例:

"id_str":"819797"

screen_name

String

このツイートを寄稿したユーザーのスクリーンネーム。

例:

"screen_name":"episod"

Coordinates

フィールド	型	説明
coordinates	Float型の集まり	ツイート位置の経度と緯度を、[経度,緯度]の形式でまとめたもの。例: "coordinates":[-97.51087576,35.46500176]
type	String	座標プロパティのおいて、どういったデータ型にエンコードされたか。ツイートの座標フィールドの場合、データ型は “Point” になります。例: "type":"Point"

フィールド

型

説明

coordinates

Float型の集まり

ツイート位置の経度と緯度を、[経度,緯度]の形式でまとめたもの。

例:

"coordinates":[-97.51087576,35.46500176]

type

String

座標プロパティのおいて、どういったデータ型にエンコードされたか。ツイートの座標フィールドの場合、データ型は “Point” になります。

例:

"type":"Point"

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

Tweets

Tweets

フィールドの説明

Field Guide

Contributors

Contributors

Coordinates

Coordinates

注意事項

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

Tweets

Tweets

フィールドの説明

Field Guide

Contributors

Contributors

Coordinates

Coordinates

注意事項

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