Skip to Content
Introduction

PersonaGen API Documentation

PersonaGen is a synthetic persona generation API that creates statistically grounded demographic profiles for AI research and testing. Instead of manually creating personas or conducting expensive focus groups, PersonaGen generates realistic, diverse personas programmatically.

What is PersonaGen?

PersonaGen generates comprehensive synthetic personas using advanced demographic correlation models. Each persona includes 62 dimensions covering demographics, psychology, lifestyle, and physical characteristics - creating detailed profiles that reflect real-world population statistics.

Current Coverage: PersonaGen currently generates US-based personas only. Additional regions (UK, Canada, Australia) are planned for future releases.

Key Features

  • Lightning Speed: Generate personas in under 100ms average response time
  • Statistical Accuracy: 158,361 unique data points with realistic demographic correlations
  • Comprehensive Data: 62 dimensions across demographics, psychology, lifestyle, and physical traits
  • Developer-Friendly: Clean REST API with structured JSON responses
  • Deterministic Generation: Use optional seed parameter for reproducible personas

Use Cases

PersonaGen is designed for teams that need diverse, realistic personas at scale:

Marketing Teams

Test messaging and campaigns across different demographics before launch. See how a 72-year-old retired teacher from Florida might research products differently than a 19-year-old college student from Ohio.

NPC Creation

Create diverse NPCs and characters for games, simulations, or interactive experiences. Generate background stories, personality traits, and behavioral patterns for realistic character development.

Product Teams

Conduct UX research with varied user profiles. Understand how technology comfort levels, income brackets, and lifestyle factors influence product adoption and usage patterns.

Academic Research

Generate statistically valid personas for social science experiments. Study behavioral patterns across demographic segments without expensive focus groups or lengthy recruitment processes.

How It Works

  1. Make an API Request: Simple HTTP GET request to /v1/persona
  2. Receive Structured Data: Get comprehensive persona with 62 dimensions
  3. Use Immediately: All data ready for analysis, testing, or research

Each persona includes:

  • Demographics: Age, location, education, income, ethnicity, occupation
  • Psychology: Big Five personality traits, IQ, literacy levels
  • Lifestyle: Interests, technology comfort, political leanings, family status
  • Physical: Height, weight, appearance details, clothing sizes

Current Limitations

PersonaGen is currently in its initial release with focused capabilities:

  • Single persona per request (batch generation coming soon)
  • US demographics only (UK expansion planned)
  • No filtering options (may be added based on demand)
  • Individual personas, not population modeling: PersonaGen excels at generating diverse individual personas for testing and creative work, but should not be used to simulate real-world demographic distributions. Generating large datasets will not accurately represent true population statistics due to inherent model biases.
Last updated on