Clipping

Start a clipping

Changed on

Turn a long YouTube video into short vertical clips with burned-in captions. The best parts are picked automatically, every clip is saved to the media library, and when integrations are passed a draft post is created for every clip on every integration. Nothing is scheduled or published.

Clipping takes several minutes, so this only starts it and returns the clipping id. Poll Get a clipping until the status is completed or failed.

post/clipping

Request

  • Base URL
    https://api.postiz.com/public/v1
  • Auth
    API key in header Authorization

Request body

urlstring uri required

URL of the YouTube video (youtube.com or youtu.be)

integrationsstring[]

IDs of the integrations to create a draft post for, one draft per clip per integration. Without any, the clips only land in the media library

clipsinteger

Maximum number of clips

fit'blur' | 'crop'

How the horizontal video fills the vertical clip. blur keeps the whole picture over a blurred copy of itself. crop fills the clip with the middle of the picture and cuts the sides away; there is no face tracking

Response

Clipping started

idstring

ID of the clipping

Changes