# avatarapi

> avatarapi returns a profile picture for a username on a named platform, an email address, or a domain. The URL is the whole API: https://avatarsapi.com/:source/:handle answers with image bytes for an <img src>.

No key or signup is needed for the anonymous tier. A Project adds a browser-safe `pk_` key and paid Plans. Misses and failures return a JSON envelope with a stable `code`.

## Docs

- [API reference](https://avatarsapi.com/docs.md): routes, query parameters, envelopes, error codes, caching, and Plans
- [OpenAPI description](https://avatarsapi.com/openapi.json): machine-readable description of the HTTP surface
- [Source catalogue](https://avatarsapi.com/sources): JSON list of every Source and the Ladder each Handle kind walks
- [Agent skill](https://avatarsapi.com/.well-known/agent-skills/avatarsapi/SKILL.md): how an agent should build avatar URLs

## Blog

- [DiceBear vs UI Avatars vs Boring Avatars: generated avatar APIs compared](https://avatarsapi.com/blog/avatar-placeholder-generators.md): Generated avatars never fail, but they're never the real person. A comparison of DiceBear, UI Avatars, Boring Avatars, and Vercel's avatar service, and how to pair them with a real lookup.
- [Showing customer avatars in a CRM or support inbox](https://avatarsapi.com/blog/avatars-in-crm-support-inbox.md): Turn a list of email addresses into faces and company logos: what to look up, how to handle privacy, and how to keep it fast.
- [Bluesky avatar API: getting a profile picture from a handle](https://avatarsapi.com/blog/bluesky-avatar-api.md): Bluesky's public AppView API returns avatars without authentication. Here's how to call it, and when a plain image URL is simpler.
- [Clearbit Logo API alternatives after the shutdown](https://avatarsapi.com/blog/clearbit-logo-api-alternative.md): The free Clearbit Logo API (logo.clearbit.com) shut down in December 2025. Here are the replacements for getting a company logo from a domain, and how they compare.
- [Company logo from an email domain: BIMI explained](https://avatarsapi.com/blog/company-logo-from-email-domain-bimi.md): BIMI lets a company publish its official logo in DNS. Here's how the record works, how to read it, and how to use it to show a logo for any work email.
- [Favicon APIs: Google, DuckDuckGo, and what to use in production](https://avatarsapi.com/blog/favicon-api.md): How google.com/s2/favicons and icons.duckduckgo.com work, why they're risky in a product, and how to get a higher-quality logo for any domain.
- [How to get an X (Twitter) profile picture by username](https://avatarsapi.com/blog/get-x-twitter-profile-picture.md): Three ways to show someone's X profile picture from their @handle: the official API, scraping pbs.twimg.com, or a one-line image URL.
- [GitHub avatar URL: every way to get a user's profile picture](https://avatarsapi.com/blog/github-avatar-url.md): github.com/username.png, avatars.githubusercontent.com, the REST API, and what each does when the user doesn't exist.
- [Gravatar alternatives in 2026](https://avatarsapi.com/blog/gravatar-alternatives.md): Gravatar only knows people who signed up for it. Here are the alternatives for getting a profile picture from an email address, and when each one fits.
- [How to get an Instagram profile picture by username](https://avatarsapi.com/blog/instagram-profile-picture-by-username.md): Instagram's Basic Display API is gone, the Graph API only covers business accounts, and scraping from cloud IPs gets rate-limited. Here's what actually works in 2026.
- [A React and Next.js avatar component with a real fallback](https://avatarsapi.com/blog/react-nextjs-avatar-component.md): Build an <Avatar> that shows a user's real picture from a username, email, or domain, and falls back to initials when there isn't one.
- [avatarapi vs unavatar: comparing avatar-by-username APIs](https://avatarsapi.com/blog/unavatar-alternative.md): A side-by-side look at avatarapi and unavatar.io, the two APIs that return a profile picture from a username, email, or domain in one URL.
- [How to get a YouTube channel avatar from a handle](https://avatarsapi.com/blog/youtube-channel-avatar.md): Two ways to show a YouTube channel's profile picture from its @handle: the YouTube Data API's channels.list, or a single image URL.

## Platforms

- [App Store app icon API](https://avatarsapi.com/platforms/apple-store.md): `/apple-store/<handle>`
- [Apple Music artist, album, or song artwork API](https://avatarsapi.com/platforms/apple-music.md): `/apple-music/<handle>`
- [Baidu Tieba profile picture API](https://avatarsapi.com/platforms/tieba.md): `/tieba/<handle>`
- [Behance profile picture API](https://avatarsapi.com/platforms/behance.md): `/behance/<handle>`
- [Bilibili profile picture API](https://avatarsapi.com/platforms/bilibili.md): `/bilibili/<handle>`
- [Bluesky profile picture API](https://avatarsapi.com/platforms/bluesky.md): `/bluesky/<handle>`
- [Buy Me a Coffee profile picture API](https://avatarsapi.com/platforms/buymeacoffee.md): `/buymeacoffee/<handle>` (currently failing)
- [Cash App profile picture API](https://avatarsapi.com/platforms/cashapp.md): `/cashapp/<handle>` (currently failing)
- [CodePen profile picture API](https://avatarsapi.com/platforms/codepen.md): `/codepen/<handle>` (currently failing)
- [Cults profile picture API](https://avatarsapi.com/platforms/cults3d.md): `/cults3d/<handle>` (currently failing)
- [Cursor profile picture API](https://avatarsapi.com/platforms/cursor.md): `/cursor/<handle>` (currently failing)
- [Deezer artist, album, or playlist artwork API](https://avatarsapi.com/platforms/deezer.md): `/deezer/<handle>`
- [DeviantArt profile picture API](https://avatarsapi.com/platforms/deviantart.md): `/deviantart/<handle>`
- [Discord server icon API](https://avatarsapi.com/platforms/discord.md): `/discord/<handle>`
- [Docker Hub profile picture API](https://avatarsapi.com/platforms/dockerhub.md): `/dockerhub/<handle>` (currently failing)
- [Dribbble profile picture API](https://avatarsapi.com/platforms/dribbble.md): `/dribbble/<handle>`
- [Facebook profile picture API](https://avatarsapi.com/platforms/facebook.md): `/facebook/<handle>` (currently failing)
- [Flickr profile picture API](https://avatarsapi.com/platforms/flickr.md): `/flickr/<handle>`
- [Gitee profile picture API](https://avatarsapi.com/platforms/gitee.md): `/gitee/<handle>` (currently failing)
- [GitHub profile picture API](https://avatarsapi.com/platforms/github.md): `/github/<handle>`
- [GitLab profile picture API](https://avatarsapi.com/platforms/gitlab.md): `/gitlab/<handle>`
- [Google Play app or developer icon API](https://avatarsapi.com/platforms/google-play.md): `/google-play/<handle>`
- [Gravatar profile picture API](https://avatarsapi.com/platforms/gravatar.md): `/gravatar/<handle>`
- [Hevy profile picture API](https://avatarsapi.com/platforms/hevy.md): `/hevy/<handle>`
- [Hugging Face profile picture API](https://avatarsapi.com/platforms/huggingface.md): `/huggingface/<handle>`
- [Instagram profile picture API](https://avatarsapi.com/platforms/instagram.md): `/instagram/<handle>` (currently failing)
- [Juejin profile picture API](https://avatarsapi.com/platforms/juejin.md): `/juejin/<handle>`
- [Ko-fi profile picture API](https://avatarsapi.com/platforms/ko-fi.md): `/ko-fi/<handle>` (currently failing)
- [LinkedIn profile picture or company logo API](https://avatarsapi.com/platforms/linkedin.md): `/linkedin/<handle>` (currently failing)
- [Mastodon profile picture API](https://avatarsapi.com/platforms/mastodon.md): `/mastodon/<handle>`
- [Medium profile picture API](https://avatarsapi.com/platforms/medium.md): `/medium/<handle>` (currently failing)
- [NetEase Cloud Music profile picture API](https://avatarsapi.com/platforms/netease-music.md): `/netease-music/<handle>`
- [npm profile picture API](https://avatarsapi.com/platforms/npm.md): `/npm/<handle>`
- [OpenStreetMap profile picture API](https://avatarsapi.com/platforms/openstreetmap.md): `/openstreetmap/<handle>`
- [Patreon profile picture API](https://avatarsapi.com/platforms/patreon.md): `/patreon/<handle>`
- [PayPal profile picture API](https://avatarsapi.com/platforms/paypal.md): `/paypal/<handle>` (currently failing)
- [Pinterest profile picture API](https://avatarsapi.com/platforms/pinterest.md): `/pinterest/<handle>`
- [Primal profile picture API](https://avatarsapi.com/platforms/primal.md): `/primal/<handle>`
- [Printables profile picture API](https://avatarsapi.com/platforms/printables.md): `/printables/<handle>` (currently failing)
- [Product Hunt profile picture or product logo API](https://avatarsapi.com/platforms/producthunt.md): `/producthunt/<handle>` (currently failing)
- [PSNProfiles PlayStation avatar API](https://avatarsapi.com/platforms/psnprofiles.md): `/psnprofiles/<handle>` (currently failing)
- [Raycast profile picture API](https://avatarsapi.com/platforms/raycast.md): `/raycast/<handle>` (currently failing)
- [Reddit profile picture API](https://avatarsapi.com/platforms/reddit.md): `/reddit/<handle>` (currently failing)
- [Revolut profile picture API](https://avatarsapi.com/platforms/revolut.md): `/revolut/<handle>` (currently failing)
- [Snapchat profile picture or Bitmoji API](https://avatarsapi.com/platforms/snapchat.md): `/snapchat/<handle>` (currently failing)
- [SoundCloud profile picture API](https://avatarsapi.com/platforms/soundcloud.md): `/soundcloud/<handle>`
- [Spotify profile picture or artwork API](https://avatarsapi.com/platforms/spotify.md): `/spotify/<handle>` (currently failing)
- [Stack Overflow profile picture API](https://avatarsapi.com/platforms/stackoverflow.md): `/stackoverflow/<handle>`
- [Steam profile picture API](https://avatarsapi.com/platforms/steam.md): `/steam/<handle>`
- [Strava profile picture API](https://avatarsapi.com/platforms/strava.md): `/strava/<handle>` (currently failing)
- [Substack profile picture API](https://avatarsapi.com/platforms/substack.md): `/substack/<handle>` (currently failing)
- [Telegram profile picture API](https://avatarsapi.com/platforms/telegram.md): `/telegram/<handle>`
- [Thingiverse profile picture API](https://avatarsapi.com/platforms/thingiverse.md): `/thingiverse/<handle>` (currently failing)
- [Threads profile picture API](https://avatarsapi.com/platforms/threads.md): `/threads/<handle>` (currently failing)
- [TIDAL artist, album, or playlist artwork API](https://avatarsapi.com/platforms/tidal.md): `/tidal/<handle>`
- [TikTok profile picture API](https://avatarsapi.com/platforms/tiktok.md): `/tiktok/<handle>`
- [Tumblr profile picture API](https://avatarsapi.com/platforms/tumblr.md): `/tumblr/<handle>` (currently failing)
- [Twitch profile picture API](https://avatarsapi.com/platforms/twitch.md): `/twitch/<handle>`
- [Venmo profile picture API](https://avatarsapi.com/platforms/venmo.md): `/venmo/<handle>`
- [Vimeo profile picture API](https://avatarsapi.com/platforms/vimeo.md): `/vimeo/<handle>` (currently failing)
- [Weibo profile picture API](https://avatarsapi.com/platforms/weibo.md): `/weibo/<handle>` (currently failing)
- [WhatsApp profile picture or channel icon API](https://avatarsapi.com/platforms/whatsapp.md): `/whatsapp/<handle>`
- [Wise profile picture API](https://avatarsapi.com/platforms/wise.md): `/wise/<handle>` (currently failing)
- [X (Twitter) profile picture API](https://avatarsapi.com/platforms/x.md): `/x/<handle>`
- [Xbox gamerpic API](https://avatarsapi.com/platforms/xboxgamertag.md): `/xboxgamertag/<handle>` (currently failing)
- [YouTube channel avatar API](https://avatarsapi.com/platforms/youtube.md): `/youtube/<handle>`
- [Zhihu profile picture API](https://avatarsapi.com/platforms/zhihu.md): `/zhihu/<handle>`

## Optional

- [Landing page](https://avatarsapi.com/index.md): overview, examples, and pricing
- [Dashboard](https://app.avatarsapi.com): create Projects and keys