レスポンス フィールド

Tweets

フィールド 型 説明
annotations Object Unused. Future/beta home for status annotations.
contributors 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.
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).
created_at String UTC time when this Tweet was created.
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.
entities Entities Entities which have been parsed out of the text of the Tweet. Additionally see Tweet Entities.
favorited Boolean Nullable. Perspectival. Indicates whether this Tweet has been favorited by the authenticating user.
geo Coordinates Deprecated. Nullable. Use the "coordinates" field instead. Discussion
id Int64※1 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.
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.
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.
in_reply_to_status_id Int64※1 Nullable. If the represented Tweet is a reply, this field will contain the integer representation of the original Tweet's ID.
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.
in_reply_to_user_id Int64※1 Nullable. If the represented Tweet is a reply, this field will contain the integer representation of the original Tweet's author ID.
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.
place Places Nullable. When present, indicates that the tweet is associated (but not necessarily originating from) a Place.
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.
scopes Object A set of key-value pairs indicating the intended contextual delivery of the containing Tweet. Currently used by Twitter's Promoted Products.
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+"
retweeted Boolean Perspectival. Indicates whether this Tweet has been retweeted by the authenticating user.
source String この投稿を行ったアプリケーションへのリンク。HTMLフォーマットされた文字列で、

"source":"\u003Ca href=\"http:\/\/itunes.apple.com\/us\/app\/twitter\/id409789998?mt=12\" rel=\"nofollow\"\u003ETwitter for Mac\u003C\/a\u003E"

の形式。Twitterのページからの投稿は"web"の文字列だけとなる。
text String The actual UTF-8 text of the status update. See twitter-text for details on what is currently considered valid characters.
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 ...
user Users このツイートを投稿したユーザー。Perspectival attributes embedded within this object are unreliable. See Why are embedded objects stale or inaccurate?.
withheld_copyright Boolean When present and set to "true", it indicates that this piece of content has been withheld due to a DMCA complaint.
withheld_in_countries String When present, indicates a textual representation of the two-letter country codes this content is withheld from. See New Withheld Content Fields in API Responses.
withheld_scope String When present, indicates whether the content being withheld is the "status" or a "user." See New Withheld Content Fields in API Responses.
Tweets | Twitter Developers

※1 ツイートなどのIDは64bitで表現されるため、JavaScriptなどのプログラミング言語では正しく処理できません。よってそのような場合には、id_strなどの文字列を代わりに使用する必要があります。

Contributors

"contributors":
[
    {
        "id":819797,
        "id_str":"819797",
        "screen_name":"episod"
    }
]

Coordinates

"coordinates":
{
    "coordinates":
    [
        -75.14310264,
        40.05701649
    ],
    "type":"Point"
}

Users

