avatarsapi.com/github/torvalds

Put a username, email address, or domain in the URL. The response is image bytes for an <img src>. avatarapi checks the image before serving it. Misses return typed errors.

36 live Lookups from production. Click the center image to advance.
01

Try it

uses the production API
avatarsapi.com//
GET /github/Fyko
resolving…
JSON metadata for this URL: ?json
Pick a Source and enter a Handle. Misses return a typed envelope such as ENOTFOUND.
Resolved avatar
response body used directly by an <img>
02

Lookup routes

/:source/:handle

Look up one Handle from a named Source.

/twitch/theprimeagen
/email/:address

Checks Gravatar and GitHub together, then BIMI. The first Hit wins.

/email/jane@stripe.com
/domain/:domain

Checks BIMI first, then DuckDuckGo and Google favicons.

/domain/anthropic.com
/:handle

Infers email or domain from the Handle’s shape. A bare username returns EAMBIGUOUS; name a Source.

/anthropic.com
/p/:key/…

Use a project’s key to run Lookups on its plan.

docs →
Plus ?json for the metadata envelope, ?size=16–1000, and ?ttl=1h–28d. Full reference →
03

Sources

72 sources from GET /sources · every logo below is served by avatarapi
72 / 72 shown
01
/apple-music/
02
/apple-store/
03
/behance/
04
/bilibili/
05
/bimi/
06
/bluesky/
07
/buymeacoffee/
08
/cashapp/
09
/codepen/
10
/cults3d/
11
/cursor/
12
/deezer/
13
/deviantart/
14
/discord/
15
/dockerhub/
16
/dribbble/
17
/duckduckgo/
18
/facebook/
19
/flickr/
20
/gitee/
21
/github/
22
/gitlab/
23
/google/
24
/google-play/
25
/gravatar/
26
/hevy/
27
/huggingface/
28
/instagram/
29
/juejin/
30
/ko-fi/
31
/linkedin/
32
/mastodon/
33
/medium/
34
/netease-music/
35
/npm/
36
/onlyfans/
37
/openstreetmap/
38
/patreon/
39
/paypal/
40
/pinterest/
41
/primal/
42
/printables/
43
/producthunt/
44
/psnprofiles/
45
/qq/
46
/raycast/
47
/reddit/
48
/revolut/
49
/snapchat/
50
/soundcloud/
51
/spotify/
52
/stackoverflow/
53
/steam/
54
/strava/
55
/substack/
56
/telegram/
57
/thingiverse/
58
/threads/
59
/tidal/
60
/tieba/
61
/tiktok/
62
/tumblr/
63
/twitch/
64
/venmo/
65
/vimeo/
66
/weibo/
67
/whatsapp/
68
/wise/
69
/x/
70
/xboxgamertag/
71
/youtube/
72
/zhihu/
Some Sources require a type:value Handle, including /spotify/artist:0OdU… and /linkedin/company:anthropic. The current list is GET /sources. Handle formats and examples for each platform →
04

Pricing

anonymous
$0 · no signup or key
  • 50 fresh Lookups / day per IP
  • Every supported Source
  • Cached images do not count toward the limit
  • For trying it out. Attribution required
Use the URL. No account needed.
free project
$0 / project / month
  • Your own pk_ key, safe to use in the browser
  • 1,000 fresh Lookups / day per project
  • Default 7-day cache lifetime
  • Attribution required
Create a Project ↗
starter
$19 / project / month
  • Managed Fallback: never a broken image
  • No daily or per-minute limit
  • Custom ?ttl cache lifetime
  • No attribution required
  • 5,000 unique avatar identities included each month
Upgrade a Project ↗
Cached images never count. Attribution means a visible “Avatars by avatarsapi.com” link where the images appear. Each project is billed separately, and upgrading keeps your existing key and image URLs. There are no overage charges. Current limits →

Use the URL as your image source

<img src="https://avatarsapi.com/github/you">
Read the docsCreate a Project ↗