API Docs
Koala AI has a REST API for articles, chat, images, editing, internal links and brands, plus an MCP server for AI assistants. Every paid plan can use the API, and requests draw from the same words and credits as the app. The full reference is at koala.sh/pages/api-docs.
Get an API key
- Make sure you're on a paid plan. The free trial can't create API keys.
- Go to your Account page and find API Keys.
- Click Add API Key and copy the key.
Send the key on every request as Authorization: Bearer YOUR_API_KEY. The base URL is https://koala.sh/api/. Treat the key like a password, since anyone who has it can spend your account's words and credits.
Our APIs
API | What it does | Docs |
|---|---|---|
KoalaWriter API | Creates SEO articles (v2, the only version that writes with your Brand DNA brands). Billed in words, as in the app. | |
KoalaWriter API v1 (legacy) | The older | |
KoalaChat API | Chat completions with the KoalaChat models. 1 credit per request on the default model; larger models cost more. | |
KoalaImages API | Generates images from a prompt and style. Credits per image depend on the model and quality. | |
Polish API | Edits finished content for readability and flow. Professional plan and higher. | |
Internal Linking API | Adds internal links from one of your KoalaLinks sites to any text you send. 1 credit per request, Professional plan and higher. | |
Brands API | Creates, updates and deletes Brand DNA brands from your own system. |
Koala AI MCP
The MCP server gives Claude, ChatGPT, Codex, Cursor and other MCP clients direct access to Koala AI's SEO, research and writing tools through one URL: https://koala.sh/api/mcp. Most apps connect by signing in to Koala AI in the browser, and your API key also works. It's included with every paid plan. Setup steps for each app are on koala.sh/mcp and in the help article "How to connect the Koala AI MCP server".
Custom webhooks
To send finished articles to your own CMS or to Zapier or Make, create a Custom Webhook integration on your Account page. Every completed article is POSTed to your endpoint, with an optional HMAC signature you can verify. The payload, retries and test button are documented under Custom Webhooks.
Common errors
- 401 Unauthorized: the key is missing, mistyped or deleted. Check the
Authorization: Bearerheader and copy the key again from your Account page. - 402 Payment Required: your account is out of words or credits for that request. The response text says which.
- 403 Forbidden: your plan doesn't include that API (Polish and Internal Linking need Professional or higher).
Need help?
Send your request (with the API key removed) and the response you got to support.
Updated on: 09/11/2026
Thank you!