Read more guidance in the Document.
Generate random user profile pictures to use as placeholders for your prototypes and design projects. To use the avatars in your project, use the following URLs:
https://avatar.iran.liara.run/public
https://avatar.iran.liara.run/public/boy
https://avatar.iran.liara.run/public/girl
View the ID of the avatars: All avatars
https://avatar.iran.liara.run/public/[ID]
example: ID=60
https://avatar.iran.liara.run/public?usearname=[value]
example: usearname=Jordan
https://avatar.iran.liara.run/public/boy?usearname=[value]
example: usearname=Scott
https://avatar.iran.liara.run/public/girl?username=[value]
example: username=Angela
Soccer avatars are isolated from boy/girl/id/job endpoints and are only available via the routes below.
https://avatar.iran.liara.run/public/soccer
View the list of players: GET /api/soccer
https://avatar.iran.liara.run/public/soccer/[ID]
example: ID=6 (Lionel Messi)
https://avatar.iran.liara.run/api/soccer
Returns { players: [{ id, name, tier, file, url }, ...] } for 50 players (tiers 20 / 35 / 50 / 75 / 100).
Avatars initials, also known as profile pictures with initials, are typically the first letters of a user's name displayed within an avatar icon the ability to change the background color, text color, size, etc (view all options).
https://avatar.iran.liara.run/username?username=[firstname+lastname]
example: username=Scott Wilson
Add a decorative prestige ring around any avatar with the optional ring query parameter. Works on all avatar endpoints (public id/boy/girl/soccer/job and username initials). Use a ring slug or id (1–8). Invalid values are ignored and the plain avatar is returned.
Rings are composited from professional PNG overlays (gear, crystal, wings, fire, soccer, energy, royal).
https://avatar.iran.liara.run/public/60?ring=gold
https://avatar.iran.liara.run/public/boy?ring=3
https://avatar.iran.liara.run/public/soccer/1?ring=soccer
https://avatar.iran.liara.run/username?username=Scott+Wilson&ring=royal
https://avatar.iran.liara.run/api/rings
Returns { rings: [{ id, slug, name }, ...] }:
| ID | Slug | Name |
|---|---|---|
| 1 | bronze | Bronze Gear |
| 2 | silver | Silver Crystal |
| 3 | gold | Gold Wings |
| 4 | fire | Fire |
| 5 | soccer | Soccer Neon |
| 6 | soccer-trail | Soccer Trail |
| 7 | energy | Energy Orbit |
| 8 | royal | Royal Crown |
When a ring is applied, the response is always PNG.
your support ensures our API’s long and happy life. Devs and businesses relying on it will thank you. Thanks for being part of our digital adventure! 😊