Browse the docs

Get video

Gets one video project: template, title, status (draft, not_ready, in_progress, rendered), why it cannot be rendered yet, its length, a 7-day preview link, the editor link and the last render (with videoUrl).

Or open inClaude Code Codex Cursor Claude ChatGPT

Paste it into any AI assistant. The shortcuts open with the prompt typed in; nothing is sent until you press enter.

At a glance

Property	Value
REST	`GET https://api.clippie.ai/v1/videos/:projectId`
MCP tool	`get_video`
Scope	`read`
Cost	Free. Works with a read-only key.

REST
GET https://api.clippie.ai/v1/videos/:projectId
MCP tool
get_video
Scope
read
Cost
Free. Works with a read-only key.

Parameters

Name	In	Type	Required	Default	Description
`projectId`	path	string	Yes		The project id: output.projectId of a job, an id from list_videos, or the id in an editor URL. 1-64 chars.
`template`	query	string	No		Only look among this template's projects (ai_story, captions, reddit, roblox). One of `ai_story`, `captions`, `reddit`, `roblox`.

projectId
In:
path
Type:
string
Required:
Yes
Description:
The project id: output.projectId of a job, an id from list_videos, or the id in an editor URL. 1-64 chars.
template
In:
query
Type:
string
Required:
No
Description:
Only look among this template's projects (ai_story, captions, reddit, roblox). One of ai_story, captions, reddit, roblox.

Example

curl

curl "https://api.clippie.ai/v1/videos/PROJECT_ID" \
  -H "Authorization: Bearer $CLIPPIE_API_KEY"

get-video.mjs

const auth = { Authorization: `Bearer ${process.env.CLIPPIE_API_KEY}` };

const res = await fetch('https://api.clippie.ai/v1/videos/PROJECT_ID', { headers: auth });
if (!res.ok) throw new Error((await res.json()).error.message);
console.log(await res.json());

Response

200 with JSON. The full response schema is in the OpenAPI spec.

From an MCP client

Your AI calls get_video with the same fields as JSON arguments. See MCP server to connect one.

tools/call

{
  "name": "get_video",
  "arguments": {
    "projectId": "PROJECT_ID"
  }
}