Guide

Quickstart

From nothing to your first successful API call in about two minutes.

1. Create an account

Sign in with Google from the top right. There is no password to choose and no card to enter. Your account is created with a welcome grant of credits, plus a free allowance that refreshes on the 1st of every month.

2. Create an API key

Go to API keys and click New key. Give it a label describing where it will be used - "local dev", "production worker", "Claude Desktop" - so you can revoke the right one later.

3. Make a call

Every endpoint is a POST that takes a JSON object and returns JSON. Here is a DNS lookup, which costs one credit:

bash
curl -X POST https://toolkitbackend-j69m.onrender.com/api/v1/tools/dns-lookup \
  -H "Authorization: Bearer tb_live_<your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{"hostname": "example.com", "recordType": "MX"}'

A successful response wraps the result in data, and the headers tell you what it cost:

http
HTTP/1.1 200 OK
X-Credits-Charged: 1
X-Credits-Remaining: 149

{ "success": true, "data": { "hostname": "example.com", "recordType": "MX", "records": [ ... ] } }

4. Or skip the key entirely

Every endpoint page has a Try it panel that runs the real endpoint using your signed-in session. It costs the same credits but needs no key, so you never have to paste a live credential into a web page just to experiment.