In options menu

Random region selected
Donate BTC

Support Development

Keeping this site running smoothly roughly costs me $100/year and several weekends of work. Consider donating some BTC if you find this site useful! 😃

141yZvVAmrvkWff5Vh2kVnJ47rRc5mZViC
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

Message @thomweerd if you have feedback.

Contribute

Contribute to the project through Github! This collection of names wouldn’t have been as complete without the help of these wonderful people:

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

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. As larger amounts of data require more bandwidth and processing power, please use this functionality sparingly.

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

Consider donating some BTC if you find this site useful! 😃 141yZvVAmrvkWff5Vh2kVnJ47rRc5mZViC
54/54