Vimeo Integration

Vimeo Connector: Integration Overview & Requirements

This document outlines the requirements and configuration steps for connecting Vimeo content to Capacity Answer Engine (Lucy).

Overview

This integration automatically indexes Vimeo videos to improve searchability and data retrieval. It supports videos uploaded to a Vimeo account, public profiles, and public channels. Please review the requirements below before connecting.

Functional Requirements

• Public Videos Only (by default): The connector processes only public videos by design. Private videos are skipped unless you ask us to include them.
• Transcripts: Videos with a transcript uploaded to Vimeo are processed from that transcript. Videos without one are processed from the video file when the authorizing account owns the video and is on a paid Vimeo plan that allows downloads. Videos on a profile or channel owned by another account must have an uploaded transcript.
• Supported Sources: Videos uploaded to an account, public profiles (e.g., vimeo.com/username), and channels. For channels, provide the channel link as the input URL.
• Login Required: A Vimeo login is required for every connection, including when indexing public content.

Vimeo Plan Requirements

Vimeo only allows video files to be downloaded through its API on paid plans (Starter, Standard, Advanced, or Enterprise). Downloads are used to process videos that don’t have an uploaded transcript, and they apply only to videos owned by the account used to authorize the connection.

With a free Vimeo account, videos can’t be downloaded, so only videos that already have a transcript uploaded can be processed.

Authentication & Access Control

The connector authenticates through a Vimeo login and an app authorization step.

Important: All requested permissions must be approved. If any are denied, the connection will fail. Although the authorization screen lists access to private content, the connector indexes only public videos unless private video indexing has been enabled for your project.

Account Options

We support the following account options, in order of recommendation:

1. Client Domain Account (Recommended): An account within your own domain that owns the videos and can complete the Vimeo login and authorization. This keeps the connection under your organization’s control.
2. Other Owner Account: The Vimeo account that owns the content, if it isn’t on your domain.
3. Individual Account: Any individual Vimeo account can be used to index public profiles and channels. Videos without an uploaded transcript can’t be processed for content you don’t own.

Internal Notes

Connecting Vimeo to Answer Engine

1. Open the Vimeo connector.
2. Enter a source (optional). Enter a Channel URL or Public Profile URL. To index videos uploaded to the authenticating account, leave both fields blank.
3. Click Continue.
4. Log in to Vimeo with the account you're using for the connection.
5. Review the requested permissions and approve the Capacity app.
6. Select the folders to index. If the folder list doesn't appear right away, double-click root to reload it.

Choosing what to ingest

Enabling private videos

• When connecting, check Allow Private Videos (Vimeo Only) in the project settings. This works for the blank-fields path, profiles, and non-public channels.
• If any permissions are denied on the consent screen, the connector fails. Privacy can only be controlled via this checkbox.