Getting Started

Get up and running with PersonaGen in minutes. This guide walks you through creating an account, generating an API key, and making your first successful API call.

Prerequisites

Before you begin, you’ll need:

Basic knowledge of HTTP requests
A tool to make API calls (cURL, Postman, or code)

Quick Setup

Create Your Account

Visit personagen.dev/app and create a free account.

Generate an API Key

Log in to your account
Navigate to API Keys in your dashboard
Click “Generate API Key”
Copy and securely store your API key

API Key created successfully - copy it now as you won't see it again

Keep your API key secure! You can only have 1 active API key at a time, and each key has a default limit of 1000 requests per month.

Make Your First Call

Test your setup with a simple API call:

cURL


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

JavaScript


const response = await fetch('https://api.personagen.dev/v1/persona', {
  headers: {
    'X-API-Key': 'your-api-key-here'
  }
});
 
const data = await response.json();
console.log(data);

Python


import requests
 
headers = {'X-API-Key': 'your-api-key-here'}
response = requests.get('https://api.personagen.dev/v1/persona', headers=headers)
data = response.json()
print(data)

Try Without an Account (Demo Mode)

Want to test PersonaGen before signing up? Use demo mode by adding the X-Demo: true header:

cURL


curl -X GET "https://api.personagen.dev/v1/persona" \
  -H "X-Demo: true"

JavaScript


const response = await fetch('https://api.personagen.dev/v1/persona', {
  headers: {
    'X-Demo': 'true'
  }
});
 
const data = await response.json();
console.log(data);

Python


import requests
 
headers = {'X-Demo': 'true'}
response = requests.get('https://api.personagen.dev/v1/persona', headers=headers)
data = response.json()
print(data)

Demo Mode Limits: 10 requests per hour per IP address. For production use, create an account and use an API key.

Understanding Your Response

When you make a successful call, you’ll receive a comprehensive persona with 62 dimensions:


{
  "success": true,
  "data": {
    "name": {
      "first_name": "Sarah",
      "last_name": "Thompson"
    },
    "demographics": {
      "age": 34,
      "location": "california",
      "education": "bachelor_degree"
      // ... 15+ more demographic fields
    },
    "psychology": {
      "big_five_openness": "above_average",
      "iq": 115
      // ... personality traits
    },
    "lifestyle": {
      "interests": ["hiking", "photography", "cooking"],
      "technology_comfort": "advanced_user"
      // ... lifestyle details
    },
    "physical": {
      "height": {
        "cm": 165,
        "feet_and_inches": "5ft_5in"
      }
      // ... physical characteristics
    }
  },
  "metadata": {
    "id": "persona_abc123",
    "generated_at": "2025-01-09T10:30:00Z",
    "usage": {
      "requests_remaining": 999,
      "reset_date": "2025-02-01T00:00:00Z"
    }
  }
}