Chute

Avatars.io

Every app needs avatars, we make it hassle-free

hosted user avatar service for your apps and sites

Avatar Services

Social Avatars

Twitter
  • http://avatars.io/twitter/:id
  • http://avatars.io/twitter/:username
Facebook
  • http://avatars.io/facebook/:id
  • http://avatars.io/facebook/:username
Instagram
  • http://avatars.io/instagram/:id
  • http://avatars.io/instagram/:username

Gravatars

Hash
  • http://avatars.io/gravatar/:hash
Email
  • http://avatars.io/email/:email_address

Transitioning from Gravatar

Avatars.io makes it easy to seamlessly transition from using Gravatar. Replace all references to http://gravatar.com/avatar/HASH in your code with http://avatars.io/gravatar/HASH.

Avatar Sizing

Supported Sizes

Avatars.io supports 3 sizes for avatars. We are mapping to the actual service, so there's no “guaranteed” size. Here's how that looks:

Service Default Small Medium Large
Upload 50x50 50x50 100x100 150x150
Facebook 50x50 50x50 100w 200w
Twitter 48x48 48x48 128x128 128x128
Instagram 150x150 150x150 150x150 150x150

Requesting Different Sizes

Different asset sizes are implemented as pseudo-extensions for the file itself. If no extension is provided, a default will be served (the smallest size). Here's what the URL looks like:

Syntax
  • http://avatars.io/:user_id/:shortcut?size=:size
Example
  • http://avatars.io/7ac66c0f148de9519b8bd264312c4d64/abcdefg?size=medium

Custom Avatars

Avatars.io lets your users upload their own avatars, in case you don't want to use one from a specific service.

Uploading Avatars

  1. Enter your email and password to get started:
  2. We'll email your authorization tokens.
  3. Setup request headers as follows
  4. POST following JSON in body to http://avatars.io/v1/token (prepares for upload)
  5. Parse the JSON response (sample below)
  6. PUT file to response.data.upload_info.upload_url if upload_info is provided
  7. POST to http://avatars.io/v1/token/:id/complete where :id is response.data.id
  8. Store the returned data

Custom Avatar URLs

Custom Identifiers let you map your own local identifier to the assigned avatar. For example, you may want to use your app's User ID instead of our automatically generated shortcut.

Syntax
  • http://avatars.io/:user_id/:identifier
Example
  • http://avatars.io/12345/custom-id

Libraries

We've prepared a number of components to help you get started with Avatars.io

iOS
Avatar Picker Component for you iOS apps
https://github.com/chute/avatars-io-ios
Android
Avatar Picker Component for your Android apps + Tutorial
https://github.com/chute/avatars-io-android
Ruby
Ruby gem for use of Avatars.io
https://github.com/chute/avatars-io-ruby
Node.js
Node.js package for use of Avatars.io
https://github.com/chute/avatars-io-node
PHP
PHP library for use of Avatars.io
http://github.com/jjaffeux/avatars-io-php (contributed by jjaffeux)
Python
Python library for use of Avatars.io
https://github.com/Zopieux/avatars-io-python (contributed by Zopieux)
JavaScript
JavaScript library to upload avatars in browsers
https://github.com/chute/avatars-io-js

View All on Github

Roadmap, Beta and More

Avatars.io is currently in beta and completely free to use during this period. There will ALWAYS be a free version for everyone to use.

In the future, we will offer some premium options for larger apps. if you'd like more info, please email us at hello@getchute.com.

Start Now!

Getting started is super simple. Just add your email and we'll send you details.

We'll email your authorization tokens.