API REFERENCE

netsh.io API v1

20 network diagnostic endpoints, one consistent JSON contract. Get a free key on the API page.

Base URL

https://netsh.io/api/v1

Authentication

An x-api-key header, or an api_key query parameter if you can't set custom headers (e.g. testing a URL in a browser).

Rate limit

100 requests/day per key, on a rolling 24-hour window. Exceeding it returns a 429.

Versioning

v1 is a stable contract — a breaking change ships as v2, never an in-place edit.

Response envelope

Every endpoint returns the same shape, success or failure:

{
  "ok": true,
  "data": { /* endpoint-specific */ },
  "meta": { "tool": "whois", "version": "v1" }
}

{
  "ok": false,
  "error": "Missing API key — pass it as an x-api-key header or an api_key query parameter.",
  "meta": { "tool": "whois", "version": "v1" }
}

Authentication example

curl "https://netsh.io/api/v1/whois?domain=example.com" \
  -H "x-api-key: YOUR_API_KEY"