Initials Avatar API
Generate clean initials avatars (SVG) from any name: deterministic brand colors, circle, rounded or square, custom colors and sizes. Unicode names supported. Also returns a data URI.
Authentication & base URL
Subscribe through one of our marketplace listings; your marketplace API key and base URL are shown there. All endpoints return JSON over HTTPS, served from a global edge network (typically 20–150 ms).
Endpoints
GET /v1/avatar
Initials avatar
| Parameter | In | Description | Example |
|---|---|---|---|
name * | query | Person, team or company name | Jane Doe |
size | query | 16-1024 px (default 128) | 128 |
shape | query | circle (default), rounded or square | circle |
background | query | Hex color or auto (deterministic color from the name) | auto |
color | query | Text hex color or auto (best contrast) | auto |
length | query | Number of initials, 1-3 (default 2) | 2 |
initials | query | Force custom initials (max 3 characters) | |
bold | query | true/false (default true) | true |
font_size | query | Font scale 0.2-0.9 (default 0.42) | 0.42 |
format | query | svg (default, the image) or json (colors + SVG + data URI) | svg |
Example
GET /v1/avatar?name=Jane+Doe&format=json&size=128
{
"name": "Jane Doe",
"initials": "JD",
"background": "#2980b9",
"color": "#ffffff",
"shape": "circle",
"size": 128,
"svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"128\" height=\"128\" viewBox=\"0 0 128 128\" role=\"img\" aria-label=\"JD\"><rect width=\"128\" height=\"128\" rx=\"64\" ry=\"64\" fill=\"#2980b9\"/><text x=\"50%\" y=\"50%\" dy=\".35em\" text-anchor=\"middle\" fill=\"#ffffff\" font-family=\"-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif\" font-size=\"43\" font-weight=\"700\">JD</text></svg>",
"data_uri": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxMjgiIGhlaWdodD0iMTI4IiB2aWV3Qm94PSIwIDAgMTI4IDEyOCIgcm9sZT0iaW1nIiBhcmlhLWxhYmVsPSJKRCI+PHJlY3Qgd2lkdGg9IjEyOCIgaGVpZ2h0PSIxMjgiIHJ4PSI2NCIgcnk9IjY0IiBmaWxsPSIjMjk4MGI5Ii8+PHRleHQgeD0iNTAlIiB5PSI1MCUiIGR5PSIuMzVlbSIgdGV4dC1hbmNob3I9Im1pZGRsZSIgZmlsbD0iI2ZmZmZmZiIgZm9udC1mYW1pbHk9Ii1hcHBsZS1zeXN0ZW0sQmxpbmtNYWNTeXN0ZW1Gb250LCdTZWdvZSBVSScsUm9ib3RvLEhlbHZldGljYSxBcmlhbCxzYW5zLXNlcmlmIiBmb250LXNpemU9IjQzIiBmb250LXdlaWdodD0iNzAwIj5KRDwvdGV4dD48L3N2Zz4="
}Generate clean initials avatars (SVG) from any name: deterministic brand colors, circle, rounded or square, custom colors and sizes. Unicode names supported. Also returns a data URI.
Endpoint
- GET /v1/avatar?name=Jane Doe — returns the SVG image (use it directly in an <img> or save it).
- GET /v1/avatar?name=Jane Doe&format=json — initials, colors, SVG markup and a base64 data URI for emails or databases.
Why this API
- Same name → same color every time (deterministic), 20 accessible colors with automatic best-contrast text.
- Handles accents and any alphabet (José Álvarez → JÁ, Ørjan Ødegård → ØØ), single names, hyphens and extra spaces.
- Crisp at any size: vector SVG, from 16 to 1024 px; circle, rounded or square.
Use cases
Default profile pictures for new users, team and customer lists, comment threads, CRM contacts, chat apps, placeholders for missing company logos.
Pricing
Free plan 500 requests/month, Pro 25,000 for $4.99, Ultra 150,000 for $14.99.
Pricing
Free plan with 500 calls per month, then Pro (25,000 calls for $4.99/month) and Ultra (150,000 calls for $14.99/month). See all plans.