> API DOCUMENTATION

Generate realistic random people based on US Census data

Quick Start

The LifeSim API generates detailed fictional people with realistic demographics. Perfect for testing, game development, or populating mock databases.

GET https://lifesim.io/api/

Try It Now

# Generate one random person
curl "https://lifesim.io/api/"

# Generate 5 people
curl "https://lifesim.io/api/?num=5"

# Generate a specific person using a seed
curl "https://lifesim.io/api/?seed=12345"
Try Interactive Demo

Request Parameters

Parameter Type Required Description
num integer optional Number of people to generate (default: 1)
seed number optional Seed for reproducible generation. Same seed = same person every time.
Note: Using a seed allows you to regenerate the exact same person later. Share seeds to share specific characters!

Response Format

The API returns JSON with a time field (generation time in seconds) and a people array containing generated person objects.

Response Fields

seed Unique identifier for this person (use to regenerate)
name_first First name
name_last Last name / surname
age Current age in years
birth_day Date of birth (YYYY-MM-DD)
physical Object containing gender, height, weight, hair_color, eye_color, handedness, sexuality, vision
location Object with city, state, population, density, coordinates
income Annual income range and amount
education Highest education level achieved
employment Employment status, company size, schedule, commute details
married Marital status, wedding date, spouse details (if applicable)
children Whether the person has children
religion Religious affiliation
email Generated email address
phone Generated phone number
summary Human-readable summary paragraph

Example Response

{
  "time": 0.207,
  "people": [{
    "seed": 1842956731,
    "name_first": "Rhonda",
    "name_last": "Snider",
    "age": 80,
    "birth_day": "1944-12-17",
    "physical": {
      "gender": "Female",
      "height": "5'4\"",
      "weight": 145,
      "hair_color": "Gray",
      "eye_color": "Brown",
      "handedness": "Right",
      "sexuality": "Heterosexual"
    },
    "location": {
      "city": "Ozark",
      "state": "Missouri",
      "density": "rural",
      "population": "17820"
    },
    "income": {
      "amount": 175910,
      "min": 150000,
      "max": 200000
    },
    "education": {
      "education_highest": "Bachelor's degree"
    },
    "married": {
      "married": true,
      "wedding_day": {
        "date": "1962-07-04"
      }
    },
    "email": {
      "address": "rhonda.snider@gmail.com"
    },
    "summary": "Rhonda Snider is an 80-year-old woman..."
  }]
}

Use Cases

Rate Limits & Access

The API is free to use directly. For higher rate limits and API key management, access via RapidAPI:

Available on RapidAPI