United States Personas

Generate realistic US adult personas with 77 dimensions — demographics, psychology, lifestyle, and physical attributes grounded in Census Bureau data, BLS statistics, and academic research.

Quick Start

curl -X GET "https://api.personagen.dev/v1/us/persona" \
  -H "X-API-Key: your-api-key-here"

Add ?seed=your-seed for deterministic generation.

Documentation

What Makes US Personas Distinct

US personas use American-specific:

• Geographic values — 50 states + Puerto Rico, 3,144 counties
• Ethnicity categories — Census Bureau classifications with meaningful regional distinctions
• Income bands — USD brackets aligned with BLS data
• Education levels — US educational attainment categories
• Political orientation — American political spectrum including vote tendency
• Languages — Top immigrant languages in the US
• Immigration status — Generation-based categories
• Religion — US religious landscape categories
• Employment — BLS occupational classifications

Example Response

{
  "success": true,
  "data": {
    "name": { "first_name": "Marcus", "last_name": "Williams" },
    "identity": {
      "age": 45,
      "gender": "male",
      "ethnicity": "black_american",
      "political_orientation": "moderate",
      "vote_tendency": "democratic"
    },
    "origin": {
      "region": "georgia",
      "local_area": "fulton_county",
      "geographic_context": "metropolitan_urban"
    },
    "work": {
      "occupation_domain": "skilled_trades_construction",
      "occupation_title": "Construction Manager",
      "income_band": "75k_to_100k_usd"
    }
  },
  "metadata": {
    "country": "us",
    "seed": "example-seed"
  }
}