getavatar

Get unified user avatar (source code).

The service will determinate the user avatar querying multiple social providers and serve it to you.

It can obtain the user avatar based on the following input variations:

From username

<img src="https://getavatar.vercel.app/:username" />

e.g., https://getavatar.vercel.app/kikobeats

From email

<img src="https://getavatar.vercel.app/:email" />

e.g., https://getavatar.vercel.app/sindresorhus@gmail.com

From domain

<img src="https://getavatar.vercel.app/:domain" />

e.g., https://getavatar.vercel.app/reddit.com

Query Parameters

Fallback

In the cases that is not possible determinate the user avatar, unavatar provide one by default.

Customize it using fallback query parameter.

e.g., https://getavatar.vercel.app/daftpunk?fallback=https://i.imgur.com/0d1TFfQ.jpg

You can also pipe against other external service, like boringavatars.com.

e.g., https://getavatar.vercel.app/1337_user?fallback=https://source.boringavatars.com/marble/120/1337_user?colors=264653,2a9d8f,e9c46a,f4a261,e76f51

You can pass fallback=false for disabling it.

JSON

Alternatively you can get the avatar url adding the query parameter json.

e.g., https://getavatar.vercel.app/kikobeats?json

Providers

Each provider has its own endpoint, so you can query it directly.

Microlink

<img src="https://getavatar.vercel.app/microlink/:domain" />

e.g., https://getavatar.vercel.app/microlink/microlink.io

DeviantArt

<img src="https://getavatar.vercel.app/deviantart/:username" />

e.g., https://getavatar.vercel.app/deviantart/spyed

Dribbble

<img src="https://getavatar.vercel.app/dribbble/:username" />

e.g., https://getavatar.vercel.app/dribbble/omidnikrah

DuckDuckGo

<img src="https://getavatar.vercel.app/duckduckgo/:domain" />

e.g., https://getavatar.vercel.app/duckduckgo/gummibeer.dev

GitHub

<img src="https://getavatar.vercel.app/github/:username" />

e.g., https://getavatar.vercel.app/github/mdo

Google

<img src="https://getavatar.vercel.app/google/:domain" />

e.g., https://getavatar.vercel.app/google/netflix.com

Gravatar

<img src="https://getavatar.vercel.app/gravatar/:email" />

e.g., https://getavatar.vercel.app/gravatar/sindresorhus@gmail.com

Instagram

Pass your Microlink Pro plan as `x-api-key` header.

<img src="https://getavatar.vercel.app/instagram/:username" />

e.g., https://getavatar.vercel.app/instagram/willsmith

<img src="https://getavatar.vercel.app/reddit/:username" />

e.g., https://getavatar.vercel.app/reddit/kikobeats

SoundCloud

<img src="https://getavatar.vercel.app/soundcloud/:username" />

e.g., https://getavatar.vercel.app/soundcloud/gorillaz

Substack

<img src="https://getavatar.vercel.app/substack/:username" />

e.g., https://getavatar.vercel.app/substack/bankless

<img src="https://getavatar.vercel.app/telegram/:username" />

e.g., https://getavatar.vercel.app/telegram/drsdavidsoft

Twitter