> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/vimeo/videos-videoid>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/vimeo/videos-videoid.mdx>

---

# Vimeo Video API

One video with the fields you need to list, filter or embed it: text, dates, tags, thumbnails, owner, privacy and public counts.

`GET /v1/vimeo/videos/{videoId}` takes a digits-only video id such as `76979871`. On `found`, `data.video` carries the identity (`id`, `url`), the text (`title`, `description`, `descriptionHtml`), the dates (`uploadedAt`, `modifiedAt`, `releasedAt`), technical facts (`durationSeconds`, `width`, `height`, `orientation`) and discovery fields (`tags`, `categories`, `language`, `license`).

The record also carries `thumbnails` in four sizes, `owner` with id, name, handle, URL and avatar, `privacy` with `view`, `embed` and `comments`, `embedPermission` (`anywhere`, `approved` or `nowhere`) and `stats` with `plays`, `likes` and `comments`. A hidden count is null, not zero. If the video is gone, private or password protected, `lookupStatus` is `not_found` and `video` is null.

## Request

- **Endpoint:** `GET /v1/vimeo/videos/{videoId}`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by video id
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/vimeo/videos/videoid/get)
- **Platform page:** [/platforms/vimeo](https://www.socialfetch.dev/platforms/vimeo)

## FAQ

### What does a found video include?

The video record: id, url, title, description and descriptionHtml, uploadedAt, modifiedAt, releasedAt, durationSeconds, width, height, orientation, tags, categories, language, license, contentRating, privacy, embedPermission, thumbnails, owner and stats. Fields Vimeo does not send are null rather than missing.

### Why are plays or likes null?

An uploader can hide public stats. A hidden count comes back as null, not zero, so you can tell hidden from never counted. The same applies to comments in stats.

### What happens for a private or missing video?

lookupStatus is not_found and video is null. Vimeo does not tell removed, private, password-protected and never-existing videos apart, so the response reports the same typed status for all of them. HTTP 200 only means the request finished.

### How many credits does a video lookup cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.