Skip to main content
POST
/
clips
/
info
Analyze a video
curl --request POST \
  --url https://api.cut.pro/api/v1/clips/info \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "url": "<string>"
}
'
{
  "video_id": "<string>",
  "title": "<string>",
  "description": "<string>",
  "author": "<string>",
  "platform": "<string>",
  "duration": 123,
  "thumbnail_url": "<string>",
  "credits_cost": 123,
  "credits_original": 123,
  "discount_percent": 123,
  "force_watermark": true,
  "current_balance": 123
}

Authorizations

​
X-Api-Key
string
header
required

Body

​
url
string
required

Public video URL (YouTube, Twitch, Kick, TikTok, etc.)

Response

Response for status 200

​
video_id
string
required

Unique video ID — pass this to POST /clips as video_id

​
title
string
required

Video title

​
description
string
required

Video description

​
author
string
required

Channel or creator name

​
platform
string
required

Source platform — e.g. youtube, twitch, kick, tiktok

​
duration
number
required

Video duration in seconds

​
thumbnail_url
string
required

URL of the video thumbnail

​
credits_cost
number
required

Credits that will be deducted if you submit this video (after any discount)

​
credits_original
number
required

Base credit cost before loyalty or plan discounts

​
discount_percent
number
required

Discount applied as a percentage (0–100). Non-zero for returning users or plan benefits

​
force_watermark
boolean
required

true if generated clips will carry a CutPro watermark — upgrade your plan to remove it

​
current_balance
number
required

Your credit balance at the time of this request

Last modified on April 16, 2026