Browse the docs

List videos

Lists your video projects (AI Story, Captions, Reddit, Roblox), newest first: template, title, status, a preview link, the editor link and the last render. Use the projectId with get_video, preview_video, update_video or render_video.

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`
MCP tool	`list_videos`
Scope	`read`
Cost	Free. Works with a read-only key.

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

Parameters

Name	In	Type	Required	Description
`template`	query	string	No	Only look among this template's projects (ai_story, captions, reddit, roblox). One of `ai_story`, `captions`, `reddit`, `roblox`.
`limit`	query	integer	No	How many to return, 1-100. Default 25. 1-100.
`cursor`	query	string	No	`nextCursor` from the previous page. Up to 500 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.
limit
In:
query
Type:
integer
Required:
No
Description:
How many to return, 1-100. Default 25. 1-100.
cursor
In:
query
Type:
string
Required:
No
Description:
nextCursor from the previous page. Up to 500 chars.

Example

curl

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

list-videos.mjs

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

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

Response

200 { data, nextCursor }. Pass nextCursor as cursor for the next page. The item shape is in the OpenAPI spec.

From an MCP client

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

tools/call

{
  "name": "list_videos",
  "arguments": {}
}