Skip to main content

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.

unavatar.io/email/
Avatar preview
Avatar preview (back)
<img src="https://unavatar.io/email/hello@microlink.io" />
How it works

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

More providers

unavatar works with 99+ platforms

Resolve avatars (and related images) from GitHub, X, Instagram, Spotify, and more with the same simple API.

Built for scale

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
Unavatar dashboard showing usage charts, token consumption, top providers, and billing overview.
Dashboard preview with API requests, platform split, and transfer metrics.
Last 30 days235.8MAvatars resolved

Performant and proven to handle scale, every day.

No less than67%CDN cache ratio

Fast responses backed by a global edge network you can count on.

Last 30 days2 TBData served

Proudly serving companies from small to large every day.

Simple transparent pricing

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.

1,000 reqs/moestimated cost$10/mo
1K10K100K1M
Get startedNo subscription. Billed monthly based on usage.
99+ providers
Edge-cached responses
API key access
Custom fallbacks
Custom TTL
JSON & image formats
Priority support
SLA guarantee

Free tier includes 25 requests/day for unauthenticated traffic and 50 requests/day for authenticated (API key) traffic.

Trusted by developers

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.”
Carlos Hernández
Carlos HernándezPrincipal Engineer at Plato
“The fallback chain is genius — we never show a broken avatar anymore. Our users noticed the difference immediately.”
Germán Rodríguez
Germán RodríguezFull Stack Engineer at Plain Concepts
“Integrated unavatar into our onboarding flow in 10 minutes. The API is exactly what you'd expect — no surprises, just works.”
Joseba Legarreta
Joseba LegarretaProduct Lead at Microlink
Frequently Asked Questions

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

kikobeatsbencrokerDRSDavidSoftwesbosBobface

1,479 stars on GitHub

Proudly Open Source
crafted 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.