Get Vimeo video
Get a Vimeo video: title, description, dates, tags, thumbnails, owner, embed permission and public counts.
Headers
Get your API keyAPI key (`sfk_...`)
Vimeo video id, e.g. `76979871`.
pattern: ^[1-9]\d{0,18}$
Endpoint-specific response payload.
Whether the entity was found. A removed, private, password-protected or never-existing item is `not_found`; Vimeo does not distinguish them.
one of: found, not_found
The video when found; otherwise null.
Video id.
≥ 0
Video page URL.
Title.
Description as plain text; null when empty.
Description as Vimeo formats it, line breaks included; null when it is empty.
When the video was uploaded, converted to UTC from Vimeo's US Eastern time.
When the record was last changed.
When the owner says the video was released.
Length in whole seconds.
≥ 0
Source width in pixels.
≥ 0
Source height in pixels.
≥ 0
Derived from width and height.
one of: landscape, portrait, square, null
Tags, without the leading separator.
Vimeo category names.
Language code the owner set.
Licence the owner set.
Vimeo content-rating labels.
The video's privacy settings.
Who may watch: `anybody`, `ptv` and similar.
Embedding permission: `public`, `private` or `whitelist`.
Who may comment: `anybody` and similar.
Where the video may be embedded.
one of: anywhere, approved, nowhere, null
Thumbnails in the sizes Vimeo offers.
Thumbnail, 100x75.
Thumbnail, 200x150.
Thumbnail, 640 pixels wide.
Thumbnail without a size suffix.
The user a record belongs to.
Vimeo user id.
≥ 0
Display name.
Vanity handle, or the `user<id>` form.
Profile page URL.
Avatars when the row carries them; null when the list row does not.
Square avatar, 30 pixels.
Square avatar, 75 pixels.
Square avatar, 100 pixels.
Square avatar, 300 pixels.
The avatar without a size suffix.
Profile-page portrait, 360 pixels.
Counts. Hidden counts are null, not zero.
Plays, or null when the uploader hides stats.
≥ 0
Likes, or null when the uploader hides stats.
≥ 0
Comments, or null when the uploader hides stats.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/vimeo/videos/76979871" \
-H "x-api-key: YOUR_API_KEY"Responses
Vimeo video.