joshsweaney / randomuser.me-data

Data that the randomuser generator uses

Randomuser.me Data

About

Our goal is to have a very diverse database that consists of data unique to different nationalities. While some places might have an SSN or their phone number might be formatted a certain way, other places usually follow a completely different set of rules.

Help us make the Random User Generator better by contributing to our database and teaching us the proper way of formatting data for different nationalities.

Guidelines

If you would like to help contribute data specific to a region, please keep these few rules in mind:

1. Please keep all of the data organized.

   • Keep US data in the US directory, AU in the AU directory, etc.

2. No duplicates. Make sure that the data you are adding isn't already on the list.

   • An easy way to remove duplicates from your file and sort:

sort -u <file> -o <file>

3. Please don't submit requests that say "make this nationality". We will accept helpful contributions, but not orders :)

What if I want to add a new nationality?

Go ahead! We will gladly accept new regions if they follow the guidelines above. Just place your files in a new directory with the appropriate 2 letter ISO Country Code (http://countrycode.org). And don't worry abut the version number...we'll handle that stuff.

So how do I contribute?

Randomuser.me is powered by our other service, RandomAPI. Please register for free here and follow the tutorial/documentation in order to make your own API. If you need any help, feel free to email us: support [at] randomapi.com

If you'd like an example to follow, you can copy the US/0.6 API to your RandomAPI account by clicking search from the homepage and searching for "US/0.6". You can then view the lists in the list manager and the API source code from the API manager.

Once you have crafted your beautiful API, go to the API manager, click the green download arrow, and select "Simple Export". This will download a zip file containing your API source code along with the lists' contents that it references. Copy theseli files into the region folder that it belongs to and send us a pull request!

If you have any questions, feel free to ask us on our Twitter page @randomapi or send us an email: support [at] randomapi.com