Start a clipping

curl --request POST \
  --url https://api.postqueen.ai/public/v1/clipping \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://www.youtube.com/watch?v=VIDEO_ID",
  "integrations": [
    "YOUR_CHANNEL_ID"
  ],
  "clips": 3,
  "fit": "blur"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    url: 'https://www.youtube.com/watch?v=VIDEO_ID',
    integrations: ['YOUR_CHANNEL_ID'],
    clips: 3,
    fit: 'blur'
  })
};

fetch('https://api.postqueen.ai/public/v1/clipping', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.postqueen.ai/public/v1/clipping"

payload = {
    "url": "https://www.youtube.com/watch?v=VIDEO_ID",
    "integrations": ["YOUR_CHANNEL_ID"],
    "clips": 3,
    "fit": "blur"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "3f0c2a4e-8b1d-4c6e-9f2a-7d5b1e0c4a93"
}

POST

clipping

Start a clipping

curl --request POST \
  --url https://api.postqueen.ai/public/v1/clipping \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://www.youtube.com/watch?v=VIDEO_ID",
  "integrations": [
    "YOUR_CHANNEL_ID"
  ],
  "clips": 3,
  "fit": "blur"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    url: 'https://www.youtube.com/watch?v=VIDEO_ID',
    integrations: ['YOUR_CHANNEL_ID'],
    clips: 3,
    fit: 'blur'
  })
};

fetch('https://api.postqueen.ai/public/v1/clipping', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.postqueen.ai/public/v1/clipping"

payload = {
    "url": "https://www.youtube.com/watch?v=VIDEO_ID",
    "integrations": ["YOUR_CHANNEL_ID"],
    "clips": 3,
    "fit": "blur"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "3f0c2a4e-8b1d-4c6e-9f2a-7d5b1e0c4a93"
}

A clipping runs in the background and takes several minutes. This endpoint starts it and answers at once with its id. Follow it with Get a clipping. What the clips look like and how they are picked: Clipping.

curl -X POST "https://api.postqueen.ai/public/v1/clipping" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=VIDEO_ID", "integrations": ["YOUR_CHANNEL_ID"], "clips": 3, "fit": "blur"}'

{ "id": "3f0c2a4e-8b1d-4c6e-9f2a-7d5b1e0c4a93" }

The fields

Field	Default	What it does
`url`	Required	A YouTube video, on `youtube.com` or `youtu.be`
`integrations`	None	Up to 20 channel ids from List channels. Every clip becomes a draft on each of them. Without any, the clips only land in the media library
`clips`	`5`	The most clips to make, 1 to 10. A video with fewer good moments gives fewer
`fit`	`blur`	How the horizontal picture fills the vertical clip. `blur` keeps the whole picture over a blurred copy of itself. `crop` fills the frame with the middle of the picture and cuts the sides away, with no face tracking

The drafts are never scheduled or published. Each clip’s drafts take the next free time from your posting times, with the network settings left empty: add what the network needs before you schedule them.

Minutes

A clipping uses one clipping minute for each started minute of the video, however many clips it makes. They are taken once PostQueen knows how long the video is, and given back if no clip is made. See Clipping minutes.

If it fails

Answer	What to do
`400` with a `message` list	A field is missing or out of range. The list says which
`400 Only YouTube videos can be clipped`	Send a `youtube.com` or `youtu.be` link
`400 Channel {id} not found`	One of the `integrations` is not a channel in your workspace, or was deleted. Check it with List channels
`402`	No clipping minutes are left this month. The body has the billing link
`406 Clipping is not available in trial mode`	Clipping is not part of the free trial
`429 Another clipping is being started`	Two requests arrived at the same moment. Wait a few seconds and send it again
`429 A clipping is already running, wait for it to finish`	Poll the running clipping until it is `completed` or `failed`, then start the next one
`429 Too many clippings were started today, try again tomorrow`	Starts are counted over the last 24 hours. Try again later
`503 Clipping is not configured`	Clipping is not available on PostQueen yet
`503 Clipping is not available`	The clipping could not be started. Try again later

These 429 answers come from clipping itself, not from an hourly limit, so they carry no Retry-After header. A problem found after the start, such as a private video or one longer than your minutes, does not fail this request. It ends the clipping as failed, with the reason in error on Get a clipping.

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.

Body

application/json

url

string<uri>

required

A YouTube video, on youtube.com or youtu.be

integrations

string[]

Channel ids to draft every clip on. Without any, the clips only land in the media library

Maximum array length: 20

clips

integer

default:5

The most clips to make. A video with fewer good moments gives fewer

Required range: 1 <= x <= 10

fit

enum<string>

default:blur

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

Available options:

blur,

crop

Response

Started. The clipping runs in the background

string

The clipping's id, for GET /clipping/{id}

Last modified on September 23, 2026

Get started

Endpoints

Posting settings by network

Build on PostQueen

SDK and no-code

Start a clipping

The fields

Minutes

If it fails

Authorizations

Body

Response

​The fields

​Minutes

​If it fails

Authorizations

Body

Response

The fields

Minutes

If it fails