> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

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**:

```json theme={"dark"}
[
  {
    "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"
  }
]
```