Documentation

Start typing to search.

Vimeo

Written by Ilya Sudakov

Updated on Nov 20, 2026

Description

Vimeo is a video hosting platform for uploading, organizing and sharing videos, with privacy settings and an embeddable player.

Setup guide

Follow this setup guide to connect Vimeo to Improvado.

Choose authorization option:

Connect with Vimeo

In the authorization form, select Connect with Vimeo.

Choose the Scope level (click Change to pick another one):

  • Read Only (default) gives access to your public and private videos, folders and video files. It is enough for reports.
  • Read & Write also lets Improvado's AI Agent edit and delete videos, manage folders and post comments when you ask it to.
  • Custom lets you pick individual scopes. Public and private access are always included. Uploading videos is not available yet.

A connection keeps the scopes it was granted. To change them later, reconnect.

Click Authorize Vimeo. You are redirected to Vimeo. Sign in with the account that owns the videos you want to extract: the connection reads only that account. For a team library, sign in as the account owner, not as a team member.

Review the access Vimeo asks for and click Allow. You are then redirected back to Improvado.

Personal Access Token

Sign in to Vimeo with the account that owns the videos you want to extract: the token you create reads only that account. For a team library, sign in as the account owner, not as a team member. Open My Apps on the Vimeo Developer site and select your app, or click Create an app, enter a name and a description, accept the terms and click Create app (see the official guide). When asked whether other Vimeo accounts will access the app, select No.

In the app, select Generate Access Token under Authentication, then select Authenticated (you). Under Scopes, tick Public and Private and click Generate (see the official guide). Improvado needs the Private scope to read your folders and your private and unlisted videos, and rejects a token without it. Copy the token right away: Vimeo does not show it again, but you can generate a new one at any time.

In the authorization form, select Personal Access Token, paste the token into the Personal Access Token field and click Authorize Vimeo.

When the connection status is Active, follow the instructions on how to set up data extraction.

Schema information

The schema information shows all report types you can use to extract data from Vimeo.

Limits

One Vimeo account per connection. A connection extracts the videos and folders of the Vimeo account you sign in with, or that generated the token, at every privacy setting. Videos that other accounts share with it are not included. To extract another account, such as a team owner's library, add a connection for that account.

Current values only. Every extraction loads the whole library and replaces the previous rows. Plays, likes and comments are each video's totals as of the latest extraction, with no daily history, and videos and folders deleted in Vimeo disappear from your data.

Inactive tokens. Vimeo deletes access tokens that appear inactive. If the connection stops working, reconnect: sign in again through Connect with Vimeo, or generate a new token in your app.

Release notes

Vimeo publishes API changes in its changelog.

Was this article helpful?

Questions? The Improvado team is always happy to help. Send us an email, contact your Customer Success Manager, or raise a request in the Improvado Service Desk.