InsightSocial
GET /v1/vimeo/video/embedbeta

Vimeo Video Embed API

Get a Vimeo embed: iframe markup, size, thumbnail and the owner's account type; restricted when embedding is off.

20 credits a call · single call · failed calls free · 10 free calls to start

curl "https://api.insightsocial.app/v1/vimeo/video/embed?video_id=<video_id>" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "vimeo",
"endpoint": "/v1/vimeo/video/embed",
"schema_version": "2",
"data": {
"<field>": "<value>"
},
"unavailable": [],
"credits_used": "<integer>"
}

Parameters

Query parameters for GET /v1/vimeo/video/embed. Send your key in the x-api-key header.

NameRequiredDescription
video_idYesVimeo video id, e.g. 76979871.
max_widthNoMaximum width of the embed, in pixels.
max_heightNoMaximum height of the embed, in pixels.
widthNoFixed width of the embed, in pixels.
hashNoUnlisted-video hash, when the video was shared with one.
responsiveNoAsk for responsive iframe markup.
autoplayNoAsk for autoplay.
dntNoDo-not-track, as the embed parameter spells it.
bylineNoShow the uploader byline in the player.
portraitNoShow the uploader portrait in the player.
titleNoShow the title in the player.
colorNoPlayer colour as six hex digits, e.g. 00adef.

Response

This endpoint is beta: data holds the platform's own fields under our naming rules (snake_case keys, string ids, ISO times where the platform gives a timestamp) rather than a unified post or profile, and those fields may change.

Every field, error and example is in the Vimeo Video Embed API reference.

How much does the Vimeo Video Embed API cost?

20 credits per successful call.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Know the price first

    Add dry_run=1 and the response quotes the call without making it. Nothing is charged.

  • One balance

    API calls and Chrome extension exports share the same credits, on the free plan too.

Vimeo Video Embed API: frequently asked questions

Send GET /v1/vimeo/video/embed with the video_id parameter and your key in the x-api-key header. Get a Vimeo embed: iframe markup, size, thumbnail and the owner's account type; restricted when embedding is off.