Skip to main content

​
Overview

Personas are the core of Mavera’s intelligence. They inject specialized audience knowledge into AI responses, helping you understand how different demographics, psychographics, and buyer segments think and respond.

​
Persona Types

Pre-built Personas

50+ ready-to-use personas across generational, professional, and lifestyle categories

Custom Personas

Create personas tailored to your specific target audience

​
Categories

CategoryExamples
GenerationalGen Z, Millennials, Gen X, Baby Boomers
ProfessionalB2B Decision Maker, Startup Founder, Enterprise CTO
LifestyleHealth-Conscious Consumer, Eco-Warrior, Budget Shopper
IndustryHealthcare Professional, Finance Expert, Tech Enthusiast
ExpertMarket Analyst, Brand Strategist, UX Researcher

​
Listing Personas

import requests

response = requests.get(
    "https://app.mavera.io/api/v1/personas",
    headers={"Authorization": "Bearer mvra_live_your_key_here"}
)

personas = response.json()["data"]
for persona in personas:
    print(f"{persona['name']} ({persona['category']})")
    print(f"  ID: {persona['id']}")
    print(f"  {persona['description'][:100]}...")

​
Using Personas in Chat

from openai import OpenAI

client = OpenAI(
    api_key="mvra_live_your_key_here",
    base_url="https://app.mavera.io/api/v1",
)

# Use a Gen Z persona for youth-focused insights
response = client.chat.completions.create(
    model="mavera-1",
    messages=[
        {"role": "user", "content": "What makes a brand authentic?"}
    ],
    extra_body={"persona_id": "gen_z_consumer_id"},
)

​
Creating Custom Personas

Custom personas let you define your exact target audience. There are three creation pipelines:

​
North Star (Simplest)

AI generates a complete persona from minimal input: 
response = requests.post(
    "https://app.mavera.io/api/v1/personas",
    headers={"Authorization": "Bearer mvra_live_your_key_here"},
    json={
        "pipeline_type": "NORTH_STAR",
        "name": "Sustainable Fashion Buyer",
        "description": "Eco-conscious millennial interested in sustainable fashion",
        "workspace_id": "your_workspace_id"
    }
)

​
Intermediate (Guided)

3-step process with more control: 
response = requests.post(
    "https://app.mavera.io/api/v1/personas",
    headers={"Authorization": "Bearer mvra_live_your_key_here"},
    json={
        "pipeline_type": "INTERMEDIATE",
        "name": "Enterprise IT Buyer",
        "persona_type": "B2B",
        "buying_stage": "SOLUTION_AWARE",
        "decision_role": "ECONOMIC_BUYER",
        "goals": ["Reduce IT costs", "Improve security"],
        "pains": ["Budget constraints", "Integration complexity"],
        "workspace_id": "your_workspace_id"
    }
)

​
Advanced (Full Control)

Complete customization with psychographics and purpose packs: 
response = requests.post(
    "https://app.mavera.io/api/v1/personas",
    headers={"Authorization": "Bearer mvra_live_your_key_here"},
    json={
        "pipeline_type": "ADVANCED",
        "name": "SMB SaaS Buyer",
        "persona_type": "B2B",
        "role_title": "Operations Manager",
        "company_size": "SMB_51_200",
        "buying_stage": "DECISION",
        "decision_role": "CHAMPION",
        "budget_authority": "RECOMMENDER",
        "goals": ["Automate workflows", "Scale operations"],
        "pains": ["Manual processes", "Team bandwidth"],
        "triggers": ["Growth phase", "New funding"],
        "channels": ["LinkedIn", "Industry podcasts", "Peer recommendations"],
        "tech_stack": ["Slack", "HubSpot", "Notion"],
        "workspace_id": "your_workspace_id"
    }
)
Custom persona creation costs 300 credits. Personas are reusable across all API calls.

​
Persona Response

{
  "id": "persona_abc123",
  "name": "Gen Z Consumer",
  "category": "Generational",
  "description": "Digital native aged 18-26 who values authenticity, social responsibility, and personalized experiences.",
  "is_custom": false,
  "is_expert": false,
  "created_at": "2024-01-15T10:30:00Z"
}

​
Best Practices

Use generational personas for consumer insights, professional personas for B2B research, and expert personas for strategic analysis.
Layer persona intelligence with specific system prompts for best results.
If your target audience isn’t covered by pre-built personas, create a custom one.
Personas are stored and reusable — no need to recreate them.

API Reference

See the full API specification