Free avatar API for any ID
Pass a username, email, or UUID. Get a PNG back. Same ID always gets the
same face. No signup, no API key. A simple default avatar service you can drop into any
<img> tag.
https://api.genavatar.me/{id}
That URL is the whole integration. Free to use in production.
How the avatar API works
genavatar.me is a free PNG avatar API. Anything after the slash becomes the seed. The same string always maps to the same face, so defaults stay stable for comments, chat, admin lists, and prototypes without storing images.
Skip the path for a random avatar on each request. Unicode and emoji IDs are supported. No SDK, no headers, no auth.
https://api.genavatar.me/[email protected]
https://api.genavatar.me/
<img src="https://api.genavatar.me/{userId}" alt="">
FAQ
How do I use the avatar API?
Put https://api.genavatar.me/{id} in an <img> src.
Replace {id} with any string such as a username, email, or UUID. No API key
or signup.
Is the same ID always the same avatar?
Yes. The same string always produces the same PNG face, so user profiles stay consistent across sessions and devices.
How do I get a random avatar?
Request https://api.genavatar.me/ with no path. Each request returns a new
random face.
Is genavatar.me free?
Yes. Free to use with no accounts, no API keys, and no paid tier required for basic use.
What can I use as an avatar ID?
Any string works as the path seed: usernames, emails, UUIDs, Unicode, and emoji. The path after the slash is hashed to pick the face.
Generate one
Hit the button, or open the URL in a new tab.
https://api.genavatar.me/