Skip to main content

Scenario

Your Vimeo account holds hundreds of marketing videos spanning campaigns, product demos, testimonials, and event recordings — but you have no systematic way to know which are your strongest creative assets. This job pulls your entire video library via GET /me/videos, uploads each to Mavera Assets, and runs Video Analysis scoring every video on emotional impact, message clarity, and behavioral effectiveness. The result is a ranked catalog that tells you which videos to promote, which to retire, and which patterns your best-performing creative shares.

Architecture

Code

Example Output

Error Handling

Vimeo returns a Retry-After header in seconds. The code respects this value. Free accounts hit ~100 req/min; Pro/Business accounts get ~600 req/10 min. Add exponential backoff for large libraries.
The video_files scope is required to access download URLs for some endpoints. Without it, use the link field (public Vimeo URL) for Mavera asset uploads instead.
Libraries with 500+ videos require multiple pages. Each page costs one API call. The code paginates automatically but add a 600ms delay between pages to stay within rate limits.

What’s Next

Vimeo Integration

Back to Vimeo integration overview

Pre-Publish Creative Testing

Gate publishing with quality thresholds

Video Analysis API

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

Mave Agent

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