# Viraloop

> Viraloop generates AI short-form social videos (TikTok, Instagram Reels, YouTube Shorts) from a brand's context and schedules them to connected accounts. This file indexes the machine-readable API surface.

API base URL: https://viraloop.io/api/v1
Auth: Authorization: Bearer vl_live_... (create keys at https://viraloop.io/settings/developers)
OpenAPI spec: https://viraloop.io/openapi/v1.json
Full reference + guides in one file: https://viraloop.io/llms-full.txt

## Docs (raw markdown)

- https://viraloop.io/developers/docs/getting-started.md
- https://viraloop.io/developers/docs/authentication.md
- https://viraloop.io/developers/docs/generations.md
- https://viraloop.io/developers/docs/posts-and-scheduling.md
- https://viraloop.io/developers/docs/campaigns.md
- https://viraloop.io/developers/docs/influencers.md
- https://viraloop.io/developers/docs/credits-and-limits.md
- https://viraloop.io/developers/docs/errors-and-rate-limits.md
- https://viraloop.io/developers/docs/cli.md
- https://viraloop.io/developers/docs/mcp.md
- https://viraloop.io/developers/docs/reference.md

## Tooling

- CLI: npm install -g viraloop (command: viraloop, alias vl)
- MCP (remote): https://viraloop.io/api/v1/mcp with Authorization header
- MCP (local): claude mcp add viraloop -- npx -y viraloop mcp
- Claude Skill: https://github.com/Viraloop/viraloop-skill

## Operations

- GET /me: Introspect the API key (CLI: viraloop whoami)
- GET /credits: Credit balance and ledger (CLI: viraloop credits)
- GET /workspaces: List workspaces (CLI: viraloop workspaces list)
- GET /workspaces/{id}: Get a workspace (CLI: viraloop workspaces get <id>)
- GET /accounts: List connected social accounts (CLI: viraloop accounts list)
- POST /generations: Generate AI post suggestions (CLI: viraloop generate)
- GET /generations: List suggestions (CLI: viraloop generations list)
- GET /generations/{id}: Get a suggestion (CLI: viraloop generations get <id>)
- POST /posts: Create and schedule a post (CLI: viraloop posts create)
- GET /posts: List posts (CLI: viraloop posts list)
- GET /posts/{id}: Get a post with per-platform results (CLI: viraloop posts get <id>)
- DELETE /posts/{id}: Cancel a scheduled post (CLI: viraloop posts cancel <id>)
- GET /calendar: Posting calendar (CLI: viraloop calendar)
- POST /campaigns: Create a campaign (CLI: viraloop campaigns create)
- GET /campaigns: List campaigns (CLI: viraloop campaigns list)
- GET /campaigns/{id}: Get a campaign (CLI: viraloop campaigns get <id>)
- PATCH /campaigns/{id}: Update a draft campaign (CLI: viraloop campaigns update <id>)
- POST /campaigns/{id}/generate: Generate the campaign's posts (CLI: viraloop campaigns generate <id>)
- POST /campaigns/{id}/launch: Launch a reviewed campaign (CLI: viraloop campaigns launch <id>)
- POST /campaigns/{id}/cancel: Cancel a campaign (CLI: viraloop campaigns cancel <id>)
- GET /campaigns/{id}/posts: List a campaign's generated posts (CLI: viraloop campaigns posts <id>)
- GET /influencers: List AI influencers (CLI: viraloop influencers list)
- POST /influencers: Create an AI influencer (CLI: viraloop influencers create)
- GET /influencers/{id}: Get an influencer (CLI: viraloop influencers get <id>)
- POST /influencers/{id}/videos: Generate a talking-head video (CLI: viraloop videos create --influencer <id>)
- GET /influencers/{id}/videos: List an influencer's videos (CLI: viraloop videos list --influencer <id>)
- GET /videos/{id}: Get a video's status (CLI: viraloop videos get <id>)
- GET /assets: List media assets (CLI: viraloop assets list)