Skip to main content

​
Base URL

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

​
Authentication

All API endpoints require authentication using Bearer tokens. Include your API key in the Authorization header: 
Authorization: Bearer mvra_live_your_key_here

Get Your API Key

Create and manage API keys in your dashboard

​
Request Format

  • All requests should include Content-Type: application/json
  • Request bodies should be JSON-encoded
  • Dates are returned in ISO 8601 format

​
Response Format

All responses follow a consistent format: 
{
  "id": "chatcmpl_abc123",
  "object": "chat.completion",
  "created": 1706345678,
  "model": "mavera-1",
  "choices": [...],
  "usage": {
    "credits_used": 3,
    "prompt_tokens": 150,
    "completion_tokens": 200
  }
}

​
Available Endpoints

Chat Completions

Create chat completions with persona intelligence

Mave Agent

AI research agent with multi-source analysis

Personas

List and manage personas for targeted insights

Focus Groups

Run AI-powered synthetic focus groups

Video Analysis

Analyze videos for emotional and cognitive metrics

News

Get AI-analyzed news intelligence

Brand Voice

Manage brand voice profiles

Generations

Generate AI content from templates

​
Rate Limits

Rate limits are applied per API key based on your subscription tier:
TierRequests / min
Starter60
Basic120
Professional240
Enterprise600
When rate limited, responses include a Retry-After header indicating seconds to wait.

​
Credits

Each API call consumes credits from your subscription. The usage.credits_used field in responses shows the cost of each request.
EndpointTypical Cost
Chat Completions1-5 credits
Mave Agent10-50 credits
Focus Groups50-200 credits
Video Analysis100-500 credits
Monitor your credit usage in real-time at app.mavera.io/settings/usage

​
SDKs

While we provide a REST API, you can use any OpenAI-compatible SDK by changing the base URL: 
from openai import OpenAI

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

​
Need Help?

Support

Contact our support team

API Status

Check API status and incidents