Skip to main content
Vimeo’s API gives you direct access to your entire video library — metadata, engagement stats, text tracks, and private uploads — that most teams only browse through the dashboard. These five jobs pull that data through Mavera’s surfaces (Video Analysis, Focus Groups, Mave Agent, Chat, Generate) to score your creative catalog by emotional impact, gate publishing with quality thresholds, correlate Mavera scores against real engagement, extract repurposable content from captions, and track audience retention across webinar series.

​
API Reference Card

All examples use two environment variables: VIMEO_ACCESS_TOKEN and MAVERA_API_KEY. The Vimeo token requires the public, private, video_files, and stats scopes. Generate one at Vimeo Developer → My Apps. Store both keys in your secrets manager and never expose them client-side.

​
Prerequisites

1

Vimeo app

Create an app at developer.vimeo.com/apps. Request the scopes: public, private, video_files, stats, upload.
2

Access token

Generate a personal access token under your app’s Authentication tab, or implement the full OAuth 2.0 flow for multi-user access.
3

Mavera API key

Get your key from Mavera dashboard.
4

Environment variables

​
Jobs

​
Rate Limits & Production Notes

Vimeo enforces rate limits per access token: ~100 requests/minute on free plans, ~600 requests/10 minutes on Pro/Business/Premium. The API returns 429 Too Many Requests with a Retry-After header (in seconds). Always respect this header. For large library scans (500+ videos), implement exponential backoff and spread requests across 10-minute windows. Monitor your rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset.
Production checklist:

​
What’s Next

All Integrations

50+ API integrations with full code

Vimeo API Reference

Official Vimeo API documentation

Video Analysis

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

Focus Groups API

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

Mave Agent

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

Generate API

Full reference for POST /api/v1/generate