Articles on: Developers

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


  1. Make sure you're on a paid plan. The free trial can't create API keys.
  2. Go to your Account page and find API Keys.
  3. 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

KoalaWriter API v1 (legacy)

The older /api/articles/ endpoint, for existing integrations.

Legacy v1 docs

KoalaChat API

Chat completions with the KoalaChat models. 1 credit per request on the default model; larger models cost more.

KoalaChat API

KoalaImages API

Generates images from a prompt and style. Credits per image depend on the model and quality.

KoalaImages API

Polish API

Edits finished content for readability and flow. Professional plan and higher.

Polish API

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.

Internal Linking API

Brands API

Creates, updates and deletes Brand DNA brands from your own system.

Brands API


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: Bearer header 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

Was this article helpful?

Share your feedback

Cancel

Thank you!