Getting Started

Prerequisites

HTTP client (curl, Postman, fetch, requests)
API key for higher limits (optional for demo mode)

Create account

Go to personagen.dev/app and sign up.

Create API key

Generate a key from API Keys.

Store your API key securely. Default limit: 5,000 requests/month.

Generate your first persona

Pick a country route and call the endpoint.

First request

cURL


# US
curl -X GET "https://api.personagen.dev/v1/us/persona?seed=demo-001" \
  -H "X-API-Key: your-api-key-here"
 
# UK
curl -X GET "https://api.personagen.dev/v1/uk/persona?seed=demo-001" \
  -H "X-API-Key: your-api-key-here"

JavaScript


const country = "us"; // "us" | "uk"
const response = await fetch(
  `https://api.personagen.dev/v1/${country}/persona?seed=demo-001`,
  { headers: { "X-API-Key": "your-api-key-here" } }
);
 
const payload = await response.json();

Python


import requests
 
country = "uk"  # "us" or "uk"
response = requests.get(
  f"https://api.personagen.dev/v1/{country}/persona",
  params={"seed": "demo-001"},
  headers={"X-API-Key": "your-api-key-here"}
)
 
payload = response.json()

Demo mode (no account)

Use X-Demo: true without an API key.


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

Demo mode is limited to 25 requests/hour per IP.

Response basics

data: the persona object.
metadata.country: route country (us or uk).
metadata.seed: deterministic generation key.
metadata.usage: remaining requests and reset date.