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.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Video, required
video A Vimeo video link, for example https://vimeo.com/76979871.
https://vimeo.com/22439234
Input as JSON
{ "video": "https://vimeo.com/22439234" }Output
{ "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" }Code
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"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "vimeo.com/get_video" , "input": { "video": "https://vimeo.com/22439234" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "vimeo.com/get_video" , "input": { "video": "https://vimeo.com/22439234" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run vimeo.com/get_video# with {"video":"https://vimeo.com/22439234"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "video" ], "properties": { "video": { "type": "string", "description": "A Vimeo video link, for example https://vimeo.com/76979871." } }}Output schema
{ "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}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
vimeo.com/get_video- Returns
- title, creator, counts, length, upload date, description, tags, thumbnail, link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method vimeo.com/get_video with the inputs above.
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
See more
Gets public details and statistics for one YouTube video by link, ID or title. A title selects the top search match.
youtube.com/get_videoGets 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.
tiktok.com/get_videoGets 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.
bilibili.com/get_videoGets public top-level comments on a YouTube video, found by link, video ID or title. Reply text is not included.
youtube.com/get_video_commentsReturns 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.
youtube.com/get_video_transcriptFinds 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.
pexels.com/search_videosGets 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.
soundcloud.com/get_trackLists 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.
youtube.com/list_channel_videos