Get server icons from Discord
Resolve server icons against discord.com with a single URL. No API keys, no SDK — just unavatar.io/discord/{input}.
<img src="https://unavatar.io/discord/server-name" />When to use the Discord server icon API
This page is built for developers comparing ways to resolve Discord server icons by server name or server ID. It explains what makes this provider useful, what kind of inputs it supports, and when you may want to call this provider directly instead of relying on a broader fallback chain.
Get a Discord server's icon by server name or server ID.
Useful when you need a stable Discord server icon URL in apps, docs, demos, or account directories.
Works with a straightforward URL pattern so you can integrate it without an SDK or custom client.
Discord API usage
Get a Discord server's icon by server name or server ID.
Good fits for Discord lookups
Rendering guild or server tiles in Discord pickers, moderation tools, and community directories.
Showing the live server icon after someone pastes an invite or server ID without calling the Discord API yourself.
Pairing member avatars with accurate server branding in activity feeds and audit logs.
Get server icons from Discord in one request
Build a URL with the Discord endpoint and your input, then fetch the image. No API keys required for the free tier.
Build the URL
Start from unavatar.io/discord/ and add the input that provider expects.
Fetch the image
unavatar fetches the image from discord.com.
<img src="https://unavatar.io/discord/lilnasx" />Cached & optimized
Responses are cached for up to 24 hours. Subsequent requests return instantly — no redundant upstream lookups.
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
- 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 do I get a Discord server icon?
Make a GET request to unavatar.io/discord/{server name or server ID}. The API returns the image directly — no SDK or API tokens required.
Is the Discord 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. For higher volume, paid usage is metered with no minimums or subscriptions.
What if my Discord server icon lookup returns nothing?
A default fallback image is returned automatically. You can pass a custom fallback URL as a query parameter: ?fallback=https://your-fallback.com/image.png.
Can I resolve images from other providers besides Discord?
Yes. unavatar supports 99+ providers including GitHub, X, Instagram, Gravatar, Spotify, and more. Every provider uses the same unavatar.io/{provider}/{key} pattern.
How fast are responses?
Cached responses are served from the edge in under 50ms. Fresh lookups depend on the upstream provider but typically resolve in under 300ms. All responses are cached on a global CDN.
Can I use this in production?
Absolutely. unavatar serves millions of requests per month with 99.6%+ uptime. Paid plans include an SLA guarantee and priority support.
Still have questions? Ask on GitHub
1,481 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.