Koala API Documentation

Authentication

All API requests require an API key. You can create API keys in your Settings page. Include your API key in the Authorization header with a Bearer prefix.

Authorization: Bearer your_api_key_here

API keys are managed through Clerk and provide secure, scoped access to your data.

Get Domain Metrics

Retrieve domain authority metrics for your tracked domains.

Endpoint

GET /api/public/metrics

Query Parameters

Parameter	Type	Required	Description
`startDate`	string	Yes	Start date in YYYY-MM-DD format
`endDate`	string	Yes	End date in YYYY-MM-DD format
`domains`	string	No	Comma-separated list of domains. If omitted, returns all your domains.

Example Request

curl -X GET "https://www.koala.fyi/api/public/metrics?startDate=2025-01-01&endDate=2025-11-05&domains=example.com,example2.com" \
  -H "Authorization: Bearer your_api_key_here"

Example Response

{
  "results": [
    {
      "domain": "example.com",
      "data": [
        {
          "date": "2025-01-01",
          "ahrefsDR": 45,
          "mozDA": 38,
          "majesticCF": 42,
          "mozLinks": 1250,
          "ahrefsBacklinks": 3400,
          "majesticLinks": 2800
        },
        {
          "date": "2025-01-02",
          "ahrefsDR": 46,
          "mozDA": 38,
          "majesticCF": 42,
          "mozLinks": 1280,
          "ahrefsBacklinks": 3450,
          "majesticLinks": 2850
        }
      ]
    },
    {
      "domain": "example2.com",
      "data": [
        {
          "date": "2025-01-01",
          "ahrefsDR": 32,
          "mozDA": 28,
          "majesticCF": 30,
          "mozLinks": 520,
          "ahrefsBacklinks": 980,
          "majesticLinks": 750
        }
      ]
    }
  ]
}

Response Fields

Authority Metrics

Field	Type	Description
`ahrefsDR`	number \| null	Ahrefs Domain Rating (0-100)
`mozDA`	number \| null	Moz Domain Authority (0-100)
`majesticCF`	number \| null	Majestic Citation Flow (0-100)

Backlink Metrics

Field	Type	Description
`ahrefsBacklinks`	number \| null	Total backlinks from Ahrefs
`mozLinks`	number \| null	Total links from Moz
`majesticLinks`	number \| null	Total links from Majestic

Error Responses

Status Code	Description
401	Missing or invalid API key
403	Unauthorized domain access
400	Invalid parameters
500	Server error

Rate Limits

API requests are rate limited to prevent abuse. Current limits:

100 requests per minute
10,000 requests per day