Get API Usage

Get the Ahrefs subscription plan and API unit limits, usage and remaining units for the connected workspace and API key, plus the usage reset date and key expiry. Free: this request does not consume API units. Use it to check the remaining allowance before running unit-heavy Ahrefs reports. All Ahrefs tools need a Markifact connection holding an API key from an Ahrefs Lite plan or higher. Tools not marked free consume Ahrefs API units from that plan: at least 50 per request, and more per row for volume, traffic, cost, difficulty and referring-domain fields, so select only the fields you need.


App	Ahrefs
Operation ID	`ahrefs_get_api_usage`
Type	Action
Connection	`ahrefs` (required)
Credits per run	Free
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description

Output

Type: List[Dict] Returns a single row: subscription, units_limit_workspace, units_usage_workspace, units_remaining_workspace, units_limit_api_key (null when uncapped), units_usage_api_key, units_remaining_api_key, usage_reset_date, api_key_expiration_date. Fields: subscription, units_limit_workspace, units_usage_workspace, units_remaining_workspace, units_limit_api_key, units_usage_api_key, units_remaining_api_key, usage_reset_date, api_key_expiration_date Example:

[
  {
    "subscription": "Lite, billed monthly",
    "units_limit_workspace": 100000,
    "units_usage_workspace": 1250,
    "units_remaining_workspace": 98750,
    "units_limit_api_key": null,
    "units_usage_api_key": 1250,
    "units_remaining_api_key": null,
    "usage_reset_date": "2026-10-01T00:00:00Z",
    "api_key_expiration_date": "2027-09-03T04:25:54Z"
  }
]

Get Started

Guides

Operations

Inputs

Output

​Inputs

​Output

Inputs

Output