Use test keys (sk_test_…) in the playground. Test traffic never bills. Live keys need a licensed site.
AbuseGraphDocs

Keys

Secret sk_ keys stay on the server. Publishable pk_ keys belong in the browser. Live traffic needs a licensed site.

Prop

Type

Test vs live

TestLive
Keysk_test_… / pk_test_…sk_live_… / pk_live_…
x-abusegraph-siteoptionalrequired — DNS-verified hostname
Quotaunlimited testplan live checks (Free: 1,000 / month)

Live keys refuse localhost

Local tooling must use test keys. Never invent live keys. Never commit secrets.

Minimum env

ABUSEGRAPH_SITE=yourdomain.com
ABUSEGRAPH_CHECK_URL=https://abusegraph.com/api/v1/check
ABUSEGRAPH_SECRET_KEY=sk_test_…
ABUSEGRAPH_SECRET_KEY_TEST=sk_test_…
NEXT_PUBLIC_ABUSEGRAPH_PUBLISHABLE_KEY=pk_test_…

Account metadata

GET /api/v1/account with a secret key returns plan, usage, and domain metadata — see Account.