Vimeo Video Embed API reference
Your first 10 calls are free, no card needed. Pricing and FAQ
Get a free API keycurl "https://api.insightsocial.app/v1/vimeo/video/embed?video_id=<video_id>" \ -H "x-api-key: $INSIGHTSOCIAL_API_KEY"
Get a Vimeo embed: iframe markup, size, thumbnail and the owner's account type; restricted when embedding is off.
Beta. The source's own structure under our naming rules (snake_case keys, string ids, ISO times where the source gives a timestamp), not one of the schema-2 entities. Fields may change. See Beta endpoints.
20 credits per call.
Authorization
apiKey Your key from the dashboard. It starts with isk_.
In: header
Query Parameters
Vimeo video id, e.g. 76979871.
Maximum width of the embed, in pixels.
1 <= value <= 4096Maximum height of the embed, in pixels.
1 <= value <= 4096Fixed width of the embed, in pixels.
1 <= value <= 4096Unlisted-video hash, when the video was shared with one.
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.
Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.
Value in
- "1"
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.insightsocial.app/v1/vimeo/video/embed?video_id=string"{ "success": true, "platform": "string", "endpoint": "string", "schema_version": "2", "pagination": { "next_cursor": "string", "has_more": true, "page_size": 0, "stopped_at": "since" }, "unavailable": [ "string" ], "credits_used": 0, "credits_remaining": 0, "request_id": "string", "cached": true, "idempotent_replay": true, "charge_reason": "string", "free_call": true, "data": { "property1": null, "property2": null }}