Skip to main content

Scenario

You run a webinar series on Vimeo — a multi-session program where engagement typically declines across sessions. This job pulls all videos from a Vimeo showcase (album/folder) representing the series, runs Video Analysis on each session, then asks Mave to diagnose engagement shifts: “How does engagement shift across this series? Where do we lose them?” The result is a session-by-session intelligence report that shows you exactly where audience interest peaks, drops, and recovers — so you can restructure future series for maximum retention.

Architecture

Code

Example Output

Error Handling

Vimeo uses “albums” (also called showcases) to group videos. The API endpoint is /me/albums/{id}/videos. Folders (for organization) use a different endpoint: /me/folders/{id}/videos. Ensure you’re using the correct one.
The sort=manual parameter returns videos in the order you arranged them in the showcase. If you want chronological order instead, use sort=date. The session numbering in the code follows the API sort order.
For long series, batch Video Analysis into groups of 5 with 60-second pauses between groups to respect both Vimeo and Mavera rate limits. The total analysis time scales linearly with session count.

What’s Next

Vimeo Integration

Back to Vimeo integration overview

Video Library Analysis

Score your entire video catalog

Video Analysis API

Full reference for POST /api/v1/video-analysis

Mave Agent

Full reference for POST /api/v1/mave/chat