Skip to main content

Welcome to Vimeo Connector

Make your video content searchable through AI-powered conversations.

The Vimeo Connector automatically imports video transcripts and metadata from Vimeo into your CustomGPT.ai knowledge base, enabling your chatbot to answer questions about video content using actual transcripts as source material.

What This Does​

Instead of forcing users to watch entire videos to find information, the Vimeo Connector extracts native Vimeo transcripts and makes them searchable. When someone asks your CustomGPT chatbot a question, it can reference specific moments in your video library and provide exact answers with timestamps.

Example: A user asks "How do I reset my password?" Your chatbot responds: "At 2:45 in the 'Account Settings Tutorial' video, the instructor demonstrates password reset. Click here to watch that section."

This works because the Vimeo Connector has already imported the video's transcript, capturing every word spoken and preserving timestamp information.

Quick Start​

Get your first collection synced in under 5 minutes:

  1. Open the dashboard at https://vimeo.trustedgpt.io
  2. Paste a Vimeo URL (showcase, user profile, album, collection, or single video)
  3. Click "Import Collection" and watch real-time progress
  4. Review results showing what was imported

For step-by-step instructions with screenshots, see the Getting Started Tutorial.

Key Features​

Comprehensive URL Support​

The connector handles five different Vimeo URL types:

  • Showcases - https://vimeo.com/showcase/[id]
  • User Profiles - https://vimeo.com/user[id]
  • Albums - https://vimeo.com/user[id]/albums
  • Collections - https://vimeo.com/user[id]/collections
  • Single Videos - https://vimeo.com/[video-id]

Paste any of these URLs and the connector automatically determines the correct import strategy. No need to specify video type or configure special settings.

Native Transcript Extraction​

The connector fetches native Vimeo transcripts—the same transcripts Vimeo users see in the video player. If a video owner has uploaded a VTT or SRT transcript file to Vimeo, the connector retrieves it automatically.

Important: The connector only imports existing transcripts. It does not generate transcripts from audio using speech-to-text services. Videos without native transcripts will have their metadata imported but transcript content will be empty.

Real-Time Progress Monitoring​

Watch your import happen in real-time. The dashboard displays:

  • Current video being processed with video name and thumbnail
  • Progress bar showing percentage complete (e.g., "Processing 45 of 100 videos")
  • Status indicators for queued, running, completed, or failed states
  • Live updates every 1.5 seconds without page refresh

Production-Grade Reliability​

Built for enterprise workloads with:

  • Rate limiting that respects Vimeo's 600 calls/10min limit automatically
  • Error handling with exponential backoff and automatic retries
  • Token pool option to multiply capacity by 6x (3600 calls/10min)
  • Observability through Grafana dashboards showing real-time metrics

How It Works​

When you submit a Vimeo URL, the connector:

  1. Parses the URL to determine resource type (showcase, user, album, collection, or video)
  2. Fetches video list by calling Vimeo's API with proper authentication
  3. Retrieves metadata for each video (title, description, duration, thumbnail, upload date, tags)
  4. Downloads transcripts from Vimeo's text track API for videos that have them
  5. Formats results into JSON suitable for CustomGPT.ai's knowledge base ingestion
  6. Reports progress in real-time so you can monitor what's happening

The entire process runs asynchronously in the background. You can close your browser and return later—the sync continues running on the server.

What's Included​

This documentation covers everything you need to use and deploy the Vimeo Connector:

🎓 Tutorials​

Learning-oriented guides that teach core concepts through hands-on exercises:

📘 How-To Guides​

Task-oriented instructions for specific goals:

📖 Explanation​

Understanding-oriented articles that clarify concepts:

📚 Reference​

Information-oriented specifications:

Use Cases​

Training Video Library​

Your company has 200+ employee training videos on Vimeo. Instead of maintaining a manual index, import them into CustomGPT.ai. Employees can ask "How do I submit an expense report?" and get an instant answer pulled from the relevant training video transcript.

Product Demo Collection​

Your sales team has dozens of product demo videos. Sync them once, and your chatbot can answer prospect questions like "Does your product integrate with Salesforce?" by referencing the exact demo where that integration is shown.

Educational Content​

You run an online course with lecture videos. Students can ask questions about specific topics and receive answers grounded in lecture transcripts, complete with timestamps to watch the relevant section.

Support Knowledge Base​

Customer support has video tutorials for common issues. Import these videos and your support chatbot can provide video-based answers to customer questions, reducing support ticket volume.

System Requirements​

To use the Vimeo Connector, you need:

Vimeo Account - The connector works with any Vimeo account (Free, Plus, Pro, Business, or Premium). You'll need a Vimeo API access token which you can generate from Vimeo's Developer Portal.

CustomGPT.ai Account - The connector is designed to work with CustomGPT.ai's knowledge base. While the connector can export JSON files independently, its primary purpose is feeding data into CustomGPT.

Modern Web Browser - The dashboard works in Chrome, Firefox, Safari, and Edge (current versions). JavaScript must be enabled for real-time progress updates.

Getting Help​

New to the connector? Start with the Getting Started Tutorial which walks through your first import with screenshots and detailed explanations.

Stuck on something? Check the Troubleshooting Guide for solutions to common issues like failed syncs, missing transcripts, and rate limit errors.

Need technical details? See the API Reference for REST endpoint specifications, authentication details, and response schemas.

Questions not answered here? Open an issue on GitHub or contact support at hello@customgpt.ai.

Next Steps​

Ready to get started? Jump into the Getting Started Tutorial to sync your first collection in 5 minutes.

Want to understand the system first? Read What Is This? for a comprehensive overview of how the connector works and what problems it solves.

Need to deploy your own instance? See the GitHub repository README for deployment instructions on Heroku, Docker, or custom environments.