API v1

Publish to YouTube, Instagram and TikTok with an API

Upload a video, pick the networks, schedule it and get notified when it goes out. One key, one contract, the same response on every network.

Get started See the reference

First request

curl https://praeko.app/v1/channels \
  -H "Authorization: Bearer $PRAEKO_KEY" \
  -H "X-Praeko-Contract: en"

Contract v1 · GET /v1/health · search with ⌘K · llms.txt for agents

Developers

Integrate with code

API key, request, your first video, scheduling and webhooks. Examples in curl, JavaScript, Python, PHP, Go, Ruby, C#, Java and HTTPie.

Open the walkthrough →AI agents

Use it with my AI agent

Instructions for Claude Code, Codex, Cursor, Gemini CLI, Windsurf (Devin) and others: the rules file, the starter prompt and the check.

Choose my agent →MCP server

Connect over MCP

One address, praeko.app/mcp: the agent reads these docs and operates your account, with a two-step confirmation before it publishes.

See the tools →

Most visited

Create a key and pick a scoperead, write, admin POST/v1/posts Publish a video end to end Webhooks and HMAC signature Error codes MCP serverpraeko.app/mcp SDK and CLInpm, yarn, pnpm, bun openapi.jsonlive

Looking for an endpoint?

There are 79 routes in 18 resources, all in the reference. The openapi.json file carries the same contract for your client generator.

Open the reference openapi.json

All sections

Get started

Key, first request, your first video, media, scheduling and a webhook.

API reference

79 routes in 18 resources.

Guides

Publish a video end to end; Upload media: single file and parts; Webhooks: events, signatures and retries; Metrics, retention and CTR; Errors and limits; Retry a request without duplicates.

Authentication, errors and limits

Bearer key, scopes, error envelope and limits.

AI agents

18 agents and automation tools, with MCP, rules and a starter prompt.

MCP server

praeko.app/mcp.

SDK and CLI

@praeko/sdk, @praeko/cli.

Changelog

API changes.