Get avatar from YouTube
Resolve user avatars against youtube.com with a single URL. No API keys, no SDK — just unavatar.io/youtube/{input}.
<img src="https://unavatar.io/youtube/@Google" />YouTube API usage
Get any YouTube channel's thumbnail by their handle, legacy username, or channel ID.
e.g., unavatar.io/youtube/casey
The endpoint supports specific input formats.
If the input starts with UC and has 24 characters, it is treated as a channel ID. Otherwise, it is treated as a handle.
Available inputs:
username: unavatar.io/youtube/casey or unavatar.io/youtube/@caseychannel: unavatar.io/youtube/UC_x5XG1OV2P6uZZ5FSM9Ttw
From channel to avatar in one request
Build the URL with your YouTube channel, get the avatar. No API keys required for the free tier.
Build the URL
Use unavatar.io/youtube/ plus your channel.
Get the avatar
unavatar resolves the avatar from youtube.com.
<img src="https://unavatar.io/youtube/%40Google" />Cached & optimized
Resolved avatars are cached for up to 24 hours. Subsequent requests return instantly — no redundant upstream lookups.
One endpoint for YouTube avatars
Get YouTube profile pictures with a single URL. Cached at the edge, no SDK required.
unavatar.io/youtube/username
Returns the avatar image or a fallback
unavatar works with 25+ platforms
Resolve avatars from GitHub, X, Instagram, Spotify, and more with the same simple API.
used by popular sites
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.
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.
“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.”
“We serve 200K+ profiles daily and unavatar handles our avatar resolution without breaking a sweat. Rock-solid reliability.”
“Switched from building our own avatar pipeline to unavatar. Saved us weeks of maintenance and edge cases we didn't want to own.”
“The multi-provider resolution is a killer feature. One endpoint covers GitHub, Google, Gravatar, and everything else we need.”
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
3,300+ 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.