logo Document Avatars About
support API
  1. Random avatar
  2. Avatar image based on gender
    • Random male avatar
    • Random female avatar
  3. Avatar image based on username
    • Male avatar image based on username
    • Female avatar image based on username
  4. Unique avatar image
  5. Job avatar image
  6. Avatars with initials from names

Avatar Placeholder Api

Copy the links below and paste them into the src tag of your web image:

<img src="https://avatar.iran.liara.run/public" />

Random Avatar

get a random profile picture

Random Avatar
https://avatar.iran.liara.run/public

Avatar image based on gender

Get a random Male avatar

(View all male avatars)
Get a random Male avatar
https://avatar.iran.liara.run/public/boy

Get a random Female avatar

(View all female avatars)
Get a random Female avatar
https://avatar.iran.liara.run/public/girl

Avatar image based on username

Just add query param username=[value] to the end of the previous URLs:

Get a unique male avatar

https://avatar.iran.liara.run/public/boy?username=[value]

Get a unique female avatar

https://avatar.iran.liara.run/public/girl?username=[value]
Example:

Unique avatar for ''Scott''

Unique avatar for ''Scott''
https://avatar.iran.liara.run/public/boy?username=Scott

Unique avatar for ''Maria''

Unique avatar for ''Maria''
https://avatar.iran.liara.run/public/girl?username=Maria

Unique avatar image

Get a unique avatar by ID

(View ID of all avatars)
Get a unique avatar by ID
https://avatar.iran.liara.run/public/[ID]

Job avatar image

Add the values [job title] and [gender] to the URLs:

https://avatar.iran.liara.run/public/job/[job title]/[gender]
Example:

Male doctor avatar

(View all job avatar images)
Male doctor avatar
https://avatar.iran.liara.run/public/job/doctor/male

Female Police avatar

(View all job avatar images)
Female Police avatar
https://avatar.iran.liara.run/public/job/police/female

Avatars With Initials From Names

https://avatar.iran.liara.run/username?username=[firstname+lastname]
Example:

Avatar for ''Scott Wilson''

Avatar for ''Scott Wilson''
https://avatar.iran.liara.run/username?username=Scott+Wilson
More API options
Quick Access
  • Document
  • Avatars
  • About
  • Support API
Avatar images
  • Male avatar images
  • Female avatar images
  • Job avatar images
  • Avatars With Initials From Names
Contact Us
mhshariatipour[AT]gmail.com
Our code is open source and available on GitHub. Star to show your support!
+200
stars
+20
forks
Support API
Avatar-Placeholder v2.4 © 2025
Made with ❤️ by developers for developers