フィールド 型 説明
contributors_enabled Boolean Indicates that the user has an account with "contributor mode" enabled, allowing for Tweets issued by the user to be co-authored by another account. Rarely true.
created_at String The UTC datetime that the user account was created on Twitter.
default_profile Boolean When true, indicates that the user has not altered the theme or background of their user profile.
default_profile_image Boolean When true, indicates that the user has not uploaded their own avatar and a default egg avatar is used instead.
description String Nullable. The user-defined UTF-8 string describing their account.
entities Entities Entities which have been parsed out of the url or description fields defined by the user. Read more about User Entities.
favourites_count Int The number of tweets this user has favorited in the account's lifetime. British spelling used in the field name for historical reasons.
follow_request_sent Type Nullable. Perspectival. When true, indicates that the authenticating user has issued a follow request to this protected user account.
following Type Nullable. Perspectival. Deprecated. When true, indicates that the authenticating user is following this user. Some false negatives are possible when set to "false," but these false negatives are increasingly being represented as "null" instead. See Discussion.
followers_count Int The number of followers this account currently has. Under certain conditions of duress, this field will temporarily indicate "0."
friends_count Int The number of users this account is following (AKA their "followings"). Under certain conditions of duress, this field will temporarily indicate "0."
geo_enabled Boolean When true, indicates that the user has enabled the possibility of geotagging their Tweets. This field must be true for the current user to attach geographic data when using POST statuses/update.
id Int64 The integer representation of the unique identifier for this User. 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.
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.
is_translator Boolean When true, indicates that the user is a participant in Twitter's translator community.
lang String The ISO 639-1 two-letter character code for the user's self-declared user interface language. May or may not have anything to do with the content of their Tweets.
listed_count Int The number of public lists that this user is a member of.
location String Nullable. The user-defined location for this account's profile. Not necessarily a location nor parseable. This field will occasionally be fuzzily interpreted by the Search service.
name String The name of the user, as they've defined it. Not necessarily a person's name. Typically capped at 20 characters, but subject to change.
notifications Boolean Nullable. Deprecated. May incorrectly report "false" at times. Indicates whether the authenticated user has chosen to receive this user's tweets by SMS. Discussion
profile_background_color String The hexadecimal color chosen by the user for their background.
profile_background
_image_url		 String A HTTP-based URL pointing to the background image the user has uploaded for their profile.
profile_background_
image_url_https		 String A HTTPS-based URL pointing to the background image the user has uploaded for their profile.
profile_background_tile Boolean When true, indicates that the user's profile_background_image_url should be tiled when displayed.
profile_image_url String A HTTP-based URL pointing to the user's avatar image. See User Profile Images and Avatars.
profile_image_url_https String A HTTPS-based URL pointing to the user's avatar image.
profile_link_color String The hexadecimal color the user has chosen to display links with in their Twitter UI.
profile_sidebar_border_color String The hexadecimal color the user has chosen to display sidebar borders with in their Twitter UI.
profile_sidebar_fill_color String The hexadecimal color the user has chosen to display sidebar backgrounds with in their Twitter UI.
profile_text_color String The hexadecimal color the user has chosen to display text with in their Twitter UI.
profile_use_background_image Boolean When true, indicates the user wants their uploaded background image to be used.
protected Boolean When true, indicates that this user has chosen to protect their Tweets. See About Public and Protected Tweets.
screen_name String ユーザーの表示名、ハンドルネーム、つまりユーザーを識別するための別名。screen_names are unique but subject to change. Use id_str as a user identifier whenever possible. Typically a maximum of 15 characters long, but some historical accounts may exist with longer names.
show_all_inline_media Boolean Indicates that the user would like to see media inline. Somewhat disused.
status Tweets Nullable. If possible, the user's most recent tweet or retweet. In some circumstances, this data cannot be provided and this field will be omitted, null, or empty. Perspectival attributes within tweets embedded within users cannot always be relied upon. See Why are embedded objects stale or inaccurate?.
statuses_count Int The number of tweets (including retweets) issued by the user.
time_zone String Nullable. A string describing the Time Zone this user declares themselves within.
url String Nullable. A URL provided by the user in association with their profile.
utc_offset Int Nullable. The offset from GMT/UTC in seconds.
verified Boolean When true, indicates that the user has a verified account. See Verified Accounts.
withheld_in_countries String When present, indicates a textual representation of the two-letter country codes this user is withheld from. See New Withheld Content Fields in API Responses.
withheld_scope String When present, indicates whether the content being withheld is the "status" or a "user." See New Withheld Content Fields in API Responses.
Users | Twitter Developers

ユーザーのページへは、このscreen_nameフィールドを使い、

https://twitter.com/screen_name

のURLでアクセスできます。

Entities

フィールド 型 説明
hashtags Array of Object Represents hashtags which have been parsed out of the Tweet text.
media Array of Object Represents media elements uploaded with the Tweet.
urls Array of Object Represents URLs included in the text of the Tweet.
user_mentions Array of Object Represents other Twitter users mentioned in the text of the Tweet.

Hashtags

Media

フィールド 型 説明
display_url String クライアントに表示するファイルのURL
expanded_url String display_urlの転送先であり、メディアを閲覧するTwitterのページのURL
id Int64 ID of the media expressed as a 64-bit integer.
id_str String ID of the media expressed as a string.
indices Array of Int An array of integers indicating the offsets within the Tweet text where the URL begins and ends. The first integer represents the location of the first character of the URL in the Tweet text. The second integer represents the location of the first non-URL character occurring after the URL (or the end of the string if the URL is the last part of the Tweet text).
media_url String アップロードされたファイルを直接示すURL (HTTP接続)
media_url_https String アップロードされたファイルを直接示すURL (HTTPS接続)
sizes Object An object showing available sizes for the media file.
type String Type of uploaded media.
url String ファイルへのリンクをラップしたURL。これはTweetのテキストに含まれるものと同一であり、indicesプロパティが示す値はこのURLのもの。

Sizes

URL

フィールド 取得例
url "http://t.co/WvZyVY14"
expanded_url "http://www.youtube.com/watch?v=W6tB8Lf7YoU"
display_url "youtube.com/watch?v=W6tB8L…"
indices [30, 50]

User Mention

フィールド 説明
id ユーザーID
id_str ユーザーID (文字列)
name ユーザー名
screen_name ユーザーの表示名
Entities | Twitter Developers

Places

Places | Twitter Developers

参考