Info API Shortcuts

About

uinames.com is a simple tool to generate 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, CSS Author, 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!

thm+136 tranlamnhatnam+5 ClaudioAlbertin+3 rustamli+3 jaimerodas+2 gabrielizalo+2 softwaretailoring+2 erikreagan+2 juree+2 MHM5000+2 Shafir+2 edsadr+2 gfnool+2 peterhupuczi+2 HanimHank+1 nvkzNemo+1 getanwar+1 texeltexel2009+1 bensoy+1 DenisGiT+1 haamop+1 eliorivero+1 esquinas+1 fkuenzli+1 flamekaizar+1 haziqmir+1 knutsynstad+1 kriskorn+1 mityaustinov+1 PaulvdDool+1 psahalot+1 rafaelstz+1 sebastianlay+1 seyekuyinu+1 mindwork+1 thmsvhwgr+1 totocaster+1 ThatBaldUXGuy+1 yosefw+1 jmblog+1 zhaofengli+1 amghar+1 andreascyp+1 danielmorosan+1 ecez+1 fireyy+1 glenbaku+1 nelsonschutt+1 MizR+1

Other

Check out uifaces.com as well!

Overview

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

Usage

Basic usage:

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

Optional Parameters

The amount of names to return (1-500):

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

The gender of names to return (male or female):

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

Region-specific results:

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

Require a minimum number of characters in a name:

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

Require a maximum number of characters in a name:

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

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

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

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

Panels

4 to change the region

5 or 0 to view the info panel

Esc to close the current panel

48

Regions

1.157.946

Available Names