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.

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.

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

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.

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

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

This project is initiated and maintained by @thomweerd.

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.