API and MCP

Everything the app does is available over a small JSON API, and to AI assistants through MCP. Base address: the address of this site, for example https://your-site/api/v1/....

Keys

Create a key in Settings → API keys. A key works for one workspace. Send it as a bearer token:

curl https://your-site/api/v1/videos -H "Authorization: Bearer ssk_..."

Errors come back as {"error": "message"} with a 4xx or 5xx status. 402 means the plan's limit was reached.

Videos

POST /api/v1/videos

Send a link (or an upload, see below). Processing starts at once.

curl -X POST https://your-site/api/v1/videos -H "Authorization: Bearer ssk_..." -H "Content-Type: application/json" -d '{
  "url": "https://www.youtube.com/watch?v=...",
  "config": {
    "clipType": "viral-clips",          // viral-clips | highlights | tutorials
    "genre": "Podcast",                 // Auto | Podcast | Gaming | Education | Entertainment
    "aspectRatio": "9:16",              // 9:16 | 1:1 | 16:9
    "layout": "fill",                   // fill | fit | square | split
    "clipDurationMin": 15, "clipDurationMax": 90,
    "captionTemplateId": "spotlight",   // GET /api/v1/caption-styles
    "enableCaptions": true, "enableIntroTitle": true, "enableSmartCrop": true,
    "language": "en",                   // leave out to detect
    "customPrompt": "find the strongest opinions",
    "topicKeywords": ["pricing", "hiring"],
    "timeframeStart": 60, "timeframeEnd": 1800,
    "splitRatio": 50, "background": "gradient"
  }}'

Returns the video with its id and status: pending → downloading → transcribing → analyzing → completed (or failed, with error).

CallWhat it does
GET /api/v1/videos?status=&limit=Your latest videos.
GET /api/v1/videos/{id}One video.
GET /api/v1/videos/{id}/statusStatus, stage, progress (0-100), clip count.
GET /api/v1/videos/{id}/clipsThe clips, best first, with scores and download links.
GET /api/v1/videos/{id}/transcriptEvery word with its start and end time.
PATCH /api/v1/videos/{id}/configChange the settings (then regenerate).
POST /api/v1/videos/{id}/regenerateFind the clips again (reuses the transcript).
DELETE /api/v1/videos/{id}Delete the video and its clips.
GET /api/v1/validate-url?url=Title and channel of a link before sending it.

Uploading a file

Big files go in pieces so a bad connection doesn't lose the upload:

POST /api/v1/uploads           {"filename": "talk.mp4", "size": 734003200}   -> {"id": "upl_...", "chunkSize": 8388608}
PUT  /api/v1/uploads/{id}?offset=0      (raw bytes of the first piece)        -> {"received": 8388608}
PUT  /api/v1/uploads/{id}?offset=8388608 ...
POST /api/v1/uploads/{id}/complete
POST /api/v1/videos            {"uploadId": "upl_...", "config": {...}}

Clips

Each clip has viralScore (0-100) and scores (hook, pacing, engagement; the score is 40% hook, 35% pacing, 25% engagement), title, hookTitle, hashtags, start/end in the original video, transcript, and status (pending, rendering, ready, failed). Ready clips include downloadUrl (valid for 6 hours).

CallWhat it does
GET /api/v1/clips/{id}One clip.
PATCH /api/v1/clips/{id}Edit and render again: title, hashtags, start, end, style, layout, aspect, captions, upper, fontScale, captionY, hookTitle, hookText, smartCrop, splitRatio, background, words ([[text, start, end], ...]).
POST /api/v1/clips/{id}/renderRender again with the current settings.
GET /api/v1/clips/{id}/downloadA fresh download link.
POST /api/v1/clips/{id}/share{"on": true} makes a public share page; false turns it off.
GET /api/v1/caption-stylesThe caption styles (no key needed).

Social posts

CallWhat it does
GET /api/v1/social/accountsConnected YouTube, TikTok and Instagram accounts (connect them in the app).
POST /api/v1/social/posts{"clipId", "accountId", "postType": "immediate" | "scheduled", "scheduledAt": "2026-12-01T18:00:00Z", "title", "caption", "hashtags": [], "privacy": "public" | "unlisted" | "private"}
GET /api/v1/social/posts?status=&clipId=Posts: pending, posting, posted, failed, cancelled.
PATCH /api/v1/social/posts/{id}Change caption, hashtags or scheduledAt of a post that is not out yet.
DELETE /api/v1/social/posts/{id}Cancel it.

MCP (Claude, ChatGPT, Cursor and others)

The MCP server lives at /mcp on this site (streamable HTTP).

Tools: list_workspaces, check_video_link, clip_video, get_video, list_videos, get_clips, get_clip, edit_clip, configure_video, regenerate_video, delete_video, list_caption_styles, list_social_accounts, schedule_post, list_posts, update_post, cancel_post.

Try: "Clip this podcast into shorts about pricing, with the Punch caption style, then schedule the best three on my YouTube for 6 pm on weekdays."