Documentation Index
Fetch the complete documentation index at: https://docs.mavera.io/llms.txt
Use this file to discover all available pages before exploring further.
Mavera Surfaces
| Surface | Role |
|---|---|
Files (POST /files/upload-url, POST /files) | Upload competitor video ads |
Video Analysis (POST /video-analyses) | Frame-level scoring of each competitor creative |
Mave (POST /mave/chat) | Synthesize cross-competitor findings into a competitive intelligence report |
What Value Does Mavera Add?
| Value | How |
|---|---|
| Insurance | Know what competitors are doing before you finalize your own creative. Avoid launching something they already dominate. |
| Opening new doors | Frame-level analysis reveals tactics invisible from just watching: pacing patterns, CTA timing, emotional arcs. |
| Saving time | A human competitive review is subjective and takes days. This pipeline produces a structured report in minutes. |
When to Use This
- Quarterly competitive review: what creative strategies are competitors using?
- Pre-campaign: before building your next ad, see what’s already in market.
- Client pitch: show up with data on the competitive landscape.
- Creative team onboarding: give new hires a data-driven view of the competitive environment.
Where to find competitor ads: Meta Ad Library, TikTok Creative Center, YouTube channels, or screen-recording public content. This playbook assumes you already have the video files locally.
What You Need
| Requirement | Details |
|---|---|
| Mavera API key | Starts with mvra_live_. Get one at Developer Settings. |
| Workspace ID | From your dashboard URL (ws_...). |
| 3–8 competitor video ads | MP4 or MOV, 15–60 s each. At least 2 competitors for meaningful comparison. |
| Your own ad (optional) | Include one of yours for direct benchmarking. |
| Credits | ~100–250 per video + ~15–30 for Mave. See Credits Estimate. |
| Python 3.8+ or Node.js 18+ | requests for Python; native fetch for Node. |
The Flow
Collect competitor ads
Download 3–8 ads from public sources. Organize by competitor:
nike_hero_30s.mp4, adidas_brand_45s.mp4.Stage 1 — Upload Competitor Ads
Stage 2 — Video Analysis (Batch)
Stage 3 — Build the Comparison Matrix
Group by competitor. For competitors with multiple ads, compute averages.Stage 4 — Mave Competitive Intelligence
Running the Full Pipeline
Example Output
Variations
Include your own ads for direct benchmarking
Include your own ads for direct benchmarking
Name your ads with an
ours_ prefix. They’ll appear in the matrix for direct comparison.Quarterly tracking
Quarterly tracking
Save each matrix to JSON for trend analysis over time.
Add Focus Group for audience reaction
Add Focus Group for audience reaction
After Video Analysis, run a Focus Group showing the top competitor ad vs yours for simulated audience preference.
Platform-specific analysis
Platform-specific analysis
Tag files by platform (
nike_tiktok_hero.mp4) and add platform as a grouping dimension in the matrix.Override competitor name extraction
Override competitor name extraction
Use a manual
COMPETITOR_MAP dict if filenames don’t follow the competitor_type.mp4 convention.Credits Estimate
| Stage | Typical Cost | Notes |
|---|---|---|
| File uploads (×N) | 0 | Free |
| Video Analysis (×N) | 100–250 each | Depends on video length |
| Mave synthesis | 15–30 | Single research query |
| 6-ad reel | ~615–1,530 | 5 competitors + 1 own |
| 10-ad reel | ~1,015–2,530 | Large competitive landscape |
See Also
Ad Creative Audit
Audit your own ads instead of competitors’
Hook Analysis Sprint
Deep-dive into hook strategies across variants
Video + Focus Group Double
Layer competitor analysis with synthetic audience reactions
Competitive Ad Analysis Pipeline
Head-to-head pipeline with Focus Group and Mave report
Video Analysis
Metrics reference and chunk configuration
Mave Agent
Research agent for synthesis and recommendations