Generate placeholder avatars for your apps. 100+ built-in avatars, custom themes, shapes, and SVG generation. Zero dependencies.
/random
Returns a random avatar every time
Type a name and customize your avatar in real-time
Everything you need for avatar placeholders
Pre-made avatar collection for quick placeholders. Boy, girl, and job-specific avatars.
Ocean, forest, fire, sky, sunset, purple, mint, and coral. Instant color theming.
Circle, rounded corners, or square. Match your design system.
Generate SVG avatars from any name. No image files needed.
Get multiple avatar URLs in one request. Perfect for galleries.
Cache headers and ETag support. Optimized for production.
PNG, JPG, and WebP output. WebP for best compression.
Filter avatars by gender, job, or custom tags.
Download with custom filename. Batch download support.
Integrate in seconds with our REST API
/public/:id
Get avatar by ID (1-100)
/public/boy
/public/girl
Get random male/female avatar
/username?username=John+Doe
Generate SVG avatar from name
/api/avatars?ids=1,5,25
Batch get multiple avatars
/api/tags
List all available tags
<img src="http://localhost:3000/public/42" alt="Avatar">
curl "http://localhost:3000/username?username=John+Doe&theme=ocean"
const avatar = await fetch('/api/avatars?ids=1,5,25');
const data = await avatar.json();
<img src="/username?username=JD&size=128&shape=circle" />
Add avatar placeholders to your project instantly
<!-- Add avatar image -->
<img src="https://your-api.com/public/42" alt="User Avatar">
<!-- Or generate from name -->
<img src="https://your-api.com/username?username=John+Doe&theme=ocean" alt="Avatar">