User Profile Images and Banners
Profile images¶
Profile images (also known as avatars) are an important component of a Twitter account’s expression of identity. To upload a profile image on behalf of a user, use POST account / update_profile_image.
Alternative image sizes for user profile images¶
Obtain a user’s most recent profile image, along with the other components comprising their identity on Twitter, from GET users/show. The user object contains the profile_image_url
and profile_image_url_https
fields. These fields will contain the resized “normal” variant of the user’s uploaded image. This “normal” variant is typically 48px by 48px.
By modifying the URL, it is possible to retrieve other variant sizings such as “bigger”, “mini”, and “original”. Consult the table below for more examples:
Variant | Dimensions | Example URL |
normal | 48x48 | http://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png https://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png |
bigger | 73x73 | http://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_bigger.png https://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_bigger.png |
mini | 24x24 | http://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_mini.png https://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_mini.png |
original | original | http://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3.png https://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3.png Omit the underscore and variant to retrieve the original image. The images can be very large. |
Default profile images¶
Some users may not have uploaded a profile image. Users who have not uploaded a profile image can be identified by the default_profile_image
field of their user object having a true
value.
The profile_image_url
and profile_image_url_https
URLs provided for users in this case will indicate Twitter’s default profile photo, which is https://abs.twimg.com/sticky/default_profile_images/default_profile_normal.png.
The table above can be used to determine how to retrieve different size variants of the default image.
Outdated profile images¶
If a 403 or 404 error is returned when trying to access a profile image, refresh the user object using GET users/show to retrieve the most recent profile_image_url
or profile_image_url_https
. The URL may have changed, which happens for instance when the user updates their profile image.
Profile banners¶
Profile banners allow users to further customize the expressiveness of their profiles. To upload a profile banner on behalf of a user, use POST account / update_profile_banner.
Profile banners come in a variety of display-enhanced sizes. The variant sizes are available through a request to GET users / profile_banner or by modifying the final path component of the profile_banner_url
found in a user object according to the table below.
The profile banner data available at each size variant’s URL is in PNG format.
The following sizes are available:
Dimensions |
Example URL |
1500x500 | https://pbs.twimg.com/profile_banners/6253282/1431474710/1500x500 |
600x200 | https://pbs.twimg.com/profile_banners/6253282/1431474710/600x200 |
300x100 | https://pbs.twimg.com/profile_banners/6253282/1431474710/300x100 |
The following sizes are available for the certain screen types:
Screen Type | Dimensions |
Example URL |
web | 520x260 | https://pbs.twimg.com/profile_banners/6253282/1431474710/web |
web_retina | 1040x520 | https://pbs.twimg.com/profile_banners/6253282/1431474710/web_retina |
ipad | 626x313 | https://pbs.twimg.com/profile_banners/6253282/1431474710/ipad |
ipad_retina | 1252x626 | https://pbs.twimg.com/profile_banners/6253282/1431474710/ipad_retina |
mobile | 320x160 | https://pbs.twimg.com/profile_banners/6253282/1431474710/mobile |
mobile_retina | 640x320 | https://pbs.twimg.com/profile_banners/6253282/1431474710/mobile_retina |