Get avatar from email
Resolve user avatars from an email address with a single URL. The API tries Gravatar, GitHub, Libravatar, BIMI in order — no API keys, no SDK.
<img src="https://unavatar.io/email/hello@microlink.io" />Email avatar resolution
When you pass an email as the path, unavatar detects the input and walks the email provider chain in order until one returns an avatar. You can also call a specific provider directly.
Automatic resolution
Pass the email as the only path segment. The API auto-detects and resolves through the chain.
unavatar.io/email/hello@microlink.io
Auto-detect: tries Gravatar → GitHub → Libravatar → BIMI
Explicit providers
Target a specific provider when you know where the avatar comes from.
unavatar works with 99+ platforms
Resolve avatars (and related images) from GitHub, X, Instagram, Spotify, and more with the same simple API.
- Apple Musicmusic.apple.com
- Apple Storeapps.apple.com
- Behancebehance.net
- Bilibilibilibili.com
- BIMIbimigroup.org
- Bitbucketbitbucket.org
- Blueskybsky.app
- Buy Me a Coffeebuymeacoffee.com
- Cash Appcash.app
- Chess.comchess.com
- Codeforcescodeforces.com
- CodePencodepen.io
- Cults3Dcults3d.com
- Cursorcursor.com
- Dailymotiondailymotion.com
- Deezerdeezer.com
- DEVdev.to
- DeviantArtdeviantart.com
- Discorddiscord.com
- Docker Hubhub.docker.com
- Dribbbledribbble.com
- DuckDuckGoduckduckgo.com
- Duolingoduolingo.com
- ENSens.domains
- Facebookfacebook.com
- Farcasterfarcaster.xyz
- Flickrflickr.com
- Giteegitee.com
- GitHubgithub.com
- GitLabgitlab.com
- Goodreadsgoodreads.com
- Googlegoogle.com
- Google Playplay.google.com
- Gravatargravatar.com
- Gumroadgumroad.com
- Hevyhevy.com
- Hugging Facehuggingface.co
- Instagraminstagram.com
- Juejinjuejin.cn
- Kagglekaggle.com
- Keybasekeybase.io
- Kickkick.com
- Ko-fiko-fi.com
- Lemmyjoin-lemmy.org
- Libravatarlibravatar.org
- LinkedInlinkedin.com
- Mastodonmastodon.social
- Matrixmatrix.org
- Mediummedium.com
- Microlinkmicrolink.io
- Minecraftminecraft.net
- Mixcloudmixcloud.com
- NetEase Musicmusic.163.com
- notenote.com
- npmnpmjs.com
- OnlyFansonlyfans.com
- Open Collectiveopencollective.com
- OpenStreetMapopenstreetmap.org
- osu!osu.ppy.sh
- Patreonpatreon.com
- PayPalpaypal.com
- Pinterestpinterest.com
- Primalprimal.net
- Printablesprintables.com
- Product Huntproducthunt.com
- PSN Profilespsnprofiles.com
- QQqq.com
- Raycastraycast.com
- Redditreddit.com
- Revolutrevolut.com
- Robloxroblox.com
- Sketchfabsketchfab.com
- Snapchatsnapchat.com
- SoundCloudsoundcloud.com
- Speedrun.comspeedrun.com
- Spotifyopen.spotify.com
- Stack Overflowstackoverflow.com
- Steamsteamcommunity.com
- Stravastrava.com
- Stripestripe.com
- Substacksubstack.com
- Telegramtelegram.com
- Thingiversethingiverse.com
- Threadsthreads.net
- Tidaltidal.com
- Tiebatieba.baidu.com
- TikToktiktok.com
- Tumblrtumblr.com
- Twitchtwitch.tv
- Venmovenmo.com
- Vimeovimeo.com
- Wattpadwattpad.com
- Weiboweibo.com
- WhatsAppwhatsapp.com
- Wisewise.com
- X/Twitterx.com
- Xbox Gamertagxboxgamertag.com
- YouTubeyoutube.com
- Zhihuzhihu.com
- New providerOpen GitHub issue
Track avatar API usage, top providers, and billing in one dashboard.
See request trends, platform mix, error rates, and billing insights in a single view so teams can move faster without guesswork.
View live demo
Performant and proven to handle scale, every day.
Fast responses backed by a global edge network you can count on.
Proudly serving companies from small to large every day.
Pricing, made simple
Pure pay-as-you-go. No minimums, no commitments — you only pay for what you use. Cached requests are served for free and don't count toward your usage.
Free tier includes 25 requests/day for unauthenticated traffic and 50 requests/day for authenticated (API key) traffic.
From developers to teams like you
See how teams use unavatar to power profile and account experiences.
“We replaced three different avatar services with a single unavatar call. Simpler code, fewer dependencies, better results.”
“The fallback chain is genius — we never show a broken avatar anymore. Our users noticed the difference immediately.”
“Integrated unavatar into our onboarding flow in 10 minutes. The API is exactly what you'd expect — no surprises, just works.”
How does email avatar resolution work?
Pass the email as the path: unavatar.io/user@example.com. The API detects the email and tries Gravatar first. If Gravatar has no result, it tries GitHub by matching the address against public profile data and commit history.
Can I target a specific provider for email lookups?
Yes. Use unavatar.io/gravatar/{email} or unavatar.io/github/{email} to skip auto-detection and query a provider directly.
What happens if no provider has an image for my email?
A default fallback image is returned. You can customize it with the ?fallback query parameter to match your app's design.
Is the email lookup API free?
Yes. The free tier allows 25 requests per day per IP with no API key, and 50 requests per day with an API key. Paid usage is metered with no minimums or subscriptions.
How is this different from using Gravatar directly?
Gravatar only resolves addresses registered on its platform. unavatar falls back to GitHub avatars when Gravatar has no result, and you can also resolve images by username or domain across 99+ providers with the same API.
How fast are email lookup responses?
Cached results are served from the edge in under 50ms. Fresh lookups typically resolve in under 300ms. All responses are cached on a global CDN.
Still have questions? Ask on GitHub
1,479 stars on GitHub
Proudly Open Sourcecrafted by Microlink.io
unavatar is free, open source, and community-driven. Inspect the code, open an issue, or contribute a new provider — everyone is welcome.