Install
Package looptake on npm, binary looptake. Needs Node 22 or later.
Install
# No install
npx looptake --help
# Or install the looptake binary
npm i -g looptakeLog in
Auth
looptake login # prompts for the key, verifies it, stores it
looptake whoami # team, plan, credits, scopes
looptake logout
# CI: no login needed
export LOOPTAKE_API_KEY="lt_live_…"Create and post
Account flags (--tiktok, --instagram, --youtube) take ids from looptake accounts list. --wait polls until the job ends.
Generate and schedule
looptake generate --count 5 --prompt "September launch" --json
looptake generations get 6522d1ec-2c11-4d3a-b078-6f6cfe9f217b --json
looptake posts create \
--suggestion-id 6522d1ec-2c11-4d3a-b078-6f6cfe9f217b \
--tiktok ff9d429b-07c5-4320-a98c-ac6e1791b828 \
--youtube 1c74c860-000b-4136-88a7-a17f31019346 \
--at 2026-09-01T15:00:00Z --timezone Europe/Lisbon \
--waitCommands
One command per endpoint. Run looptake <command> --help for flags.
| Command | Does |
|---|---|
looptake login | logout | whoami | Store, remove and check the key. |
looptake generate | Generate video ideas. Free. |
looptake generations list | get | accept | variants | Read, accept and A/B ideas. |
looptake posts create | preview | import | list | get | edit | reschedule | publish | cancel | Schedule, check and change posts. |
looptake calendar | Posts grouped by local day. |
looptake automations create | generate | posts | launch | extend | pause | resume | cancel | Run a month of posts. |
looptake influencers list | create | get | render | videos | delete | AI avatars and talking-head videos. |
looptake content <render> | status | download | Start any of the 14 studio renders, poll and download. |
looptake workspaces list | create | get | update | archive | restore | default | Brands and client workspaces. |
looptake accounts list | Connected TikTok, Instagram and YouTube accounts. |
looptake assets list | create | update | delete | The media library. |
looptake analytics overview | posts | export | share | revoke | Performance and shared reports. |
looptake credits | trends | Ledger and the daily trend library. |
looptake webhooks list | create | update | delete | Webhook endpoints. |
looptake brand analyze | clear | Rebuild the brand context from a website. |
looptake mcp | Start the local MCP server with the stored key. |
Scripting
--json: only data on stdout. Progress and warnings go to stderr.--waitand--timeout: block until a 202 job finishes.--dry-run: print the request and send nothing.- Writes that spend or publish get an
Idempotency-Keyautomatically, kept across retries.
Examples
# Pick the best hook from a fresh batch and post it now
best=$(looptake generate --count 10 --json | jq -r 'max_by(.score).id')
looptake posts create --suggestion-id "$best" \
--tiktok ff9d429b-07c5-4320-a98c-ac6e1791b828 --schedule asap --wait
# See the request without sending it
looptake posts cancel 973821cf-5cc7-44f7-8795-e68da31c59ef --dry-runExit codes
| Code | Meaning |
|---|---|
| 0 | Success. |
| 1 | Server or network failure, or a job that ended failed. |
| 2 | Bad usage or invalid_input. |
| 3 | unauthorized or forbidden_scope. |
| 4 | not_found. |
| 5 | conflict. |
| 6 | insufficient_credits. Nothing charged. |
| 7 | usage_limit_reached. A plan quota; retrying does not help. |
| 8 | rate_limited after Retry-After. Try later. |
| 9 | --wait timed out. The job is still running: do not re-run, poll it. |
Config
Config
# ~/.config/looptake/config.json (or $XDG_CONFIG_HOME/looptake), written by login, mode 0600
# Precedence: flag > environment > config file
export LOOPTAKE_API_KEY="lt_live_…"
export LOOPTAKE_API_BASE="https://looptake.com/api/v1"