# Vimeo

> Upload videos to Vimeo from a link, and look up or manage the videos on your account.

App · Video & Audio · 4 actions. Web page: https://docs.lodol.com/docs/integrations/vimeo

## Actions

### Delete a video

Permanently delete a video from your Vimeo account.

**Inputs**

- Video ID (`video_id`, text, required): The Vimeo video ID to delete, as returned by Upload a video or List videos. A full vimeo.com link works too.

**Outputs**

- `deleted` (true/false): Whether the video was deleted
- `video_id` (text): The video that was deleted

**Example output**

```json
{
  "deleted": true,
  "video_id": "76979871"
}
```

### Get a video

Fetch details for one of your Vimeo videos.

**Inputs**

- Video ID (`video_id`, text, required): The Vimeo video ID, as returned by Upload a video or List videos. A full vimeo.com link works too.

**Outputs**

- `created_time` (text): When the video was created
- `description` (text): The video's description
- `duration` (number): Length of the video in seconds
- `embed_url` (text): Player URL for embedding the video
- `link` (text): Public Vimeo page for the video
- `name` (text): The video's title
- `privacy` (text): Who can view the video, for example 'anybody' or 'nobody'
- `thumbnail_url` (text): URL of the video's largest thumbnail image
- `upload_status` (text): Where the upload has got to, for example 'in_progress' or 'complete'. A pull upload is fetched asynchronously, so this is how you tell whether the video is ready.
- `video_id` (text): Vimeo video ID. Use with Get, Delete, and video links.

**Example output**

```json
{
  "created_time": "2026-07-28T14:15:35+00:00",
  "description": "A walkthrough of the new release.",
  "duration": 62,
  "embed_url": "https://player.vimeo.com/video/76979871",
  "link": "https://vimeo.com/76979871",
  "name": "Product demo",
  "privacy": "anybody",
  "thumbnail_url": "https://i.vimeocdn.com/video/example_1280x720.jpg",
  "upload_status": "complete",
  "video_id": "76979871"
}
```

### List videos

List the videos on your Vimeo account, newest first.

**Inputs**

- Search terms (`query`, text): Optional. Only return videos matching these keywords.
- Maximum videos (`per_page`, number): How many videos to return (1-100). From 1 to 100. Default: `10`.

**Outputs**

- `total` (number): How many videos match in total
- `videos` (list): Videos on the account, newest first

**Example output**

```json
{
  "total": 1,
  "videos": [
    {
      "created_time": "2026-07-28T14:15:35+00:00",
      "description": "A walkthrough of the new release.",
      "duration": 62,
      "embed_url": "https://player.vimeo.com/video/76979871",
      "link": "https://vimeo.com/76979871",
      "name": "Product demo",
      "privacy": "anybody",
      "thumbnail_url": "https://i.vimeocdn.com/video/example_1280x720.jpg",
      "upload_status": "complete",
      "video_id": "76979871"
    }
  ]
}
```

### Upload a video

Upload a video to Vimeo from a link to the video file.

**Inputs**

- Video URL (`video_url`, text, required): A direct link to the video file you want to upload to Vimeo.
- Name (`name`, text): Optional name for the video on Vimeo.
- Description (`description`, text): Optional description to show on Vimeo.

**Outputs**

- `created_time` (text): When the video was created
- `description` (text): The video's description
- `duration` (number): Length of the video in seconds
- `embed_url` (text): Player URL for embedding the video
- `link` (text): Public Vimeo page for the video
- `name` (text): The video's title
- `privacy` (text): Who can view the video, for example 'anybody' or 'nobody'
- `thumbnail_url` (text): URL of the video's largest thumbnail image
- `upload_status` (text): Where the upload has got to, for example 'in_progress' or 'complete'. A pull upload is fetched asynchronously, so this is how you tell whether the video is ready.
- `video_id` (text): Vimeo video ID. Use with Get, Delete, and video links.

**Example output**

```json
{
  "created_time": "2026-07-28T14:15:35+00:00",
  "description": "A walkthrough of the new release.",
  "duration": 62,
  "embed_url": "https://player.vimeo.com/video/76979871",
  "link": "https://vimeo.com/76979871",
  "name": "Product demo",
  "privacy": "anybody",
  "thumbnail_url": "https://i.vimeocdn.com/video/example_1280x720.jpg",
  "upload_status": "in_progress",
  "video_id": "76979871"
}
```