API Docs


Before using the API make sure you read the docs.


If you are new around here, first get an API key.




Parameter Usage Example Description
X-API-KEY 'X-API-KEY: [YOUR-API-KEY]' Add your API key via the HTTP headers

Parameter Usage Example Description
limit ?limit=10 Number of avatars (30 max per call, default is 10)
gender[] ?gender[]=male Filter by gender: male or female
from_age ?from_age=18 Set minimum age
to_age ?to_age=40 Set maximum age
hairColor[] ?hairColor[]=blond Filter by hair color
emotion[] ?emotion[]=happiness Filter by emotion
popular ?popular Premium Order avatars by popularity
offset ?offset=10 Premium Skip number of avatars from the result
license ?license=CC0 Premium Coming soon
random ?random Deprecated (results are random by default)

fetch('https://uifaces.co/api', {
	method: 'GET',
	headers: {
	  'X-API-KEY': [YOUR-API-KEY],
	  'Accept': 'application/json',
	  'Cache-Control': 'no-cache'
	}
})

curl 
	--header Cache-Control: no-cache 
	--header Accept: application/json 
	--header X-API-KEY: [YOUR-API-KEY] 
	https://uifaces.co/api

{ "error" : "Maximum allowed number of results exceeded." }


Try it Here


[
    {
        "name": "D\u00c3\u00a9bora Edelberg",
        "email": "d\u00c3\u00a9bora.edelberg@gmail.com",
        "position": "Attorney",
        "photo": "https:\/\/pbs.twimg.com\/profile_images\/641632366683914240\/UZ0VIIh3.png"
    },
    {
        "name": "Gugu Mbatha-Raw",
        "email": "gugu.mbatha-raw@gmail.com",
        "position": "Product Designer",
        "photo": "https:\/\/images-na.ssl-images-amazon.com\/images\/M\/MV5BMTUxMjM1MzgxMl5BMl5BanBnXkFtZTcwNDI0NDE5NQ@@._V1_UY256_CR4,0,172,256_AL_.jpg"
    },
    {
        "name": "Yaakov Kenney",
        "email": "yaakov.kenney@gmail.com",
        "position": "Director",
        "photo": "https:\/\/images.generated.photos\/EWV-zLc5-iWQ8pMTKLsTd3L5TNCafscujeCIYmEMkuQ\/rs:fit:512:512\/Z3M6Ly9nZW5lcmF0\/ZWQtcGhvdG9zL3Yy\/XzA4MjExMjUuanBn.jpg"
    },
    {
        "name": "Jessica Barden",
        "email": "jessica.barden@gmail.com",
        "position": "Clerical",
        "photo": "https:\/\/images-na.ssl-images-amazon.com\/images\/M\/MV5BNzUwMjgxNTMyOF5BMl5BanBnXkFtZTcwMTIwNzU0NA@@._V1_UX172_CR0,0,172,256_AL_.jpg"
    },
    {
        "name": "Yousif Cross",
        "email": "yousif.cross@gmail.com",
        "position": "Clerical",
        "photo": "https:\/\/images.generated.photos\/ww3Ht-Tf6Zh17fJYFQEJeNWcqwUMhVlAVykzQH0Uu90\/rs:fit:512:512\/Z3M6Ly9nZW5lcmF0\/ZWQtcGhvdG9zL3Yy\/XzAwMDIzOTYuanBn.jpg"
    }
]