REST API
87 endpoints under https://looptake.com/api/v1. Scoped keys, one envelope, idempotent writes.
API referenceBuild viral videos from code
Everything in the app is in the API: generate, edit, schedule and auto-post short-form video to TikTok, Reels and Shorts. Use REST, the CLI or MCP.
First request
Generate three video ideas
export LOOPTAKE_API_KEY="lt_live_…"
# Video ideas with hooks, scripts and captions. Free.
curl -X POST "https://looptake.com/api/v1/generations" \
-H "Authorization: Bearer $LOOPTAKE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"count": 3, "prompt": "Why most small shops run out of stock in September"}'
# Or from a terminal
npx looptake generate --count 3 --prompt "Why most small shops run out of stock in September"Four ways in
Same API, same scopes, same errors.
CLI
npx looptake. One command per endpoint, with --json, --wait and stable exit codes.
CLI docsHosted MCP
Streamable HTTP at https://looptake.com/mcp. Authorization: Bearer with your API key. 62 tools.
Connect a clientLocal MCP
npx @looptake/mcp over stdio, key in LOOPTAKE_API_KEY. Same tools, key stays local.
Local setupDocumentation
Start here
Getting started
From API key to a scheduled short-form video in five requests.
Authentication and scopes
Keys belong to a team and carry a fixed set of scopes.
Create and post
Generations
A generation is a video idea: hook, caption, hashtags, hook score and, for template formats, the deck that renders it.
Posts and scheduling
One endpoint creates a post for any mix of connected accounts and reports one result per account.
Automations
An automation is a cadence plus target accounts. It generates a whole run and publishes nothing until you launch it.
AI avatars and influencers
Create a presenter once and render talking-head videos from it. Renders are asynchronous and priced per second.
Operate
Credits and plan limits
Credits pay for AI media only. Scripts, editing, scheduling and posting are free.
Errors and rate limits
Every failure is one of 9 types. Branch on the type, never on the message.
Webhooks
Signed events sent to a URL you own. Delivery is at least once.
CLI and MCP
The Looptake CLI
One npm package, one binary, a command for every endpoint.
MCP server
The Looptake API as MCP tools. Hosted over HTTP or local over stdio, with the same scopes as your key.
Reference conventions
Rules that hold for every endpoint. Learn them once, then read the reference as tables.
Reference
Full API reference
All 87 endpoints in 15 groups, with scopes, costs, parameters and examples.
For AI agents
llms.txt, llms-full.txt, OpenAPI and MCP in one place.
Developer questions
Is the API on every plan?
Yes. The REST API, CLI and MCP server are on every paid plan, with no extra fee.
What costs credits?
Only AI media. Free: hooks and scripts, text and slideshow formats, editing and captions, scheduling and auto-posting, analytics and reports. See credits and limits.
Hosted or local MCP?
Hosted needs no install: point the client at https://looptake.com/mcp with your key as a Bearer token. Local runs npx @looptake/mcp so the key never leaves your machine.
Is there an OpenAPI document?
Yes, at /openapi/v1.json. It, this documentation and /llms-full.txt are generated from one registry.