Randomly generated profiles of users from different countries

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 methods are POST or GET.

Post Fields

Field name
(* for required)

The format in which you want the results to be returned. We currently support these options:

  • xml
  • csv
  • json

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:
  • CHN
  • GBR
  • JPN
  • KOR
packages A list of package IDs separates by comma. The following packages are currently available:
  • General (name, address, phone, date of birth etc.)
  • Financial (bank account, credit card details, income etc.)
  • Physical (height, weight, clothes size etc.)

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);
    echo $response;