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

Require a minimum number of characters in a name:

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

Require a maximum number of characters in a name:

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

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.

zhaofengli / uinames