unavatar

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://unavatar.io/:username" />

e.g., https://unavatar.io/kikobeats

From email

<img src="https://unavatar.io/:email" />

e.g., https://unavatar.io/[email protected]

From domain

<img src="https://unavatar.io/:domain" />

e.g., https://unavatar.io/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://unavatar.io/daftpunk?fallback=https://i.imgur.com/0d1TFfQ.jpg

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

e.g., https://unavatar.io/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://unavatar.io/kikobeats?json

Providers

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

Microlink

<img src="https://unavatar.io/microlink/:domain" />

e.g., https://unavatar.io/microlink/microlink.io

DeviantArt

<img src="https://unavatar.io/deviantart/:username" />

e.g., https://unavatar.io/deviantart/spyed

Dribbble

<img src="https://unavatar.io/dribbble/:username" />

e.g., https://unavatar.io/dribbble/omidnikrah

DuckDuckGo

<img src="https://unavatar.io/duckduckgo/:domain" />

e.g., https://unavatar.io/duckduckgo/gummibeer.dev

GitHub

<img src="https://unavatar.io/github/:username" />

e.g., https://unavatar.io/github/mdo

Gravatar

<img src="https://unavatar.io/gravatar/:email" />

e.g., https://unavatar.io/gravatar/[email protected]

Instagram

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

<img src="https://unavatar.io/instagram/:username" />

e.g., https://unavatar.io/instagram/willsmith

Reddit

<img src="https://unavatar.io/reddit/:username" />

e.g., https://unavatar.io/reddit/kikobeats

SoundCloud

<img src="https://unavatar.io/soundcloud/:username" />

e.g., https://unavatar.io/soundcloud/gorillaz

Substack

<img src="https://unavatar.io/substack/:username" />

e.g., https://unavatar.io/substack/bankless

Telegram

<img src="https://unavatar.io/telegram/:username" />

e.g., https://unavatar.io/telegram/drsdavidsoft

Twitter

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

<img src="https://unavatar.io/twitter/:username" />

e.g., https://unavatar.io/twitter/kikobeats

YouTube

<img src="https://unavatar.io/youtube/:username" />

e.g., https://unavatar.io/youtube/caseyneistat