Skip to content
/ uinames Public
forked from thm/uinames

A simple tool to generate names for use in designs and mockups.

Notifications You must be signed in to change notification settings

iadawn/uinames

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 

Repository files navigation

uinames.com

This is the repo for uinames.com. Feel free to contribute to the project by adding names. Keep in mind that more isn't better. Quality over quantity. Quality being the most common/popular names in a country.

The Algorithm

When the option to pick a country at random is selected, a country will be picked based on the amount of possible name-combinations for that country. A country with more names is more likely to be picked, and countries with less names are less likely to be picked. I propose having a maximum of 100 male names, 100 female names and 300 last names per country. That's 60.000 possible combinations per country.

The Layout (JSON)

[
  {
    "country": "Country",
    "male": ["Male", "First", "Names"],
    "female": ["Female", "First", "Names"],
    "surnames": ["Last", "Names"]
  },
  {etc}
]

The API

All responses are returned as JSON, and there is no request limit. Please keep the amount of calls to a minimum though, and cache responses whenever possible.

Basic usage

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

Optional Parameters

The amount of names to return:

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

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

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

Country specific results:

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

Author

This project is initiated and maintained by @thomweerd.

Credit

This massive collection of names wouldn't have been as complete without the help of these wonderful people. Thanks for all the contributions and the continued support!

Special thanks go out to Claudio Albertin for his work on the API.

About

A simple tool to generate names for use in designs and mockups.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • PHP 44.5%
  • CSS 34.6%
  • JavaScript 20.9%