Mr. Usage › Ahrefs

Check what you have left at Ahrefs

Mr. Usage reads Ahrefs's documented usage endpoint with your own key and keeps a card refreshed on its own. Main number: API units left, out of this key's monthly limit. A key with no limit of its own counts against the workspace pool instead. Details: the reset date, workspace usage, units used by this key, and the key's expiry date.

Install Mr. Usage GitHub repository

What the Ahrefs card shows

Main number: API units left, out of this key's monthly limit. A key with no limit of its own counts against the workspace pool instead. Details: the reset date, workspace usage, units used by this key, and the key's expiry date. A yellow "Low" badge appears under 20% left and a red "Nearly out" badge under 5%, with a line of today's readings underneath.

Counts API units. Shows this key's own monthly limit when it has one, otherwise the workspace's.

What Mr. Usage reads

Call`GET https://api.ahrefs.com/v3/subscription-info/limits-and-usage?output=json`
Authentication`Authorization: Bearer` header.
Verified againsthttps://docs.ahrefs.com/en/api/reference/subscription-info/get-limits-and-usage
Anything else contactedNothing. The host is on a per-provider allowlist checked before every request, redirects are off, and the connection is TLS 1.2 or newer.

The app shows you this exact address before you save a key, and docs/SOURCES.md records where each fact came from and when it was read.

Questions

Does checking my Ahrefs usage cost credits?

the docs say the call is free and consumes no API units.

Where does my Ahrefs API key go?

Into your operating system's credential store, under the service name mr-usage: Keychain on macOS, Credential Manager on Windows, the Secret Service on Linux. The app reads it at the moment it calls the vendor, wraps it in a zeroizing type, and drops it. It is never written to a file of the app's own and never sent back to the window.

How often is the card refreshed?

Every 5 minutes by default. Settings lets you pick anything from 1 minute to 24 hours, and changing the interval takes effect from the last poll. There is also a Refresh button on each card, limited to once a minute.

Other providers