Get Vimeo embed
Get a Vimeo embed: iframe markup, size, thumbnail and the owner's account type; restricted when embedding is off.
Headers
Get your API keyAPI key (`sfk_...`)
Vimeo video id, e.g. `76979871`.
pattern: ^[1-9]\d{0,18}$
Maximum width of the embed, in pixels.
≥ 1 · ≤ 4096
Maximum height of the embed, in pixels.
≥ 1 · ≤ 4096
Fixed width of the embed, in pixels.
≥ 1 · ≤ 4096
Unlisted-video hash, when the video was shared with one.
pattern: ^[A-Za-z0-9]{4,64}$
Ask for responsive iframe markup.
Ask for autoplay.
Do-not-track, as the embed parameter spells it.
Show the uploader byline in the player.
Show the uploader portrait in the player.
Show the title in the player.
Player colour as six hex digits, e.g. `00adef`.
pattern: ^[0-9a-fA-F]{6}$
Endpoint-specific response payload.
`found` when an embed is available; `restricted` when the owner has embedding switched off; `not_found` when the video is gone.
one of: found, not_found, restricted
Video id.
≥ 0
Embed data; null when the video is not found.
Ready-made iframe markup, when embedding is allowed.
Iframe width.
≥ 0
Iframe height.
≥ 0
Embed thumbnail URL.
Embed thumbnail with a play overlay.
Set to 403 when the video is restricted to other domains.
The author, as the embed record names them.
Author name.
Author profile URL.
`free`, `plus`, `pro`, `business` or `enterprise`.
Title the embed record carries.
Description the embed record carries.
Upload time the embed record carries.
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/embed" \
-H "x-api-key: YOUR_API_KEY"Responses
Vimeo embed.