The universal avatar APIfor any platform
<img src="https://unavatar.io/github/username" />Get avatars from 36+ providers by username, email, or domain. One URL you can embed anywhere — no SDK, no setup.
Free, Forever, Enjoy!!!!!
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.
From username to avatar in one request
No API keys required for the free tier. No complex setup. Just build a URL and get the avatar — it works with any HTTP client, framework, or language.
Build the URL
Construct a simple URL with the provider and username. No SDK, no dependencies — just a URL.
Get the avatar
unavatar resolves the avatar from 36+ providers with automatic fallbacks. If one source fails, it tries the next.
<img src="https://unavatar.io/github/kikobeats" />Cached & optimized
Resolved avatars are cached for up to 24 hours. Subsequent requests return instantly — no redundant upstream lookups.
Everything you need, nothing you don't
One endpoint that resolves avatars from 36+ providers, optimizes images on the fly, and delivers them from the edge. No SDK, no complexity.
36+ providers
Query by username, email, or domain. GitHub, X, Instagram, Spotify, TikTok, Gravatar — one API rules them all.
Fast & optimized
Cached across 200+ edge nodes. Images compressed on the fly for optimal size and quality. Under 50ms worldwide.
Custom TTL
Control cache freshness from 1 hour to 28 days. Avatars stay fresh on your schedule with the ?ttl parameter.
Custom fallbacks
Never show a broken avatar. Return a custom image, a generated placeholder, a base64 pixel, or fallback=false for a clean 404.
JSON or image
Get the image directly in an <img> tag, or pass ?json for a structured JSON payload with status, data, and error codes.
Typed inputs
Query with artist:, track:, channel: and more. Spotify, Apple Music, YouTube, and WhatsApp all support typed lookups.
Free to start
No registration, no API key required. 50 requests per day for free — just start using it.
Smart proxies
Automatic routing through origin, datacenter, or residential proxies. Maximum reliability, transparent cost per tier.
No SDK needed
Just an <img> tag. No client library, no build step, no dependencies. Works in any language, any framework, any platform.
Transparent pricing
$0.005 per token. Every response header tells you exactly what it cost, which proxy tier was used, and how much quota remains.
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.
What is an avatar API?
An avatar API is a service that retrieves user avatars programmatically. Instead of integrating with each social platform individually, an avatar API like unavatar lets you fetch avatars from GitHub, X, Instagram, Gravatar, and 36+ other providers through a single HTTP endpoint.
Is unavatar free to use?
Yes. The avatar API is free for low-volume usage with 50 requests per day. Paid usage is metered — there are no minimums or subscriptions, you only pay for non-cached requests you actually make.
How do I get an avatar from an email address?
Simply make a GET request to unavatar.io/[email protected] and the API will resolve the avatar from Gravatar, Google, and other email-based providers automatically. No API key is needed for the free tier.
Do I need an API key?
Not for the free tier. Once you sign up for a paid plan, you get an API key that removes rate limits and unlocks extra features like custom TTL.
What happens if an avatar can't be found?
A default fallback image is returned automatically. You can customize it by passing a fallback URL as a query parameter to match your app's style.
How fast are avatar API responses?
Cached avatars are served from the edge in under 50ms worldwide. Fresh lookups depend on the upstream provider but are typically resolved in under 300ms. All responses are cached on a global CDN.
Can I use this avatar API in production?
Absolutely. unavatar serves millions of requests per month with 99.6%+ uptime. Paid plans include an SLA guarantee and priority support.
Which avatar providers are supported?
Over 36 providers including GitHub, X (Twitter), Instagram, Gravatar, Google, Bluesky, Spotify, LinkedIn, YouTube, Telegram, and more. You can also resolve avatars by email address or domain name.
How is unavatar different from Gravatar?
Gravatar only works with email addresses registered on its platform. unavatar is a universal avatar API that checks 36+ providers including Gravatar, so you get much higher coverage. If Gravatar has no result, unavatar automatically tries GitHub, Google, and other sources.
Still have questions? Ask on GitHub
1,417 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.