Skip to main content
GET
Get a clipping
Ask again every few seconds with the id from Start a clipping until status is completed or failed: A completed clipping can still have failed clips, and an error when something went wrong after the clips were made, such as the draft posts.

The clips

clips lists them in the order they appear in the video. Each has: title and content are written from somebody else’s video, in its language. Show them to a person before you post them. An id that is not a clipping of your workspace answers 404 Clipping not found.

Authorizations

Authorization
string
header
required

Your API key from Connections > API Keys, or an OAuth access token (pos_...). Send it as it is, with no Bearer prefix.

Path Parameters

id
string
required

The clipping's id from POST /clipping

Response

The clipping and its clips

id
string
url
string

The video's link, as it was sent

status
enum<string>
Available options:
analysing,
transcribing,
picking,
rendering,
completed,
failed
error
string | null

Why the clipping failed, or what went wrong after its clips were made

title
string | null

The video's title, once it is analysed

thumbnail
string | null

The video's thumbnail, once it is analysed

duration
integer | null

The video's length in seconds, rounded up, once it is analysed

createdAt
string<date-time>
clips
object[]

The clips, in the order they appear in the video. Empty until the moments are picked

Last modified on September 23, 2026