Credits
How Toolzer Hub API credits work: most routes cost one credit, failed calls cost nothing, and one request checks your remaining balance.
Requests draw from the credit balance associated with your account.
What a request costs
One credit is one request on most routes.
Some routes cost more than one credit. The exact cost of a route is shown on its page in the API reference — that number is the source of truth, not this page.
You are only charged on a successful response. Errors — bad parameters, an unreachable source, anything on our side — cost nothing.
Checking your balance
curl "https://api.toolzerhub.com/v1/credits" \
-H "x-api-key: $TOOLZERHUB_API_KEY"Account and plan terms are managed in the Toolzer Hub dashboard. When a request needs credits, its endpoint page shows the published cost and the API reports an error when the account cannot cover it.
Authentication
Authenticate every Toolzer Hub API request with one x-api-key header. Where to get a key, a curl example, and why the key stays on your server.
Responses & Errors
Toolzer Hub API response envelopes: successful data, structured error objects with stable codes and HTTP status, and which errors are safe to retry.