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.
Scenario
You have Vimeo engagement data (plays, finishes, average percent watched, engagement graphs) and Mavera Video Analysis scores — but you don’t know which Mavera metric actually predicts real-world engagement. This job pulls engagement stats for your video library from Vimeo, runs Video Analysis on the same videos, then asks Mave to correlate the two datasets: “Which Mavera metric best predicts real engagement?” The result is a data-driven answer to which creative qualities drive actual viewer behavior — so you can optimize future videos for the metrics that matter.Architecture
Code
Example Output
Error Handling
Stats availability
Stats availability
Vimeo stats (
plays, finishes) require a Vimeo Pro, Business, or Premium account. Free accounts only get plays. The finishes metric may return 0 for very new videos without sufficient data.Sample size for correlation
Sample size for correlation
15 videos is a minimum viable sample for directional correlation. For statistically significant results, analyze 50+ videos. The code samples the top 15 by plays — consider random sampling for unbiased results.
Engagement graph endpoint
Engagement graph endpoint
For per-second engagement data, use
GET /videos/{id}/stats with fields=engagement_graph. This returns a frame-by-frame attention curve that can be paired with Mavera’s emotional arc for deeper correlation.What’s Next
Vimeo Integration
Back to Vimeo integration overview
Caption Content Extraction
Extract repurposable content from transcripts
Video Analysis API
Full reference for POST /api/v1/video-analysis
Mave Agent
Full reference for POST /api/v1/mave/chat