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).
| Call | What it does |
|---|---|
GET /api/v1/videos?status=&limit= | Your latest videos. |
GET /api/v1/videos/{id} | One video. |
GET /api/v1/videos/{id}/status | Status, stage, progress (0-100), clip count. |
GET /api/v1/videos/{id}/clips | The clips, best first, with scores and download links. |
GET /api/v1/videos/{id}/transcript | Every word with its start and end time. |
PATCH /api/v1/videos/{id}/config | Change the settings (then regenerate). |
POST /api/v1/videos/{id}/regenerate | Find 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).
| Call | What 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}/render | Render again with the current settings. |
GET /api/v1/clips/{id}/download | A fresh download link. |
POST /api/v1/clips/{id}/share | {"on": true} makes a public share page; false turns it off. |
GET /api/v1/caption-styles | The caption styles (no key needed). |
Social posts
| Call | What it does |
|---|---|
GET /api/v1/social/accounts | Connected 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).
- Claude and ChatGPT apps: add a custom connector with the address
https://your-site/mcp. You'll be asked to sign in and pick a workspace. - Claude Code:
claude mcp add --transport http shortsmith https://your-site/mcp --header "Authorization: Bearer ssk_..." - Cursor and others: the same address with an
Authorization: Bearerheader.
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."