Skip to main content

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

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.
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.
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