Developers

Domain, email and website checks in one API

DNS, registration, mail, certificates and websites through one REST API with one key, one envelope and the same prices as the browser.

Request
curl "https://api.dnssuper.com/v1/dns?domain=example.com&types=A,MX" \
  -H "Authorization: Bearer $DNSSUPER_API_KEY"
Response (sample data)
{
  "tool": "dns-lookup",
  "target": "example.com",
  "status": "ok",
  "fetched_at": "2026-11-14T10:00:00Z",
  "cached": false,
  …

The basics

What every integration meets

Authentication

Create a key in the dashboard and send it as a Bearer token. Keys can be rotated and revoked; each is shown once.

One response envelope

Every tool answers with the tool, the target, a status, when it was fetched, whether it came from cache, the findings with their fixes and the tool's own data.

Price per call

Each call costs the tool's credits, the same as in the browser and over MCP; failed upstream lookups cost nothing. The response says what is left.

Jobs and bulk runs

Long checks and lists run as jobs that reserve their credits, report progress and settle once. Poll them or get a webhook.

Streams

The domain report can stream each section as server-sent events while the rest is still running, and a dropped stream can be picked up again.

Errors

Errors are JSON with a stable code, a plain sentence and, where it helps, when to retry. Input errors say exactly which part was wrong.

The same call in your language

Generated from one request, like the snippets under every result on the site.

curl

curl
curl "https://api.dnssuper.com/v1/dns?domain=example.com&types=A,MX" \
  -H "Authorization: Bearer $DNSSUPER_API_KEY"

Python

Python
import os

import httpx

client = httpx.Client(
    base_url="https://api.dnssuper.com",
    headers={"Authorization": f"Bearer {os.environ['DNSSUPER_API_KEY']}"},
    timeout=60,
)
response = client.get("/v1/dns", params={
    "domain": "example.com",
    "types": "A,MX",
})
response.raise_for_status()
result = response.json()
print(result["summary"], result["credits_used"])

TypeScript

TypeScript
const response = await fetch(`https://api.dnssuper.com/v1/dns?${new URLSearchParams({"domain":"example.com","types":"A,MX"})}`, {
  headers: { Authorization: `Bearer ${process.env.DNSSUPER_API_KEY}` },
});
if (!response.ok) throw new Error((await response.json()).error.message);
const result = await response.json();
console.log(result.summary, result.credits_used);

Where to go next

API reference

Every endpoint, parameter and response, from the OpenAPI spec.

Quickstart

From a new key to your first check in a few minutes.

MCP server

The same tools for AI agents, with compact answers.

Webhooks

Job and monitor events delivered to your endpoint, signed.

Exports

Results and history as JSON, CSV or PDF.

Monitoring

Monitors and alert channels through the API.

Developer questions

How do I get an API key?
Create a free account, then make a key under API keys in the dashboard. The key is shown once; send it as a Bearer token. The free account's 500 credits a month work through the API too.
What does a call cost?
The same as in the browser: a DNS lookup is 1 credit. Every response says what it cost and what is left, and a lookup that fails upstream costs nothing.
Is there an OpenAPI spec?
Yes. The OpenAPI document lists every endpoint, parameter, response and error code, and our own reference pages are generated from it.
Can I check many domains at once?
Yes. Bulk runs take a list for any tool and run as a job: the job reserves the credits up front, reports progress, and returns what it didn't use. You can poll it or get a webhook when it finishes.
What are the rate limits?
Keys share fair per-minute limits, and some registries allow fewer lookups than others, so their calls may wait or answer that the registry is busy. The limits and their headers are in the docs.