Generate Random Fake Names

About

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

Elsewhere

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

Contribute

Contribute to the project through Github! This collection of names would not have been as complete without these wonderful people:

haziqmir +1 Stan347 +2 yosefw +1 psahalot +1 vedranio +1 totocaster +1 zhaofengli +1 VasilSlavchev +2 fkuenzli +1 HanimHank +1 jaimerodas +2 rustamli +3 gabrielizalo +2 andreascyp +1 banditelol +1 rlpereira +2 VedranaR +3 IslaMurtazaev +1 navanchauhan +1 sebastianlay +1 ClaudioAlbertin +3 rafaelstz +1 seyekuyinu +1 kkelleey +1 eliorivero +1 tranlamnhatnam +5 ameensom +1 tjotala +1 anton-liubushkin +1 haamop +1 PaulvdDool +1 Shafir +2 jmblog +1 edsadr +2 thmsvhwgr +1 djhvscf +1 bensoy +1 fireyy +1 erikreagan +2 texeltexel2009 +1 esquinas +1 gfnool +2 knutsynstad +1 danielmorosan +1 ecez +1 peterhupuczi +2 abdennour +1 glenbaku +1 NabilAhami +1 freefony +1 sskrebkov +1 softwaretailoring +2 mityaustinov +1 nelsonschutt +1 getanwar +1 juree +2 DenisGiT +1 StommePoes +3 MizR +1 MHM5000 +2

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

Extra Data

Additional random data is served to requests passing an ext parameter. However, response times may be slower, especially when requesting larger quantities of data.

All photos are hand-picked from Unsplash (license):

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

document.write(action)