We offer a free API for database and website developers, as well as anyone who wants to test their application or a project with a realistic user profile.
On each call the API generates two random user profiles from the countries you choose. These profiles are perfect for testing a database in a project such as a dating website, social network, forum or professional network. The API is free and ideal for testing a small-scale application. If you need many randomly generated names and addresses, starting from 10,000 records, please see our prepaid packages available for download in one file.
See the details of the API below.
The endpoint URL is:
The method is POST.
|Field name(* for required)||Description|
The format in which you want the results to be returned. We currently support these options:
xml is chosen by default
|countries *||A list of ISO 3 codes separated by a comma. Example: CHN,JPN. We currently support the following country codes:
|packages||A list of package IDs separates by comma. The following packages are currently available:
By default the General package is selected.
|fromAge||The minimum age in years for a profile. From 0 to 100. The default value is 0.|
|toAge||The maximum age in years for a profile. From 0 to 100. The default value is 100.|
1 or 0
This is a flag that determines whether profiles with age under 18 years old can be assigned an occupation other than "Child" and bank details, such as randomly generated bank account number or credit card number.
Testing the API
Here is a sample PHP code for testing the API
$post = "countries=CHN,JPN&fromAge=20&toAge=40&format=xml&fullChildren=1";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'http://randomprofile.com/api/api.php');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, Array("Content-Type: application/x-www-form-urlencoded"));
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
$response = curl_exec($ch);