The universal avatar API forany platform
<img src="https://unavatar.io/github/username" />The ultimate avatar service that offers everything you need to easily retrieve user avatars in a single API.
Free, Forever, Enjoy!!!!!
Performant and proven to handle scale, every day.
Proudly serving companies from small to large every day.
Fast responses backed by a global edge network you can count on.
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 20+ 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 27+ providers, optimizes images on the fly, and delivers them from the edge. No SDK, no complexity.
27+ 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.001 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.
Is unavatar free to use?
Yes. The service is free for low-volume usage. Paid usage is metered — there are no minimums or subscriptions, you only pay for non-cached requests you actually make.
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 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.
Can I use it in production?
Absolutely. unavatar serves millions of requests per month with 99.6%+ uptime. Paid plans include an SLA guarantee and priority support.
Which providers are supported?
Over 20 providers including GitHub, X, Instagram, Gravatar, Google, Bluesky, Spotify, and more. You can also resolve by email or domain.
Still have questions? Ask on GitHub
1,403 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.