Info (Selected) API Shortcuts

About

uinames.com is a simple tool to generate fake names for use in designs and mockups. Made by Thom.

Elsewhere

Numerous blogs and websites have published about the project including Codrops, Speckyboy, Smashing Magazine, Sidebar, Webdesigner Depot, Product Hunt, LayerVault, Oozled and The Next Web.

Feedback

Feedback can be tweeted directly to @thomweerd.

Contribute

This massive collection of names wouldn’t have been as complete without the help of these wonderful people. If you would like to contribute to the project too, then send a pull-request on Github!

softwaretailoring +2 haziqmir +1 psahalot +1 zhaofengli +1 MizR +1 ClaudioAlbertin +3 haamop +1 jmblog +1 NabilAhami +1 juree +2 bensoybatuhan +1 kriskorn +1 DenisGiT +1 esquinas +1 HanimHank +1 Shafir +2 gfnool +2 rafaelstz +1 erikreagan +2 afnizarnur +1 nelsonschutt +1 peterhupuczi +2 kkelleey +1 seyekuyinu +1 jaimerodas +2 Stan347 +2 fireyy +1 eliorivero +1 StommePoes +3 andreascyp +1 mindwork +1 fkuenzli +1 sebastianlay +1 totocaster +1 knutsynstad +1 MHM5000 +2 ecez +1 getanwar +1 tranlamnhatnam +5 freefony +1 yosefw +1 PaulvdDool +1 gabrielizalo +2 thmsvhwgr +1 vedranio +1 texeltexel2009 +1 danielmorosan +1 rustamli +3 mityaustinov +1 glenbaku +1 edsadr +2 nvkzNemo +1

Check out uifaces.com as well!

Overview

All responses are returned as JSON(P) over HTTP(S). There is currently no request limit. However, please keep the amount of requests to a minimum, and cache responses whenever possible.

Basic Usage

https://uinames.com/api/
---
{
  "name": "John",
  "surname": "Doe",
  "gender": "male",
  "region": "United States"
}

Optional Parameters

Number of names to return, between 1 and 500:

https://uinames.com/api/?amount=25

Limit results to the male or female gender:

https://uinames.com/api/?gender=female

Region-specific results:

https://uinames.com/api/?region=germany

Require a minimum number of characters in a name:

https://uinames.com/api/?minlen=25

Require a maximum number of characters in a name:

https://uinames.com/api/?maxlen=75

For JSONP, specify a callback function to wrap results in:

https://uinames.com/api/?callback=example

Extended Usage

Additional randomized personal data is served if the ext parameter is detected. Photos offered are from the authorized section on uifaces.com:

https://uinames.com/api/?ext
---
{
  "name": "John",
  "surname": "Doe",
  "gender": "male",
  "region": "United States",
  "age": 29,
  "title": "mr",
  "phone": "(123) 456 7890",
  "birthday": {
    "dmy": "19/06/1987", // day, month, year
    "mdy": "06/19/1987", // month, day, year
    "raw": 551062610 // UNIX timestamp
  },
  "email": "john.doe@example.com",
  "password": "Doe87(!",
  "credit_card": {
    "expiration": "12/20",
    "number": "1234-5678-1234-5678",
    "pin": 1234,
    "security": 123
  },
  "photo": "https://uinames.com/api/photos/male/1.jpg"
}

Exception Handling

Error messages have the following format:

{"error":"Region or language not found"}

Names

Spacebar to generate a new name

C to highlight the current name

Options

1 to set the gender to random

2 to set the gender to male

3 to set the gender to female

5 switch bulk-mode on or off

Panels

4 to change the region

0 to view the info panel

Esc to close the current panel

Search regions 50/50