Skip to main content

​
Welcome to Mavera

Mavera provides AI-powered APIs for marketing intelligence, customer research, and content generation. Our APIs deliver real-time customer insights, persona-driven AI responses, and comprehensive market analysis.

Quickstart

Get your first API call working in under 5 minutes

API Reference

Explore all endpoints with interactive examples

Authentication

Learn how to authenticate your requests

Get API Key

Create your API key in the dashboard

​
Quick starts by feature

Step-by-step guides for each major API with full code samples:

Quickstart: Chat

Persona-powered responses (Python, JavaScript, cURL)

Quickstart: Mave Agent

Research with sources, threads, and follow-ups

Quickstart: Focus Groups

Run a synthetic focus group with multiple question types

Quickstart: Video Analysis

Upload a video and get engagement and emotional metrics

​
Tutorials

End-to-end integrations with external APIs. Each tutorial has full code (Python + JavaScript):

Tutorials

Overview of all tutorials by API

Salesforce + Mavera

Lead scoring with B2B persona → push narrative to CRM

HubSpot + Mavera

Email sequence scoring before you send

Zendesk + Mavera

Ticket reply drafts with empathetic persona

Slack + Mavera

Message tone check before posting

Mixpanel + Mavera

Funnel drop-off hypotheses

Stripe + Mavera

Dunning message validation

Notion + Mavera

Page readability scoring

GitHub + Mavera

PR description review

​
Cookbooks

Production-ready patterns for common integration needs:

Persona Selection

Use-case → persona matrix and programmatic selection

Migrate OpenAI → Mavera

Base URL and persona_id with minimal code changes

Error Handling

Retries, backoff, user-facing messages, structured logging

Rate Limits in Production

Throttling, token bucket, concurrency limits, queuing

Credits & Budget Alerts

Usage tracking, pre-flight checks, graceful degradation

Streaming Chat in React

React component and hook for Mavera streaming

Practical Workflow Ideas

200+ workflows: content, personas, Salesforce, HubSpot, Slack

​
Core APIs

Responses API

OpenAI-compatible Responses API with persona intelligence. Use any OpenAI SDK with Mavera personas for specialized, audience-aware responses.

Mave Agent

AI research agent that conducts comprehensive investigations using multiple data sources, personas, and built-in fact-checking.

Focus Groups

AI-powered synthetic focus group research with customizable personas and 12 question types including NPS, Likert scales, and open-ended.

Video Analysis

Comprehensive video and advertisement analysis with emotional, cognitive, and behavioral metrics.

​
Why Mavera?

1

Persona Intelligence

Every API call can be enhanced with specialized personas that inject domain expertise into AI responses. Choose from 50+ pre-built personas or create custom ones tailored to your target audience.
2

OpenAI SDK Compatible

Our Responses API is fully compatible with OpenAI SDKs. Just change the base URL, call client.responses.create(), and add a persona_id to supercharge your AI responses with audience insights.
3

Comprehensive Research

Mave agent conducts multi-phase research (Triage → Planning → Research → Execution → Validation) with built-in fact-checking and source attribution.
4

Credit-Based Pricing

Pay only for what you use. Every API response includes credits_used so you can track costs in real-time with full transparency.

​
Quick Example

from openai import OpenAI

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

response = client.responses.create(
    model="mavera-1",
    input="How do millennials feel about remote work?",
    extra_body={"persona_id": "YOUR_PERSONA_ID"},
)

print(response.output[0].content[0].text)
print(f"Credits used: {response.usage.credits_used}")

​
Base URL

All API requests should be made to: 
https://app.mavera.io/api/v1

​
Need Help?

Support

Contact our support team for assistance

API Status

Check real-time API status and incidents