Mr. Usage › Serpstat

Check how much of your Serpstat plan is left

Mr. Usage reads Serpstat's documented usage endpoint with your own key and keeps a card refreshed on its own. Main number: API credits left, out of the plan's maximum. Serpstat counts one credit per result line, so a 100-row report costs 100 credits. Details: credits used this period, and extension credits left. Serpstat reports no renewal date.

Install Mr. Usage GitHub repository

What the Serpstat card shows

Main number: API credits left, out of the plan's maximum. Serpstat counts one credit per result line, so a 100-row report costs 100 credits. Details: credits used this period, and extension credits left. Serpstat reports no renewal 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 credits (result lines). The stats call itself is free.

What Mr. Usage reads

Call`POST https://api.serpstat.com/v4/?token=<key>` (fixed body, method `SerpstatLimitsProcedure.getStats`)
Authentication`token` query parameter (the only documented way).
Verified againsthttps://api-docs.serpstat.com/docs/serpstat-public-api/p2grcut8yurv0-get-stats
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 Serpstat usage cost credits?

the docs say the method does not spend API credits.

Where does my Serpstat 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