# Vimeo API: Get video details

> Gets a public Vimeo video's title, creator, play, like and comment counts, length, upload date, description, tags, thumbnail and link from its video link.

Unofficial. Not affiliated with or endorsed by Vimeo.

- Page: https://fous.com/methods/vimeo.com/get-video
- Method: `vimeo.com/get_video`, version 1
- Website: vimeo.com
- Returns: title, creator, counts, length, upload date, description, tags, thumbnail, link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `video` | string | yes | `"https://vimeo.com/22439234"` | A Vimeo video link, for example https://vimeo.com/76979871. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "video": "https://vimeo.com/22439234"
}
```

Its output:

```json
{
  "tags": [
    "hd",
    "tenerife",
    "sky"
  ],
  "title": "The Mountain",
  "length": "3:05",
  "video_id": "22439234",
  "like_count": 104322,
  "play_count": 79264867,
  "video_link": "https://vimeo.com/22439234",
  "description": "Follow on:\n\nhttps://facebook.com/TSOphotography for more photos, videos and updates.\n\nThis was filmed between 4th and 11th April 2011. I had the pleasure of visiting El Teide.\n\nSpain´s highest mountain  @(3718m) is one of the best places in the world to photograph the stars and is also the location …",
  "upload_date": "2011-04-15",
  "creator_name": "TSO Photography",
  "comment_count": 2736,
  "length_seconds": 185,
  "creator_profile_link": "https://vimeo.com/terjes",
  "thumbnail_image_link": "https://i.vimeocdn.com/video/145027281-cf3e3e047a52e2210b26bbcf42fcde909a80a7dd023a757b95af01936d065ec0-d_640?region=us"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"vimeo.com/get_video","input":{"video":"https://vimeo.com/22439234"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Can you pull up the title, uploader, and view count for https://vimeo.com/76979871?
- How long is this Vimeo clip and when was it uploaded? https://vimeo.com/443028721
- I need the description, tags, and thumbnail for a Vimeo video at vimeo.com/318426907
- What are the like and comment counts on this video: https://vimeo.com/604512389
- Grab the creator name and runtime for the Vimeo link https://vimeo.com/120853967 so I can cite it

## Input schema

```json
{
  "type": "object",
  "required": [
    "video"
  ],
  "properties": {
    "video": {
      "type": "string",
      "description": "A Vimeo video link, for example https://vimeo.com/76979871."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "title",
    "creator_name",
    "creator_profile_link",
    "play_count",
    "like_count",
    "comment_count",
    "length",
    "upload_date",
    "description",
    "tags",
    "thumbnail_image_link",
    "video_link",
    "video_id",
    "length_seconds"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Video tags."
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "Video title."
    },
    "length": {
      "type": [
        "string",
        "null"
      ],
      "description": "Video length in minutes and seconds, or hours, minutes and seconds."
    },
    "video_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "Vimeo video ID.",
      "x-fous-developer": true
    },
    "like_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Number of likes, or null when hidden."
    },
    "play_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Number of plays, or null when hidden."
    },
    "video_link": {
      "type": [
        "string",
        "null"
      ],
      "description": "Link to the video on Vimeo."
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Video description as plain text."
    },
    "upload_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Date the video was uploaded (YYYY-MM-DD)."
    },
    "creator_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Name of the video creator."
    },
    "comment_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Number of comments, or null when hidden."
    },
    "length_seconds": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Video length in seconds.",
      "x-fous-developer": true
    },
    "creator_profile_link": {
      "type": [
        "string",
        "null"
      ],
      "description": "Link to the creator’s Vimeo profile."
    },
    "thumbnail_image_link": {
      "type": [
        "string",
        "null"
      ],
      "description": "Link to the video thumbnail image."
    }
  },
  "additionalProperties": false
}
```

## See more

- [YouTube API: Get video](https://fous.com/methods/youtube.com/get-video.md): Gets public details and statistics for one YouTube video by link, ID or title. A title selects the top search match.
- [TikTok API: Get video](https://fous.com/methods/tiktok.com/get-video.md): Gets details and engagement statistics for one public TikTok video from its link, including vm.tiktok.com short links: creator, caption, hashtags, posting time, views, likes, comments, shares, length and sound.
- [Bilibili API: Get video](https://fous.com/methods/bilibili.com/get-video.md): Gets public statistics and details for a Bilibili video from its link, BV number or title. A title selects the top video search match. Category may be missing when Bilibili does not show a label.
- [YouTube API: Get video comments](https://fous.com/methods/youtube.com/get-video-comments.md): Gets public top-level comments on a YouTube video, found by link, video ID or title. Reply text is not included.
- [YouTube API: Get video transcript](https://fous.com/methods/youtube.com/get-video-transcript.md): Returns the spoken captions and timed segments of a YouTube video, given a video link or a title (top search match). Only captions the video has are returned.
- [Pexels API: Search videos](https://fous.com/methods/pexels.com/search-videos.md): Finds free stock videos on Pexels by search words, with creator, duration, preview image and a direct MP4 link, in Pexels search order starting at the chosen results page.
- [SoundCloud API: Get track](https://fous.com/methods/soundcloud.com/get-track.md): Gets a public SoundCloud track and its stats from a title and optional artist, or from a track link. Search picks the artist's matching upload with the most plays; unavailable fields are null.
- [YouTube API: List channel videos](https://fous.com/methods/youtube.com/list-channel-videos.md): Lists a YouTube channel's public videos, Shorts, or live uploads, newest first or most popular first, along with channel details. Counts and dates taken from displayed text may be approximate.