Random Person Generator API

Utilities

Generate realistic fake person data instantly. Create complete profiles with names, contact info, demographics for testing and development.

Authentication

All API requests require a valid API key passed in the Authorization header as a Bearer token.

Rate Limit

50 requests per minute

Endpoints

1 endpoint available

Overview

The Random Person Generator API creates realistic fake person data for testing, development, and creative projects. Generate single profiles or bulk data with customizable filters for age, gender, and country.

Generated Data Fields

Each generated person includes:

firstName - Realistic first name
lastName - Realistic last name
fullName - Combined first and last name
age - Age within the specified range (default 18-80)
gender - Male, Female, Non-binary, Other, or Prefer not to say
nationality - Country of origin
phoneNumber - Realistic phone number format
email - Email address based on the person's name
countryOfResidence - Current country of residence
id - Unique identifier for the record

Filter Options

Age Range - Specify minimum and maximum age (1-100)
Genders - Filter to specific gender options
Countries - Limit to specific countries (30+ supported)

Use Cases

Populating test databases with realistic user data
Creating sample data for UI/UX mockups
Generating placeholder content for demos
Testing user registration and profile systems
Creating fictional characters for creative projects

Endpoints

POST

/v1/tools/random-person-generator

Generate random person data with optional filters

Request Body

Content-Type: application/json

Parameter	Type	Required	Description
count	number	Optional	Number of people to generate (1-1000)Default: `1`
minAge	number	Optional	Minimum age for generated peopleDefault: `18`
maxAge	number	Optional	Maximum age for generated peopleDefault: `80`
genders	string[] Enum: Male, Female, Non-binary, Other, Prefer not to say	Optional	Array of genders to include
countries	string[]	Optional	Array of countries to include for nationality and residence

Response Example

{
  "success": true,
  "count": 1,
  "data": [
    {
      "firstName": "Sarah",
      "lastName": "Johnson",
      "fullName": "Sarah Johnson",
      "age": 34,
      "gender": "Female",
      "nationality": "Canada",
      "phoneNumber": "+1-555-123-4567",
      "email": "sarah.johnson@email.com",
      "countryOfResidence": "United States",
      "id": "person_1702489234567_abc123"
    }
  ]
}

Error Codes

400

Invalid request body or count exceeds maximum

401

Missing or invalid API key

429

Rate limit exceeded

500

Internal server error

Code Examples

# Generate a single random person
curl -X POST https://api.opentools.ca/v1/tools/random-person-generator \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# Generate 10 people with filters
curl -X POST https://api.opentools.ca/v1/tools/random-person-generator \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count": 10, "minAge": 25, "maxAge": 45, "countries": ["United States", "Canada"]}'

Ready to get started?

Create an API key to start using the Random Person Generator API.