Submissions

Analyze a video

Fetches metadata for a public video URL and calculates the exact credit cost before you commit to clipping. No credits are charged. Use this as a pre-flight check before calling POST /clips.

When credits_unlimited is true, this workspace is on free usage: credits_cost still tells you what the job is worth, but submitting it will not move your balance.

Rate-limited to 10 requests per minute per user.

post/clips/info

Request

  • Base URL: https://api.cut.pro/api/v1
  • URL: https://api.cut.pro/api/v1/clips/info
  • Auth: API key in header X-Api-Key

Request body

urlstring required

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

Response

Response for status 200

idstring required

Unique video ID. Pass it to POST /clips as video_id

titlestring required

Video title

descriptionstring required

Video description

authorstring required

Channel or creator name

platformstring required

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

durationnumber required

Video duration in seconds

thumbnail_urlstring required

URL of the video thumbnail

credits_costnumber required

Cost of clipping this video, after any discount. Deducted on submit unless credits_unlimited is true

credits_originalnumber required

Base credit cost before loyalty or plan discounts

discount_percentnumber required

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

force_watermarkboolean required

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

current_balancenumber required

Your credit balance at the time of this request

credits_unlimitedboolean required

true while usage is free for this workspace: the job runs without consuming credits and is never rejected for lack of balance

Changes

No recorded changes to this operation across all 1 revision of this API.