Skip to main content
Log inGet started
Log inGet started
Docs menu

Developers

Build with KiwiRank

The KiwiRank API lets your own code read and act on your website’s KiwiRank data: pull finished articles into your CMS, ask for new ones, and keep your content plan in step with the rest of your marketing.

Who can use it

The API is part of every KiwiRank plan. Scale has higher limits: 240 requests a minute instead of 60, and 50,000 a day. The website’s owner makes the keys.

Make an API key

  1. Open Settings › API & MCP

    Choose the website first: a key belongs to one website.

  2. Name it and pick its access

    Use a name you will recognise in the activity list, such as “Nightly sync”. Read only keys only read; Full access keys can also request articles and change the content plan.

  3. Copy it once

    The key starts with kr_live_ and is shown only once. Store it as a secret on your server, for example in an environment variable.

Shell
export KIWIRANK_API_KEY="kr_live_…"

Keep keys on your server

Anyone with a key can use it until you revoke it. Never put one in a web page, a mobile app or a public repository.

Your first request

Ask for the website the key belongs to. If the key works you get the website and its plan back. The answer below is shortened: Get the website shows all of it.

curl https://kiwirank.com/api/v1/site \
  -H "Authorization: Bearer $KIWIRANK_API_KEY"
Response200 OK
{
  "website": {
    "id": "5f0c2a64-1d3e-4b7a-9c21-7e4d8a6b3f10",
    "name": "Example Co",
    "url": "https://example.com",
    "domain": "example.com"
  },
  "plan": {
    "name": "grow",
    "status": "active",
    "articles": {
      "limit": 30,
      "used": 12,
      "remaining": 18,
      "periodStart": "2026-10-14T00:00:00.000Z",
      "periodEnd": "2026-11-14T00:00:00.000Z"
    }
  }
}

A 401 INVALID_API_KEY means the key is missing, mistyped or revoked. Every other error is listed under Errors.

Next steps