Random Person Generator API

Our free API generates random fictional person data in JSON format. It's perfect for developers, testers, and content creators needing sample data for various projects.


API Documentation

This comprehensive guide explains how to use the API to fetch random person profiles based on your specified parameters. If no parameters are set, the API uses default settings to generate the data.

Base URL

https://random-person-generator.com/api

Parameters

Here are the parameters you can include in your API request. If no values are specified, defaults are used (shown in italics).

Parameter Default Value Options Description
preset personal-details personal-details, persona Specify the type of data returned.
country random List of 54 countries e.g., us, gr, it, de, etc. Chooses a country to localize the data or selects randomly if unspecified.
gender random m, f Specify 'm' (male) or 'f' (female), or leave random.

Example Request

GET /api?preset=personal-details&country=us&gender=m

Example Response

The response will be in JSON format, containing detailed information about the generated person, adhering to the set or default parameters:

{
  "profile_photo": {
    "256x256": "https://random-person-generator.com/storage/images/profile_photos/v2/256x256/johndoe256.jpg",
    "512x512": "https://random-person-generator.com/storage/images/profile_photos/v2/512x512/johndoe512.jpg"
  },
  "identification": {
    "full_name": "John Doe",
    "date_of_birth": "05/15/1980",
    "age": 43,
    "gender": "Male",
    "nationality": "American"
  },
  "contact_information": {
    "home_address": "1234 Elm Street\nSpringfield, IL 62704",
    "phone_number": "312-555-0198",
    "email_address": "[email protected]"
  },
  "financial_information": {
    "credit_card_number": "4111 1111 1111 1111",
    "expiration_date": "08/27",
    "cvv2": "321",
    "iban": "US29NBSO9900602934995",
    "swift_bic_number": "USBKUS44IMT",
    "monthly_salary": "$4,500"
  },
  "online_presence": {
    "username": "johnnyd123",
    "password": "P@ssw0rd!",
    "website": "johndoeonline.com"
  },
  "network_information": {
    "ipv4_address": "192.168.1.1",
    "mac_address": "00:1A:2B:3C:4D:5E",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.102 Safari/537.36"
  },
  "employment": {
    "occupation": "Graphic Designer",
    "employer": "Doe Designs LLC",
    "company_size": "11-50 employees",
    "industry": "Creative Services"
  },
  "physical_attributes": {
    "height": "5' 10" (178 cm)",
    "weight": "167.6 lbs (76 kg)",
    "blood_type": "O+"
  }
}

Use Cases

Our API provides valuable data for:

  • Software Developers: Automate testing with varied user data.
  • Content Creators: Create realistic characters for stories or games.
  • Researchers: Use randomized data for studies and analyses.