Vimeo

Upload videos with privacy, folder, license and thumbnail settings.

API id: vimeo

At a glance

TitleOptional, up to 128 characters. Send it as channels[].title.
Description5,000 characters (the block's content)
Files per postExactly 1 video
File needed?Yes
ThreadsNo
Edit after publishYes — description, title and options
Delete after publishYes
AnalyticsViews, likes, comments
CommentsNot yet

Files

  • Video only: MP4 or MOV.

Options

KeyTypeWhat it does
privacy_viewchoiceWho can watch: anybody (default), unlisted or nobody.
privacy_commentschoiceWho can comment: anybody, contacts or nobody. Default: your account setting.
privacy_downloadtrue / falseShows a download button. Needs a paid Vimeo plan.
licensechoiceA Creative Commons license: by, by-sa, by-nd, by-nc, by-nc-sa, by-nc-nd or cc0. Default: all rights reserved.
folder_urichoicePuts the video in one of the account's folders.
thumbnailmediaA custom poster image (JPEG or PNG). Default: Vimeo picks a frame.

Example

{
  "channelId": "CHANNEL_VIMEO",
  "title": "Product tour",
  "options": { "privacy_view": "unlisted", "license": "by" },
  "blocks": [{ "content": "A 3-minute tour of the new dashboard.", "mediaIds": ["VIDEO_ID"] }]
}

Good to know

  • Your Vimeo app must be granted upload access by Vimeo before anything can be published.
  • If the account hides its play counts, views are not reported.

Set up

To connect accounts, you first need your own app on this platform. See the Vimeo app setup guide.

On this page