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.
The UTC datetime that the user account was created on Twitter.
When true, indicates that the user has not altered the theme or background of their user
When true, indicates that the user has not uploaded their own avatar and a default egg avatar
is used instead.
Nullable. The user-defined UTF-8 string describing their account.
Nullable. The logged in user email address if available. Must have permission to access email
Entities which have been parsed out of the url or description fields defined by the user.
Read more about User Entities.
The number of tweets this user has favorited in the account's lifetime. British spelling used
in the field name for historical reasons.
Nullable. Perspectival. When true, indicates that the authenticating user has issued a follow
request to this protected user account.
The number of followers this account currently has. Under certain conditions of duress, this
field will temporarily indicate "0."
The number of users this account is following (AKA their "followings"). Under certain
conditions of duress, this field will temporarily indicate "0."
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.
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
The string representation of the unique identifier for this User. Implementations should use
this rather than the large, possibly un-consumable integer in id
When true, indicates that the user is a participant in Twitter's translator community.
The BCP 47 code for the user's self-declared user interface language. May or may not have
anything to do with the content of their Tweets.
The number of public lists that this user is a member of.
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.
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.
The hexadecimal color chosen by the user for their background.
A HTTP-based URL pointing to the background image the user has uploaded for their profile.
A HTTPS-based URL pointing to the background image the user has uploaded for their profile.
When true, indicates that the user's profile_background_image_url should be tiled when
The HTTPS-based URL pointing to the standard web representation of the user's uploaded
profile banner. By adding a final path element of the URL, you can obtain different image
sizes optimized for specific displays. In the future, an API method will be provided to serve
these URLs so that you need not modify the original URL. For size variations, please see
User Profile Images and Banners.
A HTTP-based URL pointing to the user's avatar image. See User Profile Images and Banners.
A HTTPS-based URL pointing to the user's avatar image.
The hexadecimal color the user has chosen to display links with in their Twitter UI.
The hexadecimal color the user has chosen to display sidebar borders with in their Twitter
The hexadecimal color the user has chosen to display sidebar backgrounds with in their
The hexadecimal color the user has chosen to display text with in their Twitter UI.
When true, indicates the user wants their uploaded background image to be used.
When true, indicates that this user has chosen to protect their Tweets. See About Public and
The screen name, handle, or alias that this user identifies themselves with. 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.
Indicates that the user would like to see media inline. Somewhat disused.
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?.
The number of tweets (including retweets) issued by the user.
Nullable. A string describing the Time Zone this user declares themselves within.
Nullable. A URL provided by the user in association with their profile.
Nullable. The offset from GMT/UTC in seconds.
When true, indicates that the user has a verified account. See Verified Accounts.
When present, indicates a textual representation of the two-letter country codes this user is
When present, indicates whether the content being withheld is the "status" or a "user."