Skip to main content

Scenario

Your team uploads a draft video to Vimeo as a private link for stakeholder review — but the review is subjective and inconsistent. This job intercepts the draft after upload, pulls it via the Vimeo API, runs Video Analysis to score it against your quality thresholds, and if any metric falls below the threshold, automatically triggers a Focus Group asking: “What could make this more compelling?” The result is a publish-or-revise decision backed by quantitative scores and synthetic panel feedback — before the video goes public.

Architecture

Code

Example Output

Error Handling

Private Vimeo videos require the token owner to be the video owner or a team member. The privacy.view field should be nobody (private link) or password. Videos set to disable cannot be accessed via API.
Newly uploaded Vimeo videos may have status: "uploading" or "transcoding". Wait for status: "available" before sending to Mavera. Poll GET /videos/{id}?fields=status every 10 seconds.
Start with conservative thresholds (60-70) and tighten as your library builds. Analyze your top 10 performing videos first to establish baseline scores for each metric.

What’s Next

Vimeo Integration

Back to Vimeo integration overview

Engagement Scoring Correlation

Correlate Mavera scores with real engagement

Video Analysis API

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

Focus Groups API

Full reference for POST /api/v1/focus-groups