# DNS Super > Checks domains, DNS, email setup, certificates and websites from the source, with a plain fix for every finding. REST API at https://api.dnssuper.com, MCP server at https://mcp.dnssuper.com/mcp, paid in credits. --- Source: https://dnssuper.com/docs # DNS Super docs DNS Super checks domains, DNS, email setup, certificates and websites, using data straight from the source: the authoritative DNS servers, the registries, the mail servers and the sites themselves. Every check you can run on the website also works through the REST API and inside your AI agent over MCP, with the same result and the same price. ## Start here - [Quickstart](/docs/quickstart): make your first call with curl, Python or TypeScript in a few minutes. - [Authentication](/docs/authentication): API keys, where to make them and how to keep them safe. - [Credits](/docs/credits): what a call costs, when you aren't charged, and the free monthly allowance. - [Responses](/docs/responses) and [errors](/docs/errors): the one result shape every tool returns, and the one error shape every failure returns. ## Three ways in **The website.** Every tool has its own page under [tools](/tools). Anyone can run the free checks without an account; signed-in checks draw on your credits. **The REST API.** Base URL `https://api.dnssuper.com`. Each tool is one endpoint, documented in the [tool reference](/docs/tools) with its parameters, response fields, price and an example. Everything else (your account, jobs, monitors, exports) is in the [API reference](/docs/api). **The MCP server.** Add `https://mcp.dnssuper.com/mcp` to Claude, Cursor, VS Code or any other MCP client and your agent can run every check itself. See [MCP server](/docs/mcp) for the setup and the list of tools. ## Running checks at scale Run one check on a whole list with [bulk checks and jobs](/docs/bulk-and-jobs), watch results arrive section by section with [streams](/docs/streams), and get told when something changes with [monitoring](/docs/monitoring) and [webhooks](/docs/webhooks). ## For AI tools Every docs page has a Markdown version: add `.md` to its address, or use **View as Markdown** at the top of the page. The whole set, in reading order, is in [llms-full.txt](/llms-full.txt), and a short index is in [llms.txt](/llms.txt). --- Source: https://dnssuper.com/docs/quickstart # Quickstart This page takes you from nothing to a working call. You need a free account and a terminal. ## Make an API key Sign in, open [API keys](/app/keys) in the dashboard and choose **Create key**. Copy the key when it is shown: it appears once, and we only keep a hash of it. Then put it in an environment variable so it never ends up in your code: ```sh export DNSSUPER_API_KEY="paste your key here" ``` Every account gets 500 credits each month on the free plan, which is enough to try every tool. ## Make your first call A DNS lookup of `example.com`, asking for its A and MX records, costs 1 credit: curl ```sh curl "https://api.dnssuper.com/v1/dns?domain=example.com&types=A,MX" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" ``` Python (httpx) ```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 (fetch) ```ts 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); ``` ## Read the result Every tool answers with the same shape. The parts you'll use most: - `summary`: one plain sentence saying what was found. - `findings`: problems and notes, each with a severity (`fail`, `warn`, `info` or `pass`), a title, the detail and a fix. - `data`: the tool's own result. For a DNS lookup that's the records by type, with their TTLs. - `credits_used` and `credits_remaining`: what the call cost and what's left. [Responses](/docs/responses) explains every field. If something goes wrong you get an error with a stable `code` and a plain message instead; [errors](/docs/errors) lists them all. ## Try it from your AI agent The same check works over MCP. Add the server to your client's config with your key, then ask your agent to look up a domain, or call the tool directly: MCP client config (JSON) ```json { "mcpServers": { "dnssuper": { "type": "http", "url": "https://mcp.dnssuper.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } } ``` Then call the tool ```json { "tool": "lookup_dns", "arguments": { "domain": "example.com", "types": "A,MX" } } ``` [MCP server](/docs/mcp) has the setup for Claude, Cursor, VS Code and other clients. ## Next steps - Browse the [tool reference](/docs/tools) to see what else you can check. - Learn [what each call costs](/docs/credits) and how cached answers work. - Run a check on hundreds of domains at once with [bulk checks](/docs/bulk-and-jobs). --- Source: https://dnssuper.com/docs/authentication # Authentication Every API call carries an API key in the `Authorization` header: ```sh curl "$API_BASE/v1/account" -H "Authorization: Bearer $DNSSUPER_API_KEY" ``` The MCP server takes the same key in the same header. ## Making and managing keys Create keys under [API keys](/app/keys) in the dashboard. Each key belongs to the account you made it in, so its calls draw on that account's credits and follow that account's plan. A key is shown once, when you create it; after that the dashboard shows only its first characters, so you can tell keys apart. - **Rotate** a key to get a new secret for the same key. The old secret stops working at once. - **Revoke** a key you no longer need, or one that may have leaked. Calls with it fail straight away. Make one key per app or server, so you can revoke one without touching the others. ## What a key looks like Production keys start with `live_` and keys from any other environment start with `test_`, followed by 43 letters and digits. We store only a keyed hash of each key, never the key itself, so we can't show it to you again or recover it. ## Keeping keys safe - Keep keys in environment variables or a secret store, never in source code or a public repository. - Never put a key in a web page or a mobile app: anyone could read it there. - If a key leaks, revoke it in the dashboard and make a new one. ## Errors | Status | Code | When | | --- | --- | --- | | 401 | `unauthorized` | The key is missing, unknown or revoked, or the person who made it has left the account. | | 403 | `account_suspended` | The account is suspended. | | 403 | `sign_in_required` | The call needs an account and was made without one. | A failed call costs nothing. See [errors](/docs/errors) for the full list. --- Source: https://dnssuper.com/docs/credits # Credits Checks are paid in credits. Each tool has a fixed price per call, shown on its page and in the [tool reference](/docs/tools); a DNS lookup costs 1 credit and a full domain report costs 10 credits. The website, the API and the MCP server charge the same. ## When a call is charged - A call that returns a result is charged its price once. A cached answer costs the same as a fresh one, so you never have to think about which one you got. - A result marked `partial` (some sources answered, others didn't) is charged in full, and says what is missing. - A call that gets no answer from its sources returns `source_unavailable` and costs nothing. So do invalid input and every other error. - Free tools, such as the record generators, cost nothing and still work when your balance is below zero. - Retrying a call with the same `X-Request-Id` within 24 hours returns the stored result without charging again. See [responses](/docs/responses). Before a call runs we check that your balance covers its price. If it doesn't, you get 402 `insufficient_credits` and nothing runs. ## Jobs and streams [Bulk jobs](/docs/bulk-and-jobs) hold the price of every row when they start and charge each row that gets a result; whatever isn't used returns to your balance when the job ends. [Streams](/docs/streams) hold the call's price before the first section arrives and charge once, when the result is complete. ## Where credits come from Every account gets 500 credits each month on the free plan. Paid plans add more credits each month, plus seats, monitors and alert channels. Plan credits reset at the start of each month and don't roll over. Credit packs are a one-off top-up that lasts 12 months. When you have both, the credits that expire first are spent first. | Plan | Price (excl. VAT) | Credits each month | Seats | Monitors | | --- | --- | --- | --- | --- | | Free | Free | 500 credits | 1 | 3 | | Monitor | $12 a month or $120 a year | 2,000 credits | 1 | 25 | | Pro | $39 a month or $390 a year | 10,000 credits | 3 | 150 | | Agency | $99 a month or $990 a year | 50,000 credits | 10 | 500 | | Pack | Price (excl. VAT) | Credits | Valid for | | --- | --- | --- | --- | | Starter | $10 | 10,000 credits | 12 months | | Builder | $25 | 27,500 credits | 12 months | | Pro | $50 | 60,000 credits | 12 months | | Scale | $100 | 130,000 credits | 12 months | | Volume | $250 | 350,000 credits | 12 months | Prices exclude VAT. See [pricing](/pricing) to buy a plan or a pack. ## Prices per tool | Tool | API | Price | | --- | --- | --- | | DNS lookup | /v1/dns | 1 credit | | WHOIS / RDAP | /v1/whois | 2 credits | | Availability | /v1/availability | 1 credit | | DNSSEC and nameservers | /v1/dnssec | 2 credits | | Domain report | /v1/report | 10 credits | | SPF builder | /v1/build/spf | Free | | DMARC builder | /v1/build/dmarc | Free | | CAA builder | /v1/build/caa | Free | | DKIM record validator | /v1/dkim-record | Free | | IDN and punycode | /v1/idn | Free | | Migration checker | /v1/migration | 5 credits | | Dangling record check | /v1/dangling | 1 credit per name | | Lookalike detection | /v1/lookalikes | Free; 1 credit per 10 checked with check=true | | Expiry calendar | /v1/expiry-calendar | 2 credits per name | | Email setup audit | /v1/email-audit | 2 credits | | MTA-STS, TLS-RPT, BIMI | /v1/mail-policies | 1 credit | | Email header analyzer | /v1/headers | Free | | DKIM signature verifier | /v1/dkim-verify | Free | | HTTP and security headers | /v1/http | 2 credits | | Technical SEO audit | /v1/seo | 3 credits; 8 credits with rendered=true | | Structured data and hreflang | /v1/structured-data | 2 credits | | Basic accessibility | /v1/accessibility | 2 credits; 5 credits with contrast=true | | Standard files | /v1/standard-files | 1 credit | | AI crawler access | /v1/ai-crawlers | 1 credit | | Social preview | /v1/social-preview | 1 credit | | Site metadata and logo | /v1/metadata | 1 credit | | Tech stack detection | /v1/tech | 2 credits | | Redirect tracer | /v1/redirects | 1 credit | | Broken link checker | /v1/broken-links | 5 credits per 50 pages | | Cookie and tracker scan | /v1/cookies | 5 credits | | SSL check | /v1/ssl | 1 credit | | Certificate and CSR decoder | /v1/decode | Free | | IP and network info | /v1/ip | 1 credit | | ASN and IP ownership | /v1/asn | 1 credit | | IPv6 readiness | /v1/ipv6 | 1 credit | | Web port check | /v1/ports | 1 credit | | Monitors | /v1/monitors | See the tool page | | Bulk runs | /v1/bulk/{tool} | See the tool page | | Compare view | /v1/compare | See the tool page | | Shared reports | /v1/shares | Free | | Exports (JSON, CSV, PDF) | /v1/exports | Free | ## Checking your balance Every tool response includes `credits_used` and `credits_remaining`. `GET /v1/account` returns your balance and your last 20 calls without charging, and the dashboard's [usage page](/app/usage) shows every call with its cost. --- Source: https://dnssuper.com/docs/responses # Responses Every tool returns the same envelope, so one parser handles them all. Only `data` differs from tool to tool; each tool's page in the [tool reference](/docs/tools) lists its fields. ```json { "tool": "dns-lookup", "target": "example.com", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 1, "credits_remaining": 498, "summary": "example.com resolves to 2 IPv4 addresses and receives mail through 1 MX host.", "score": null, "findings": [ { "id": "dns.dnssec_unsigned", "severity": "info", "title": "Your domain isn't signed with DNSSEC", "detail": "...", "fix": "..." } ], "data": {} } ``` ## Fields | Field | What it holds | | --- | --- | | `tool` | The tool's id. | | `target` | What was checked, normalized: lowercase, with Unicode names in their ASCII form. | | `status` | `ok`, or `partial` when some sources didn't answer. A partial result says what is missing. | | `fetched_at` | When the data was fetched from its sources (UTC). | | `cached` | Whether this answer came from our cache. It costs the same either way. | | `credits_used` | What this call cost. | | `credits_remaining` | Your balance after the call. It can be below zero after a refund. | | `summary` | One plain sentence about the result. | | `score` | 0 to 100 for tools that grade, otherwise `null`. | | `findings` | Problems and notes, worst first. | | `data` | The tool's own result. | ## Findings Each finding has a stable `id` you can switch on, a `severity` of `fail`, `warn`, `info` or `pass`, a short `title`, the `detail` for this target and a `fix` in plain words. Many findings link to a step-by-step fix guide on the website. ## Fresh answers and caching Most results are cached for a short time, so a repeat costs the same but answers at once. DNS answers follow the record's TTL. Add `fresh=true` to skip the cache when you need a new answer, for example right after changing a record. Fresh calls have their own [rate limit](/docs/rate-limits). ## Request ids and safe retries Every response carries an `X-Request-Id` header. You can send your own (a UUID) with a call: if the network drops and you retry with the same id within 24 hours, you get the stored result, marked `X-Replayed: true`, and you aren't charged twice. Reusing an id for a different call returns 400 `invalid_request`. ## Errors A failure never uses this envelope. It returns an HTTP error status and one small body: ```json { "error": { "code": "invalid_domain", "message": "...", "request_id": "..." } } ``` [Errors](/docs/errors) lists every code and what to do about it. --- Source: https://dnssuper.com/docs/rate-limits # Rate limits Limits keep the service fast for everyone and keep us within the limits of the registries and sites we check on your behalf. A refused call is never charged. ## Per key | What | Limit | | --- | --- | | Requests with one API key | 10 a second, with bursts up to 50 | | Calls with `fresh=true` | 30 a minute per key, with bursts up to 10 | | Bulk and crawl jobs that use a browser | 10 an hour per account | | Free tools | 60 a minute | Going over answers 429 `rate_limited` with a `Retry-After` header in seconds. Wait that long and try again. ## Registries WHOIS and availability checks go to the registry that runs each TLD, and many registries allow only a few queries a minute. We share each registry's allowance fairly between all callers and never go over it. When a registry is busy, a lookup waits up to two seconds; if it still can't go, it answers 502 `source_unavailable` with a `Retry-After` header and costs nothing. Jobs wait longer and use half the allowance, so single lookups stay quick. [TLD coverage](/docs/tld-coverage) says which registries are tighter than usual. ## Busy sites and browsers Website checks fetch each site at most 120 times a minute across all our users, so a popular site can't be overloaded through us. When a site is at that limit, the check answers 503 `site_busy` and asks you to retry in 30 seconds. Checks that run a real browser share a small pool; when it is full you get 503 `browser_busy` and can retry a minute later. Neither is charged. ## Free checks without an account The website lets visitors without an account run 5 free checks a day. That allowance belongs to the website and isn't available through the API: every API call needs a key. ## Handling limits well - Read `Retry-After` and wait at least that long before retrying. - Retry with the same `X-Request-Id`, so a call that did go through is never charged twice. - For many targets, send one [bulk job](/docs/bulk-and-jobs) instead of many single calls: it paces itself within every limit. --- Source: https://dnssuper.com/docs/errors # Errors Every failure returns an HTTP error status and the same small body, so one handler covers them all: ```json { "error": { "code": "insufficient_credits", "message": "Your balance doesn't cover this call.", "request_id": "0d3b7c1e-5f8a-4c2e-9b6d-2a1f4e7c9d10" } } ``` Switch on `code`: it never changes. The `message` is a plain sentence you can show to a person, and the `request_id` (also in the `X-Request-Id` header) helps us find the call if you contact support. **You weren't charged for any error.** When a status comes with a `Retry-After` header, wait that many seconds before trying again. ## Your request | Status | Code | What it means | What to do | | --- | --- | --- | --- | | 400 | `invalid_domain` | The domain or host isn't a valid name. | Check the spelling; send a name like `example.com`, not a full address with spaces. | | 400 | `invalid_url` | The URL can't be checked: not http or https, a port other than 80 or 443, or an IP address. | Send a public `https://` address, or just the domain. | | 400 | `invalid_request` | A parameter is missing or wrong, or an `X-Request-Id` was already used for a different call. | Read the message: it names the field. Send a new request ID for a new call. | | 422 | `invalid_request` | A report sent through the [security page](/security) holds control characters, so it can't be stored. | Remove them (new lines and tabs are fine) and send it again. | | 400 | `unsupported_tld` | This tool can't check names under that TLD (the registry publishes no data). | See [TLD coverage](/docs/tld-coverage); a DNS lookup still works. | | 400 | `private_key_refused` | The certificate decoder was sent something holding a private key. It was refused before reading it. | Send only the certificate or the CSR. Never paste a private key anywhere. | | 400 | `export_too_large` | The report is too big to turn into a PDF. | Export it as JSON or CSV instead, or split the job. | | 400 | `token_invalid` | A sign-in link, invite or passkey answer is unknown, used or expired. | Ask for a new link or invite. | | 404 | `not_found` | Nothing at this path, or a job, stream, monitor or export that doesn't exist, has expired or isn't yours. | Check the ID and the address against the [API reference](/docs/api). | | 405 | `method_not_allowed` | The endpoint doesn't take that HTTP method. | Check the method in the reference. | ## Your key and your account | Status | Code | What it means | What to do | | --- | --- | --- | --- | | 401 | `unauthorized` | The API key is missing, unknown or revoked, or its creator left the account. | Send `Authorization: Bearer ` with a current key. See [authentication](/docs/authentication). | | 402 | `insufficient_credits` | Your balance doesn't cover the call's price. Nothing ran. | Top up on [pricing](/pricing), or wait for next month's credits. | | 403 | `account_suspended` | The account is suspended. | Contact support. | | 403 | `sign_in_required` | This needs an account; it was called without one. | Call it with an API key, or sign in on the website. | | 403 | `challenge_required` | A free check on the website came without its proof-of-work. | Let the page finish loading with JavaScript on, then try again. | | 403 | `forbidden` | Your role in this account doesn't allow it (owner-only actions). | Ask an owner of the account. | | 403 | `plan_limit` | Your plan doesn't allow this: more seats, keys or members than it includes. | Upgrade the plan, or remove something first. | | 403 | `plan_kind` | Your plan doesn't include this kind of monitor. | Pick a kind your plan includes, or upgrade. | | 403 | `interval_not_allowed` | Your plan doesn't allow checks this often. | Choose a longer interval, or upgrade. | | 403 | `channel_not_allowed` | Your plan doesn't include this alert channel type. | Use email alerts, or upgrade. | | 403 | `bulk_locked` | Bulk checks unlock after your first credit purchase or plan. | Buy a pack or a plan, then try again. | | 403 | `verification_required` | Large bulk jobs on these domains need proof that you control them. | Add the TXT record from `POST /v1/verifications/record`, then check it. | | 403 | `reauth_required` | Deleting data needs a sign-in within the last 10 minutes. | Sign in again, then repeat the request. | | 403 | `password_required` | The shared report has a password. | Ask the person who shared it for the password. | ## Conflicts | Status | Code | What it means | What to do | | --- | --- | --- | --- | | 409 | `conflict` | The request clashes with the current state, such as a second subscription. | Read the message, then reload what you have. | | 409 | `sole_owner` | You are the only owner of an account that has other members. | Remove the members, or delete that account first. | | 409 | `duplicate_monitor` | You already have this monitor. | Edit the existing monitor instead. | | 409 | `alerts_off` | Alert sending is paused on this server, so test sends and webhook checks wait. | Try again later. | | 409 | `no_members` | An account without members has no default alert channel. | Add an alert channel first. | | 409 | `channel_limit` | The account already has the most alert channels it can have. | Remove one you no longer use. | | 409 | `channel_unverified` | The webhook hasn't answered its verification yet. | Verify the channel, then attach it. See [webhooks](/docs/webhooks). | ## Limits and busy services | Status | Code | What it means | What to do | | --- | --- | --- | --- | | 429 | `rate_limited` | Too many requests for this key or option. | Wait for `Retry-After`. See [rate limits](/docs/rate-limits). | | 429 | `free_limit_reached` | A website visitor used today's free checks. | Make a free account, or wait until tomorrow (UTC). | | 429 | `too_many_jobs` | Your account started too many browser or crawl jobs this hour. | Wait for `Retry-After`, or combine targets into one job. | | 503 | `busy` | Too many live result streams are open right now. | Retry in a few seconds, or call the tool without streaming. | | 503 | `site_busy` | The site you're checking is getting many checks right now. | Retry after 30 seconds. | | 503 | `browser_busy` | All browser sessions are in use. | Retry after `Retry-After`. | | 503 | `crawl_busy` | Too many link checks are running site-wide. | Retry after `Retry-After`. | | 503 | `bulk_busy` | Too many bulk jobs are running site-wide. | Retry after `Retry-After`. | | 503 | `lookalike_busy` | Too many lookalike checks are running site-wide. | Retry after `Retry-After`. | | 503 | `export_busy` | The PDF store is full for now. | Retry after `Retry-After`, or export as JSON or CSV. | | 503 | `billing_unavailable` | Payments aren't available right now. | Try again later; your credits and plan are unaffected. | ## Sources and our side | Status | Code | What it means | What to do | | --- | --- | --- | --- | | 502 | `source_unavailable` | Every source the check needs failed to answer (a DNS server, a registry or the site). | Retry later; a `Retry-After` header says when, if we know. | | 503 | `source_unavailable` | The tool is paused for now, for example while its data refreshes. | Retry after `Retry-After`. | | 500 | `internal_error` | Something went wrong on our side. | Retry in a minute; if it keeps happening, contact support with the request ID. | --- Source: https://dnssuper.com/docs/tools # Tool reference Every check by API and MCP: endpoint, parameters, response fields, price and an example. - [DNS lookup](/docs/tools/dns-lookup.md): `GET /v1/dns` - [WHOIS / RDAP](/docs/tools/whois-lookup.md): `GET /v1/whois` - [Availability](/docs/tools/domain-availability.md): `GET /v1/availability` - [DNSSEC and nameservers](/docs/tools/dnssec-checker.md): `GET /v1/dnssec` - [Domain report](/docs/tools/domain-report.md): `GET /v1/report` - [SPF builder](/docs/tools/spf-generator.md): `POST /v1/build/spf` - [DMARC builder](/docs/tools/dmarc-generator.md): `POST /v1/build/dmarc` - [CAA builder](/docs/tools/caa-generator.md): `POST /v1/build/caa` - [DKIM record validator](/docs/tools/dkim-checker.md): `POST /v1/dkim-record` - [IDN and punycode](/docs/tools/punycode-converter.md): `GET /v1/idn` - [Migration checker](/docs/tools/dns-migration-checker.md): `POST /v1/migration` - [Dangling record check](/docs/tools/subdomain-takeover-check.md): `POST /v1/dangling` - [Lookalike detection](/docs/tools/lookalike-domains.md): `GET /v1/lookalikes` - [Expiry calendar](/docs/tools/domain-expiry-calendar.md): `POST /v1/expiry-calendar` - [Email setup audit](/docs/tools/email-checker.md): `GET /v1/email-audit` - [MTA-STS, TLS-RPT, BIMI](/docs/tools/mta-sts-checker.md): `GET /v1/mail-policies` - [Email header analyzer](/docs/tools/email-header-analyzer.md): `POST /v1/headers` - [DKIM signature verifier](/docs/tools/dkim-verifier.md): `POST /v1/dkim-verify` - [HTTP and security headers](/docs/tools/security-headers.md): `GET /v1/http` - [Technical SEO audit](/docs/tools/seo-audit.md): `GET /v1/seo` - [Structured data and hreflang](/docs/tools/structured-data-validator.md): `GET /v1/structured-data` - [Basic accessibility](/docs/tools/accessibility-checker.md): `GET /v1/accessibility` - [Standard files](/docs/tools/security-txt-checker.md): `GET /v1/standard-files` - [AI crawler access](/docs/tools/ai-crawler-checker.md): `GET /v1/ai-crawlers` - [Social preview](/docs/tools/social-preview.md): `GET /v1/social-preview` - [Site metadata and logo](/docs/tools/website-logo.md): `GET /v1/metadata` - [Tech stack detection](/docs/tools/tech-stack-checker.md): `GET /v1/tech` - [Redirect tracer](/docs/tools/redirect-checker.md): `GET /v1/redirects` - [Broken link checker](/docs/tools/broken-link-checker.md): `POST /v1/broken-links` - [Cookie and tracker scan](/docs/tools/cookie-scanner.md): `POST /v1/cookies` - [SSL check](/docs/tools/ssl-checker.md): `GET /v1/ssl` - [Certificate and CSR decoder](/docs/tools/certificate-decoder.md): `POST /v1/decode` - [IP and network info](/docs/tools/ip-lookup.md): `GET /v1/ip` - [ASN and IP ownership](/docs/tools/asn-lookup.md): `GET /v1/asn` - [IPv6 readiness](/docs/tools/ipv6-test.md): `GET /v1/ipv6` - [Web port check](/docs/tools/port-checker.md): `GET /v1/ports` - [Compare view](/docs/tools/compare.md): `POST /v1/compare` --- Source: https://dnssuper.com/docs/tools/dns-lookup # DNS lookup API See every DNS record for a domain, where its mail goes and whether it's DNSSEC-signed, straight from the source. `GET /v1/dns` - Price: Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free. - Cache: Answers are cached for the lowest record TTL, between 1 minute and 1 hour; send fresh=true to ask the source again. - MCP tool: `lookup_dns` Records for a domain grouped by type, with TTLs, CNAME chain, DNSSEC state and findings. Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for the lowest record TTL, between 1 minute and 1 hour; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header. ## Query parameters | Name | Type | Required | Description | | --- | --- | --- | --- | | `domain` | string | yes | A domain name or a URL | | `types` | string or null | no | Comma-separated record types; default A, AAAA, CNAME, MX, NS, TXT, SOA, CAA | | `fresh` | boolean | no | Skip the cache and ask DNS again | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.name` | string | yes | The name looked up, in ASCII form | | `data.unicode` | string | yes | The same name for display | | `data.nxdomain` | boolean | yes | | | `data.dnssec` | "secure" | "insecure" | "bogus" | "indeterminate" | yes | | | `data.wildcard` | boolean | yes | | | `data.wildcard_source` | "rrsig" | "probe" or null | no | | | `data.records` | object | yes | Rows per requested record type | | `data.query_status` | object | yes | Query outcome per requested record type | | `data.cname_chain` | array of object | no | | | `data.cname_chain.name` | string | yes | | | `data.cname_chain.target` | string | yes | | | `data.cname_chain.ttl` | integer | yes | | | `data.hosts` | object | no | | | `data.negative_ttl` | integer or null | no | | | `data.min_ttl` | integer or null | no | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `402` Balance below the call's price (`insufficient_credits`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) - `502` Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to ## Example ```sh curl "https://api.dnssuper.com/v1/dns?domain=example.com&types=A,MX" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" ``` ```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"]) ``` ```ts 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); ``` Example response: ```json { "tool": "dns-lookup", "target": "example.com", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 1, "summary": "example.com resolves to 2 IPv4 addresses and receives mail through 1 MX host.", "findings": [ { "id": "dns.dnssec_unsigned", "severity": "info", "title": "Your domain isn't signed with DNSSEC", "detail": "Answers for example.com carry no DNSSEC signatures, so resolvers can't check that nobody changed them on the way.", "fix": "Turn on DNSSEC at your DNS provider, then add the DS record it gives you at your registrar. Many providers do both for you in one step." } ], "data": { "name": "example.com", "unicode": "example.com", "nxdomain": false, "dnssec": "insecure", "wildcard": false, "records": { "A": [ { "name": "example.com", "ttl": 300, "value": "192.0.2.10" }, { "name": "example.com", "ttl": 300, "value": "192.0.2.11" } ], "MX": [ { "name": "example.com", "ttl": 3600, "value": "10 mail.example.com" } ] }, "query_status": { "A": "ok", "MX": "ok" }, "cname_chain": [], "hosts": { "mail.example.com": { "A": [ "192.0.2.25" ], "AAAA": [], "roles": [ "MX" ], "status": "ok" } }, "caa_inherited": [], "min_ttl": 300 }, "credits_remaining": 498 } ``` ## MCP ```json { "tool": "lookup_dns", "arguments": { "domain": "example.com", "types": "A,MX" } } ``` ```text example.com resolves to 2 IPv4 addresses and receives mail through 1 MX host. A: 192.0.2.10, 192.0.2.11 (TTL 300) MX: 10 mail.example.com (TTL 3600) DNSSEC: insecure - info: Your domain isn't signed with DNSSEC Credits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/whois-lookup # WHOIS / RDAP API See who a domain is registered with, when it was created and when it expires, from the registry itself. `GET /v1/whois` - Price: Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free. - Cache: Answers are cached for up to 1 hour; send fresh=true to ask the source again. - MCP tool: `lookup_whois` Who registered a domain, with which registrar, when it expires, its statuses, nameservers and DNSSEC flag, from the registry's RDAP or WHOIS service, with personal contact data removed. Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 1 hour; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header. ## Query parameters | Name | Type | Required | Description | | --- | --- | --- | --- | | `domain` | string | yes | A domain or URL; reduced to its registrable part. | | `fresh` | boolean | no | Skip the cache and ask the source again; costs the same. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.name` | string | yes | | | `data.unicode` | string | yes | | | `data.tld` | string | yes | | | `data.tier` | "A" | "B" | "C" | "D" | yes | | | `data.source` | "rdap" | "whois" or null | no | | | `data.registered` | boolean or null | no | | | `data.reduced_from` | string or null | no | | | `data.registrar` | object or null | no | | | `data.created` | string or null | no | | | `data.updated` | string or null | no | | | `data.expires` | string or null | no | | | `data.age_days` | integer or null | no | | | `data.days_to_expiry` | integer or null | no | | | `data.statuses` | array of object | no | | | `data.statuses.code` | string | yes | | | `data.statuses.meaning` | string | yes | | | `data.statuses.set_by` | "registrar" | "registry" | "unknown" | yes | | | `data.nameservers` | array of string | no | | | `data.dnssec` | boolean or null | no | | | `data.redacted_fields` | array of string | no | | | `data.unpublished_fields` | array of string | no | | | `data.unparsed_fields` | array of string | no | | | `data.attempts` | array of object | no | | | `data.attempts.method` | "rdap" | "rdap-registrar" | "whois" | "whois-referral" | yes | | | `data.attempts.server` | string | yes | | | `data.attempts.outcome` | string | yes | | | `data.attempts.http_status` | integer or null | no | | | `data.attempts.elapsed_ms` | integer | yes | | | `data.raw` | object or null | no | | | `data.retry_after_s` | number or null | no | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `402` Balance below the call's price (`insufficient_credits`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) - `502` Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to ## Example ```sh curl "https://api.dnssuper.com/v1/whois?domain=example.com" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" ``` ```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/whois", params={ "domain": "example.com", }) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch(`https://api.dnssuper.com/v1/whois?${new URLSearchParams({"domain":"example.com"})}`, { 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); ``` Example response: ```json { "tool": "whois-lookup", "target": "verisign.com", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 2, "summary": "verisign.com is registered with CSC Corporate Domains, Inc. until 1 June 2034 (in 2755 days). Transfers are locked and DNSSEC is on.", "findings": [], "data": { "name": "verisign.com", "unicode": "verisign.com", "tld": "com", "tier": "A", "source": "rdap", "registered": true, "registrar": { "name": "CSC Corporate Domains, Inc.", "iana_id": 299, "url": "https://www.cscdbs.example.net", "abuse_email": "domainabuse@cscglobal.com", "abuse_phone": "+1.8887802723" }, "created": "1995-06-02T04:00:00Z", "updated": "2025-02-07T17:08:30Z", "expires": "2034-06-01T04:00:00Z", "age_days": 11488, "days_to_expiry": 2755, "statuses": [ { "code": "clientDeleteProhibited", "meaning": "The registrar has locked deletion", "set_by": "registrar" }, { "code": "clientTransferProhibited", "meaning": "The registrar has locked transfers", "set_by": "registrar" }, { "code": "clientUpdateProhibited", "meaning": "The registrar has locked changes", "set_by": "registrar" }, { "code": "serverDeleteProhibited", "meaning": "The registry has locked deletion", "set_by": "registry" }, { "code": "serverTransferProhibited", "meaning": "The registry has locked transfers", "set_by": "registry" }, { "code": "serverUpdateProhibited", "meaning": "The registry has locked changes", "set_by": "registry" } ], "nameservers": [ "av1.nstld.com", "av2.nstld.com", "av3.nstld.com", "av4.nstld.com" ], "dnssec": true, "redacted_fields": [], "unpublished_fields": [], "unparsed_fields": [], "attempts": [ { "method": "rdap", "server": "rdap.verisign.com", "outcome": "found", "http_status": 200, "elapsed_ms": 12 }, { "method": "rdap-registrar", "server": "rdap.cscglobal.com", "outcome": "found", "http_status": 200, "elapsed_ms": 12 } ], "raw": { "format": "rdap-json", "registry": { "objectClassName": "domain", "handle": "2703255_DOMAIN_COM-VRSN", "ldhName": "VERISIGN.COM", "links": [ { "value": "https://rdap.verisign.com/com/v1/domain/verisign.com", "rel": "self", "href": "https://rdap.verisign.com/com/v1/domain/verisign.com", "type": "application/rdap+json" }, { "value": "https://rdap.verisign.com/com/v1/domain/verisign.com", "rel": "related", "href": "https://rdap.cscglobal.com/dbs/rdap-api/v1/domain/VERISIGN.COM", "type": "application/rdap+json" } ], "status": [ "client delete prohibited", "client transfer prohibited", "client update prohibited", "server delete prohibited", "server transfer prohibited", "server update prohibited" ], "entities": [ { "objectClassName": "entity", "handle": "299", "roles": [ "registrar" ], "links": [ { "href": "http://cscdbs.com", "type": "text/html", "value": "https://rdap.cscglobal.com/dbs/rdap-api/v1/", "rel": "about" } ], "publicIds": [ { "type": "IANA Registrar ID", "identifier": "299" } ], "vcardArray": [ "vcard", [ [ "version", {}, "text", "4.0" ], [ "fn", {}, "text", "CSC Corporate Domains, Inc." ] ] ], "entities": [ { "objectClassName": "entity", "roles": [ "abuse" ], "vcardArray": [ "vcard", [ [ "version", {}, "text", "4.0" ], [ "fn", {}, "text", "" ], [ "tel", { "type": "voice" }, "uri", "tel:8887802723" ], [ "email", {}, "text", "domainabuse@cscglobal.com" ] ] ] } ] } ], "events": [ { "eventAction": "registration", "eventDate": "1995-06-02T04:00:00Z" }, { "eventAction": "expiration", "eventDate": "2034-06-01T04:00:00Z" }, { "eventAction": "last changed", "eventDate": "2025-02-07T17:08:30Z" }, { "eventAction": "last update of RDAP database", "eventDate": "2026-11-14T18:32:50Z" } ], "secureDNS": { "delegationSigned": true, "dsData": [ { "keyTag": 55204, "algorithm": 8, "digestType": 2, "digest": "206D88653C43D99BF4567BBD7DF9C078DB357F59AA183741024D345723052E88" } ] }, "nameservers": [ { "objectClassName": "nameserver", "ldhName": "AV1.NSTLD.COM" }, { "objectClassName": "nameserver", "ldhName": "AV2.NSTLD.COM" }, { "objectClassName": "nameserver", "ldhName": "AV3.NSTLD.COM" }, { "objectClassName": "nameserver", "ldhName": "AV4.NSTLD.COM" } ], "rdapConformance": [ "rdap_level_0", "icann_rdap_technical_implementation_guide_1", "icann_rdap_response_profile_1" ], "notices": [ { "title": "Terms of Service", "description": [ "Service subject to Terms of Use." ], "links": [ { "href": "https://www.verisign.com/domain-names/registration-data-access-protocol/terms-service/index.xhtml", "type": "text/html", "value": "https://rdap.verisign.com/com/v1/domain/verisign.com", "rel": "terms-of-service" } ] }, { "title": "Status Codes", "description": [ "For more information on domain status codes, please visit https://icann.org/epp" ], "links": [ { "href": "https://icann.org/epp", "type": "text/html", "value": "https://rdap.verisign.com/com/v1/domain/verisign.com", "rel": "glossary" } ] }, { "title": "RDDS Inaccuracy Complaint Form", "description": [ "URL of the ICANN RDDS Inaccuracy Complaint Form: https://icann.org/wicf" ], "links": [ { "href": "https://icann.org/wicf", "type": "text/html", "value": "https://rdap.verisign.com/com/v1/domain/verisign.com", "rel": "help" } ] } ] }, "registrar": { "objectClassName": "domain", "ldhName": "VERISIGN.COM", "handle": "synthetic", "status": [ "client transfer prohibited" ], "events": [ { "eventAction": "registration", "eventDate": "1995-06-02T04:00:00Z" }, { "eventAction": "expiration", "eventDate": "2034-06-01T04:00:00Z" }, { "eventAction": "last changed", "eventDate": "2025-02-07T17:08:30Z" } ], "entities": [ { "objectClassName": "entity", "roles": [ "registrar" ], "publicIds": [ { "type": "IANA Registrar ID", "identifier": "299" } ], "links": [ { "rel": "about", "href": "https://www.cscdbs.example.net", "type": "text/html" } ], "vcardArray": [ "vcard", [ [ "version", {}, "text", "4.0" ], [ "fn", {}, "text", "CSC Corporate Domains, Inc." ] ] ], "entities": [ { "objectClassName": "entity", "roles": [ "abuse" ], "vcardArray": [ "vcard", [ [ "version", {}, "text", "4.0" ], [ "fn", {}, "text", "Abuse" ], [ "tel", { "type": "voice" }, "uri", "tel:+1.8887802723" ], [ "email", {}, "text", "domainabuse@cscglobal.com" ] ] ] } ] }, { "objectClassName": "entity", "roles": [ "registrant" ], "removed": "contact details removed by DNS Super" } ], "nameservers": [ { "objectClassName": "nameserver", "ldhName": "AV1.NSTLD.COM", "entities": [ { "objectClassName": "entity", "roles": [ "technical" ], "removed": "contact details removed by DNS Super" } ] } ], "secureDNS": { "delegationSigned": true } }, "scrubbed": true } }, "credits_remaining": 498 } ``` ## MCP ```json { "tool": "lookup_whois", "arguments": { "domain": "example.com" } } ``` ```text verisign.com is registered with CSC Corporate Domains, Inc. until 1 June 2034 (in 2755 days). Transfers are locked and DNSSEC is on. Registrar: CSC Corporate Domains, Inc. (IANA 299) Created 1995-06-02 | expires 2034-06-01 (in 2755 days) | updated 2025-02-07 Status: clientDeleteProhibited (The registrar has locked deletion) Status: clientTransferProhibited (The registrar has locked transfers) Status: clientUpdateProhibited (The registrar has locked changes) Status: serverDeleteProhibited (The registry has locked deletion) +2 more Nameservers: av1.nstld.com, av2.nstld.com, av3.nstld.com +1 more DNSSEC: on | source RDAP, tier A No issues found. Credits: 2 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/domain-availability # Availability API Find out whether a domain name is free to register, asked of the registry itself, not a registrar's shop. `GET /v1/availability` - Price: Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free. - Cache: Answers are cached per account for up to 10 minutes; send fresh=true to ask the source again. - MCP tool: `check_availability` Whether a domain name is available, taken, restricted or unknown, how certain that is, and the steps that decided it (DNS at the TLD's own servers, then the registry). Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached per account for up to 10 minutes; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header. ## Query parameters | Name | Type | Required | Description | | --- | --- | --- | --- | | `domain` | string | yes | The domain name to check, such as brightidea.io. | | `fresh` | boolean | no | Skip the cache and ask the source again; costs the same. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.name` | string | yes | | | `data.unicode` | string | yes | | | `data.tld` | string | yes | | | `data.tier` | "A" | "B" | "C" | "D" | yes | | | `data.reduced_from` | string or null | no | | | `data.verdict` | "available" | "taken" | "unknown" | "restricted" or null | no | | | `data.certainty` | "confirmed" | "likely" or null | no | | | `data.reason` | "delegated" | "registry_not_found" | "registered_without_dns" | "reserved" | "brand_tld" | "dns_only" | "dns_inconclusive" or null | no | | | `data.may_become_available` | boolean | no | | | `data.statuses` | array of string | no | | | `data.source` | "dns" | "rdap" | "whois" | "dns-only" or null | no | | | `data.steps` | array of object | no | | | `data.steps.method` | string | yes | | | `data.steps.server` | string | yes | | | `data.steps.result` | string | yes | | | `data.steps.elapsed_ms` | integer | yes | | | `data.price_note` | boolean | no | | | `data.retry_after_s` | number or null | no | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `402` Balance below the call's price (`insufficient_credits`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) - `502` Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to ## Example ```sh curl "https://api.dnssuper.com/v1/availability?domain=example.com" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" ``` ```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/availability", params={ "domain": "example.com", }) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch(`https://api.dnssuper.com/v1/availability?${new URLSearchParams({"domain":"example.com"})}`, { 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); ``` Example response: ```json { "tool": "domain-availability", "target": "brightidea.io", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 1, "summary": "brightidea.io is available. The .io registry has no record of it; check the price at your registrar before you buy.", "findings": [ { "id": "availability.confirm_price", "severity": "info", "title": "Check the price before you buy", "detail": "", "fix": "Registrars set their own prices, and some names cost more than usual; check the price at your registrar before you buy." } ], "data": { "name": "brightidea.io", "unicode": "brightidea.io", "tld": "io", "tier": "A", "verdict": "available", "certainty": "confirmed", "reason": "registry_not_found", "may_become_available": false, "statuses": [], "source": "rdap", "steps": [ { "method": "dns-parent", "server": "192.0.2.200", "result": "nxdomain", "elapsed_ms": 12 }, { "method": "rdap", "server": "rdap.identitydigital.services", "result": "not_found", "elapsed_ms": 12 } ], "price_note": true }, "credits_remaining": 498 } ``` ## MCP ```json { "tool": "check_availability", "arguments": { "domain": "example.com" } } ``` ```text brightidea.io is available. The .io registry has no record of it; check the price at your registrar before you buy. brightidea.io: Available (confirmed; the registry has no record) Checked: dns-parent -> rdap - info: Check the price before you buy Credits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/dnssec-checker # DNSSEC and nameservers API Check a domain's DNSSEC chain of trust and every nameserver, straight from the registry and the servers themselves. `GET /v1/dnssec` - Price: Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free. - Cache: Answers are cached for up to 5 minutes; send fresh=true to ask the source again. - MCP tool: `check_dnssec` The delegation at the parent, every nameserver's answers over UDP and TCP, serials and glue, and the DNSSEC chain of trust with the reason when it breaks. Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 5 minutes; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header. ## Query parameters | Name | Type | Required | Description | | --- | --- | --- | --- | | `domain` | string | yes | A domain or URL; the zone it belongs to is checked. | | `fresh` | boolean | no | Skip the cache and ask the source again; costs the same. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.name` | string | yes | The name asked about, in ASCII | | `data.unicode` | string | yes | | | `data.zone` | string | yes | The zone checked: the name itself or the zone it lives in | | `data.parent` | string | yes | | | `data.dnssec` | "secure" | "insecure" | "bogus" | "indeterminate" | yes | | | `data.extended_errors` | array of object | yes | | | `data.extended_errors.code` | integer | yes | | | `data.extended_errors.text` | string | yes | | | `data.chain` | array of object | yes | | | `data.chain.zone` | string | yes | | | `data.chain.signed` | boolean or null | yes | A DS record for this zone exists at its parent | | `data.chain.secure` | boolean or null | yes | The resolver validated that DS answer | | `data.ds` | array of object | yes | | | `data.ds.key_tag` | integer | yes | | | `data.ds.algorithm` | integer | yes | | | `data.ds.algorithm_name` | string | yes | | | `data.ds.digest_type` | integer | yes | | | `data.ds.matches_key` | boolean | yes | | | `data.dnskeys` | array of object | yes | | | `data.dnskeys.key_tag` | integer | yes | | | `data.dnskeys.role` | "ksk" | "zsk" | "csk" | yes | | | `data.dnskeys.algorithm` | integer | yes | | | `data.dnskeys.algorithm_name` | string | yes | | | `data.dnskeys.bits` | integer or null | no | | | `data.dnskeys.revoked` | boolean | yes | | | `data.dnskeys.servers` | array of string | yes | Addresses that served this key | | `data.signatures` | array of object | yes | | | `data.signatures.covers` | string | yes | | | `data.signatures.key_tag` | integer | yes | | | `data.signatures.expiration` | string | yes | | | `data.signatures.expires_in_days` | integer | yes | | | `data.signatures.state` | "valid" | "invalid" | "expired" | "not_yet_valid" | "no_key" | "unsupported_algorithm" | yes | | | `data.signatures.servers` | array of string | yes | | | `data.denial` | object | yes | | | `data.denial.kind` | "nsec" | "nsec3" | "compact" | "none" | "unknown" | yes | | | `data.denial.nsec3_iterations` | integer or null | no | | | `data.denial.nsec3_salt_length` | integer or null | no | | | `data.denial.nsec3_opt_out` | boolean or null | no | | | `data.parent_ns` | array of string | yes | | | `data.parent_ns_ttl` | integer or null | no | | | `data.child_ns` | array of string | yes | | | `data.nameservers` | array of object | yes | | | `data.nameservers.name` | string | yes | | | `data.nameservers.in_parent` | boolean | yes | | | `data.nameservers.in_child` | boolean | yes | | | `data.nameservers.glue` | array of string | yes | | | `data.nameservers.addresses` | array of string | yes | | | `data.nameservers.status` | "ok" | "lame" | "unreachable" | "no_address" | "untested" | yes | | | `data.nameservers.servers` | array of object | yes | | | `data.serials` | object | yes | Serial number -> addresses serving it | | `data.ipv6_checked` | boolean | yes | | | `data.min_ttl` | integer or null | no | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `402` Balance below the call's price (`insufficient_credits`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) - `502` Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to ## Example ```sh curl "https://api.dnssuper.com/v1/dnssec?domain=example.com" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" ``` ```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/dnssec", params={ "domain": "example.com", }) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch(`https://api.dnssuper.com/v1/dnssec?${new URLSearchParams({"domain":"example.com"})}`, { 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); ``` Example response: ```json { "tool": "dnssec-checker", "target": "example.com", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 2, "summary": "example.com is DNSSEC-signed and validates, and 2 of 2 nameservers answer correctly.", "findings": [ { "id": "dnssec.nsec3", "severity": "info", "title": "Your zone uses NSEC3", "detail": "Answers for missing names carry NSEC3 records.", "fix": "Nothing to do." }, { "id": "dnssec.secure", "severity": "pass", "title": "DNSSEC is set up correctly", "detail": "The chain of trust from the root down to example.com validates.", "fix": "Nothing to do." }, { "id": "ns.consistent", "severity": "pass", "title": "Your nameservers all answer and agree", "detail": "2 nameservers answered authoritatively with the same serial.", "fix": "Nothing to do." } ], "data": { "name": "example.com", "unicode": "example.com", "zone": "example.com", "parent": "com", "parent_ns": [ "ns1.example.com", "ns2.example.com" ], "parent_ns_ttl": 172800, "child_ns": [ "ns1.example.com", "ns2.example.com" ], "chain": [ { "zone": "com", "signed": true, "secure": true }, { "zone": "example.com", "signed": true, "secure": true } ], "dnssec": "secure", "extended_errors": [], "ds": [ { "key_tag": 65437, "algorithm": 13, "algorithm_name": "ECDSAP256SHA256", "digest_type": 2, "matches_key": true } ], "dnskeys": [ { "key_tag": 65437, "role": "csk", "algorithm": 13, "algorithm_name": "ECDSAP256SHA256", "bits": 256, "revoked": false, "servers": [ "192.0.2.1", "198.51.100.2" ] } ], "signatures": [ { "covers": "DNSKEY", "key_tag": 65437, "expiration": "2026-11-28T10:00:00Z", "expires_in_days": 14, "state": "valid", "servers": [ "192.0.2.1", "198.51.100.2" ] }, { "covers": "SOA", "key_tag": 65437, "expiration": "2026-11-28T10:00:00Z", "expires_in_days": 14, "state": "valid", "servers": [ "192.0.2.1", "198.51.100.2" ] } ], "denial": { "kind": "nsec3", "nsec3_iterations": 0, "nsec3_salt_length": 0, "nsec3_opt_out": false }, "nameservers": [ { "name": "ns1.example.com", "in_parent": true, "in_child": true, "glue": [ "192.0.2.1" ], "addresses": [ "192.0.2.1" ], "status": "ok", "servers": [ { "address": "192.0.2.1", "family": "ipv4", "udp": true, "tcp": true, "authoritative": true, "serial": 2026111401, "elapsed_ms": 12, "open_resolver": false, "dnskey_tags": [ 65437 ] } ] }, { "name": "ns2.example.com", "in_parent": true, "in_child": true, "glue": [ "198.51.100.2" ], "addresses": [ "198.51.100.2" ], "status": "ok", "servers": [ { "address": "198.51.100.2", "family": "ipv4", "udp": true, "tcp": true, "authoritative": true, "serial": 2026111401, "elapsed_ms": 12, "open_resolver": false, "dnskey_tags": [ 65437 ] } ] } ], "serials": { "2026111401": [ "192.0.2.1", "198.51.100.2" ] }, "ipv6_checked": false, "min_ttl": 3600 }, "credits_remaining": 498 } ``` ## MCP ```json { "tool": "check_dnssec", "arguments": { "domain": "example.com" } } ``` ```text example.com is DNSSEC-signed and validates, and 2 of 2 nameservers answer correctly. DNSSEC: secure (zone example.com, parent com) DS: key 65437, algorithm 13 (ECDSAP256SHA256), digest type 2, matches a served key Keys: 65437 csk ECDSAP256SHA256 256 bits Soonest signature expiry: 2026-11-28 (in 14 days) ns1.example.com: ok, serial 2026111401, TCP yes ns2.example.com: ok, serial 2026111401, TCP yes - info: Your zone uses NSEC3 2 checks passed Credits: 2 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/domain-report # Domain report API One report on a domain's DNS, registration, email setup and certificate, each with its own grade. `GET /v1/report` - Price: Costs 10 credits per call; cached answers cost the same. Calls that fail upstream (502) are free. - Cache: Answers are cached for up to 5 minutes; send fresh=true to ask the source again. - MCP tool: `domain_report` One graded report on a domain: DNS with DNSSEC and nameservers, registration, email setup, SSL and the website's HTTPS and security headers, each with its own grade, plus facts such as age and hosting. Costs 10 credits per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 5 minutes; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header. ## Query parameters | Name | Type | Required | Description | | --- | --- | --- | --- | | `domain` | string | yes | A domain or URL to report on. | | `fresh` | boolean | no | Skip the cache and ask the source again; costs the same. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.name` | string | yes | | | `data.unicode` | string | yes | | | `data.registrable` | string or null | yes | | | `data.grade` | string or null | yes | | | `data.sections` | object | yes | | | `data.facts` | object or null | yes | | | `data.section_order` | array of string | yes | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `402` Balance below the call's price (`insufficient_credits`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) - `502` Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to ## Example ```sh curl "https://api.dnssuper.com/v1/report?domain=example.com" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" ``` ```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/report", params={ "domain": "example.com", }) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch(`https://api.dnssuper.com/v1/report?${new URLSearchParams({"domain":"example.com"})}`, { 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); ``` Example response: ```json { "tool": "domain-report", "target": "example.com", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 10, "summary": "example.com gets an A. HSTS isn't set and your DMARC policy only monitors (p=none). DNS and registration look fine.", "score": 91, "findings": [ { "id": "hsts.missing", "severity": "fail", "title": "HSTS isn't set", "detail": "https://example.com/ sends no Strict-Transport-Security.", "fix": "Send Strict-Transport-Security: max-age=31536000; includeSubDomains over HTTPS." }, { "id": "dmarc.policy_none", "severity": "warn", "title": "Your DMARC policy only monitors (p=none)", "detail": "_dmarc.example.com says p=none.", "fix": "Move to p=quarantine, then p=reject, once reports show your mail passes." }, { "id": "spf.softfail_all", "severity": "warn", "title": "Your SPF record ends in ~all", "detail": "With p=none, ~all lets spoofed mail through.", "fix": "Move to -all once DMARC reports show all your mail passes." }, { "id": "ssl.expires_soon", "severity": "warn", "title": "Your certificate expires within 30 days", "detail": "The certificate on example.com and www.example.com expires on 26 November 2026.", "fix": "Renew the certificate or check that automatic renewal is set up." }, { "id": "dns.no_caa", "severity": "info", "title": "Your domain has no CAA record", "detail": "Any certificate authority may issue certificates for example.com.", "fix": "Add a CAA record naming the certificate authorities you use, for example 0 issue \"letsencrypt.org\", so no other authority will issue certificates for your domain." }, { "id": "dnssec.unsigned", "severity": "info", "title": "Your domain isn't signed with DNSSEC", "detail": "There is no DS record for example.com at the .com registry and no DNSKEY in the zone.", "fix": "Turn on DNSSEC at your DNS provider, then add the DS record it gives you at your registrar." }, { "id": "ns.consistent", "severity": "pass", "title": "Your nameservers all answer and agree", "detail": "2 nameservers, 2 addresses, serial 2026111401 everywhere.", "fix": "Nothing to do." }, { "id": "mx.ok", "severity": "pass", "title": "Your mail servers are set up", "detail": "1 MX host, smtp.google.com, resolves.", "fix": "Nothing to do." }, { "id": "dkim.found", "severity": "pass", "title": "DKIM keys found", "detail": "Selector google has a 2048-bit RSA key.", "fix": "Nothing to do." } ], "data": { "name": "example.com", "unicode": "example.com", "registrable": "example.com", "grade": "A", "sections": { "dns": { "section": "dns", "status": "ok", "score": 100, "grade": "A", "summary": "example.com resolves to 1 IPv4 and 1 IPv6 address, receives mail through 1 MX host and isn't DNSSEC-signed. example.com isn't signed with DNSSEC. Both of its nameservers answer and agree.", "checks": [ { "tool": "dns-lookup", "status": "ok", "cached": false, "fetched_at": "2026-11-14T10:00:00Z", "summary": "example.com resolves to 1 IPv4 and 1 IPv6 address, receives mail through 1 MX host and isn't DNSSEC-signed.", "findings": [ { "id": "dns.no_caa", "severity": "info", "title": "Your domain has no CAA record", "detail": "Any certificate authority may issue certificates for example.com.", "fix": "Add a CAA record naming the certificate authorities you use, for example 0 issue \"letsencrypt.org\", so no other authority will issue certificates for your domain." } ], "data": { "name": "example.com", "unicode": "example.com", "nxdomain": false, "dnssec": "insecure", "wildcard": false, "records": { "A": [ { "name": "example.com", "ttl": 300, "value": "192.0.2.10" } ], "AAAA": [ { "name": "example.com", "ttl": 300, "value": "2001:db8::10" } ], "CNAME": [], "MX": [ { "name": "example.com", "ttl": 3600, "value": "1 smtp.google.com" } ], "NS": [ { "name": "example.com", "ttl": 86400, "value": "anna.ns.cloudflare.com" }, { "name": "example.com", "ttl": 86400, "value": "bob.ns.cloudflare.com" } ], "TXT": [ { "name": "example.com", "ttl": 3600, "value": "v=spf1 include:_spf.google.com ~all" } ], "SOA": [ { "name": "example.com", "ttl": 3600, "value": "anna.ns.cloudflare.com dns.cloudflare.com 2026111401 10000 2400 604800 1800" } ], "CAA": [] }, "query_status": { "A": "ok", "AAAA": "ok", "CNAME": "nodata", "MX": "ok", "NS": "ok", "TXT": "ok", "SOA": "ok", "CAA": "nodata" }, "cname_chain": [], "hosts": { "smtp.google.com": { "A": [ "192.0.2.25" ], "AAAA": [], "roles": [ "MX" ], "status": "ok" }, "anna.ns.cloudflare.com": { "A": [ "198.51.100.1" ], "AAAA": [], "roles": [ "NS" ], "status": "ok" }, "bob.ns.cloudflare.com": { "A": [ "198.51.100.2" ], "AAAA": [], "roles": [ "NS" ], "status": "ok" } }, "min_ttl": 300 } }, { "tool": "dnssec-checker", "status": "ok", "cached": false, "fetched_at": "2026-11-14T10:00:00Z", "summary": "example.com isn't signed with DNSSEC. Both of its nameservers answer and agree.", "findings": [ { "id": "dnssec.unsigned", "severity": "info", "title": "Your domain isn't signed with DNSSEC", "detail": "There is no DS record for example.com at the .com registry and no DNSKEY in the zone.", "fix": "Turn on DNSSEC at your DNS provider, then add the DS record it gives you at your registrar." }, { "id": "ns.consistent", "severity": "pass", "title": "Your nameservers all answer and agree", "detail": "2 nameservers, 2 addresses, serial 2026111401 everywhere.", "fix": "Nothing to do." } ], "data": { "name": "example.com", "unicode": "example.com", "zone": "example.com", "parent": "com", "dnssec": "insecure", "extended_errors": [], "chain": [ { "zone": "com", "signed": true, "secure": true }, { "zone": "example.com", "signed": false, "secure": false } ], "ds": [], "dnskeys": [], "signatures": [], "parent_ns": [ "anna.ns.cloudflare.com", "bob.ns.cloudflare.com" ], "parent_ns_ttl": 172800, "child_ns": [ "anna.ns.cloudflare.com", "bob.ns.cloudflare.com" ], "nameservers": [ { "name": "anna.ns.cloudflare.com", "in_parent": true, "in_child": true, "glue": [], "addresses": [ "198.51.100.1" ], "status": "ok", "servers": [] }, { "name": "bob.ns.cloudflare.com", "in_parent": true, "in_child": true, "glue": [], "addresses": [ "198.51.100.2" ], "status": "ok", "servers": [] } ], "serials": { "2026111401": [ "198.51.100.1", "198.51.100.2" ] }, "ipv6_checked": false, "min_ttl": 300 } } ] }, "registration": { "section": "registration", "status": "ok", "score": 100, "grade": "A", "summary": "example.com is registered with Example Registrar, Inc. until 13 August 2027 (in 272 days). Transfers are locked.", "checks": [ { "tool": "whois-lookup", "status": "ok", "cached": false, "fetched_at": "2026-11-14T10:00:00Z", "summary": "example.com is registered with Example Registrar, Inc. until 13 August 2027 (in 272 days). Transfers are locked.", "findings": [], "data": { "name": "example.com", "unicode": "example.com", "tld": "com", "tier": "A", "source": "rdap", "registered": true, "registrar": { "name": "Example Registrar, Inc.", "iana_id": "9999", "url": "https://registrar.example.net", "abuse_email": "abuse@registrar.example.net" }, "created": "1995-08-14T04:00:00Z", "updated": "2026-08-14T07:01:34Z", "expires": "2027-08-13T04:00:00Z", "age_days": 11415, "days_to_expiry": 272, "statuses": [ "clientDeleteProhibited", "clientTransferProhibited", "clientUpdateProhibited" ], "nameservers": [ "anna.ns.cloudflare.com", "bob.ns.cloudflare.com" ], "dnssec": false, "redacted_fields": [ "registrant", "admin", "tech" ], "unpublished_fields": [] } } ] }, "email": { "section": "email", "status": "ok", "score": 87, "grade": "B", "summary": "example.com receives mail through Google Workspace and signs it with DKIM. Its DMARC policy only monitors, so spoofed mail isn't blocked yet.", "checks": [ { "tool": "email-checker", "status": "ok", "cached": false, "fetched_at": "2026-11-14T10:00:00Z", "summary": "example.com receives mail through Google Workspace and signs it with DKIM. Its DMARC policy only monitors, so spoofed mail isn't blocked yet.", "score": 87, "findings": [ { "id": "dmarc.policy_none", "severity": "warn", "title": "Your DMARC policy only monitors (p=none)", "detail": "_dmarc.example.com says p=none.", "fix": "Move to p=quarantine, then p=reject, once reports show your mail passes." }, { "id": "spf.softfail_all", "severity": "warn", "title": "Your SPF record ends in ~all", "detail": "With p=none, ~all lets spoofed mail through.", "fix": "Move to -all once DMARC reports show all your mail passes." }, { "id": "mx.ok", "severity": "pass", "title": "Your mail servers are set up", "detail": "1 MX host, smtp.google.com, resolves.", "fix": "Nothing to do." }, { "id": "dkim.found", "severity": "pass", "title": "DKIM keys found", "detail": "Selector google has a 2048-bit RSA key.", "fix": "Nothing to do." } ], "data": { "name": "example.com", "unicode": "example.com", "nxdomain": false, "providers": [ { "id": "google-workspace", "name": "Google Workspace", "source": "mx" } ], "mx": { "status": "ok", "null_mx": false, "implicit": false, "records": [ { "preference": 1, "host": "smtp.google.com", "ttl": 3600, "is_ip": false, "A": [ "192.0.2.25" ], "AAAA": [], "status": "ok", "provider": "google-workspace" } ] }, "spf": { "status": "found", "record": "v=spf1 include:_spf.google.com ~all", "records": [ "v=spf1 include:_spf.google.com ~all" ], "all": "~all", "lookups": 4, "lookup_limit": 10, "void_lookups": 0, "capped": false }, "dmarc": { "status": "found", "name": "_dmarc.example.com", "source": "exact", "record": "v=DMARC1; p=none; rua=mailto:dmarc@example.com", "policy": "none", "effective_policy": "none", "pct": 100, "adkim": "r", "aspf": "r", "reports": [ { "kind": "rua", "uri": "mailto:dmarc@example.com", "domain": "example.com", "external": false } ] }, "dkim": { "selectors_tried": [ "google", "default", "selector1", "selector2" ], "failed": [], "found": [ { "selector": "google", "name": "google._domainkey.example.com", "status": "ok", "key_type": "rsa", "key_bits": 2048, "testing": false, "provider": "google-workspace", "record": "v=DKIM1; k=rsa; p=MIIBIjANBgkqh..." } ] }, "policies": { "mta_sts": { "present": false }, "tls_rpt": { "present": false }, "bimi": { "present": false } }, "min_ttl": 300 } } ] }, "ssl": { "section": "ssl", "status": "ok", "score": 90, "grade": "A", "summary": "example.com's certificate is trusted and valid for 12 more days, covering example.com and www.example.com. The server offers TLS 1.3.", "checks": [ { "tool": "ssl-checker", "status": "ok", "cached": false, "fetched_at": "2026-11-14T10:00:00Z", "summary": "example.com's certificate is trusted and valid for 12 more days, covering example.com and www.example.com. The server offers TLS 1.3.", "score": 90, "findings": [ { "id": "ssl.expires_soon", "severity": "warn", "title": "Your certificate expires within 30 days", "detail": "The certificate on example.com and www.example.com expires on 26 November 2026.", "fix": "Renew the certificate or check that automatic renewal is set up." } ], "data": { "name": "example.com", "unicode": "example.com", "hosts": [ { "host": "example.com", "status": "ok", "address": "192.0.2.10", "tls": { "version": "TLSv1.3", "cipher": "TLS_AES_128_GCM_SHA256", "forward_secrecy": true, "alpn": "h2", "versions": { "TLSv1.3": true, "TLSv1.2": true }, "non_forward_secret": false, "ocsp_stapled": false }, "certificate": { "subject": "CN=example.com", "common_name": "example.com", "names": [ "example.com", "www.example.com" ], "issuer": "CN=R11,O=Let's Encrypt,C=US", "issuer_org": "Let's Encrypt", "caa_identifiers": [ "letsencrypt.org" ], "serial": "04a1", "not_before": "2026-08-28T00:00:00Z", "not_after": "2026-11-26T23:59:59Z", "days_left": 12, "key": { "type": "EC", "size": 256, "curve": "secp256r1" }, "signature_algorithm": "sha256WithRSAEncryption", "sha256": "ab12", "scts": 2 }, "chain": [], "trust": { "trusted": true, "hostname_match": true, "root": "ISRG Root X1", "path": [ "example.com", "R11", "ISRG Root X1" ] } }, { "host": "www.example.com", "status": "ok", "address": "192.0.2.10", "chain": [], "trust": { "trusted": true, "hostname_match": true, "root": "ISRG Root X1", "path": [] } } ], "trust_store": { "source": "certifi", "version": "2026.10.5" }, "legacy_versions_tested": true } } ] }, "website": { "section": "website", "status": "ok", "score": 80, "grade": "B", "summary": "example.com gets a B for its HTTP headers. HSTS is missing.", "checks": [ { "tool": "security-headers", "status": "ok", "cached": false, "fetched_at": "2026-11-14T10:00:00Z", "summary": "example.com gets a B for its HTTP headers. HSTS is missing.", "score": 80, "findings": [ { "id": "hsts.missing", "severity": "fail", "title": "HSTS isn't set", "detail": "https://example.com/ sends no Strict-Transport-Security.", "fix": "Send Strict-Transport-Security: max-age=31536000; includeSubDomains over HTTPS." } ], "data": { "host": "example.com", "alternate_host": "www.example.com", "reachable": true, "no_website": false, "entry_points": [] } } ] } }, "facts": { "domain_age_days": 11415, "created": "1995-08-14T04:00:00Z", "expires": "2027-08-13T04:00:00Z", "days_to_expiry": 272, "registrar": "Example Registrar, Inc.", "dns_host": { "id": "cloudflare", "name": "Cloudflare", "source": "ns" }, "mail_provider": { "id": "google-workspace", "name": "Google Workspace", "source": "mx" }, "web_host": { "id": "vercel", "name": "Vercel", "source": "cname" }, "addresses": [ "192.0.2.10", "2001:db8::10" ], "network": { "asn": 64496, "name": "EXAMPLE-NET", "country": "NL" } }, "section_order": [ "dns", "registration", "email", "facts", "website", "ssl" ] }, "credits_remaining": 498 } ``` ## MCP ```json { "tool": "domain_report", "arguments": { "domain": "example.com" } } ``` ```text example.com gets an A. HSTS isn't set and your DMARC policy only monitors (p=none). DNS and registration look fine. Score: 91/100 Grade: A DNS: A. example.com resolves to 1 IPv4 and 1 IPv6 address, receives mail through 1 MX host and isn't DNSSEC-signed. Registration: A. example.com is registered with Example Registrar, Inc. until 13 August 2027 (in 272 days). Email: B. example.com receives mail through Google Workspace and signs it with DKIM. SSL: A. example.com's certificate is trusted and valid for 12 more days, covering example.com and www.example.com. Website: B. example.com gets a B for its HTTP headers. Facts: registered 1995-08-14 (11415 days ago); expires 2027-08-13 (in 272 days); registrar Example Registrar, Inc.; DNS Cloudflare; mail Google Workspace; web Vercel; addresses 192.0.2.10, 2001:db8... - fail: HSTS isn't set. Fix: Send Strict-Transport-Security: max-age=31536000; includeSubDomains over HTTPS. - warn: Your DMARC policy only monitors (p=none). Fix: Move to p=quarantine, then p=reject, once reports show your mail passes. - warn: Your SPF record ends in ~all. Fix: Move to -all once DMARC reports show all your mail passes. - warn: Your certificate expires within 30 days. Fix: Renew the certificate or check that automatic renewal is set up. +2 more findings (pass detail='full' to see all) 3 checks passed Credits: 10 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/spf-generator # SPF builder API Build an SPF record from the services that send your mail, or check one you already have, with its lookup count. `POST /v1/build/spf` - Price: Free; any API key works and nothing is charged. - Cache: Never cached; every call runs again. - MCP tool: `build_dns_record` An SPF record built from your senders, or a pasted record checked, with its DNS lookup count and the include tree. Free; any API key works and nothing is charged. Never cached; every call runs again. ## Request body | Name | Type | Required | Description | | --- | --- | --- | --- | | `domain` | string or null | no | Your domain; needed for the mx and a mechanisms and to count lookups. | | `record` | string or null | no | An existing SPF record to check instead of building one. | | `providers` | array of string or null | no | Mail services that send for your domain. | | `includes` | array of string or null | no | Other include domains, one per line. | | `ip4` | array of string or null | no | IPv4 addresses or ranges that send mail, one per line. | | `ip6` | array of string or null | no | IPv6 addresses or ranges that send mail, one per line. | | `a` | boolean or null | no | The domain's own web server sends mail. | | `mx` | boolean or null | no | The domain's mail servers also send mail. | | `all` | "-all" | "~all" | no | What receivers do with mail from anyone else. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.kind` | "spf" | "dmarc" | "caa" | yes | | | `data.name` | string | yes | | | `data.type` | "TXT" | "CAA" | yes | | | `data.value` | string | yes | | | `data.strings` | array of string | yes | | | `data.length` | integer | yes | | | `data.zone_line` | string | yes | | | `data.mode` | "build" | "validate" | yes | | | `data.spf` | object or null | no | | | `data.dmarc` | object or null | no | | | `data.caa` | object or null | no | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) ## Example ```sh curl -X POST "https://api.dnssuper.com/v1/build/spf" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" \ -H "Content-Type: application/json" \ -d '{"domain":"example.com"}' ``` ```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.post("/v1/build/spf", json={ "domain": "example.com", }) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch("https://api.dnssuper.com/v1/build/spf", { method: "POST", headers: { Authorization: `Bearer ${process.env.DNSSUPER_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({"domain":"example.com"}), }); if (!response.ok) throw new Error((await response.json()).error.message); const result = await response.json(); console.log(result.summary, result.credits_used); ``` Example response: ```json { "tool": "spf-generator", "target": "", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 0, "summary": "Your SPF record is ready to publish as a TXT record. It needs 6 of the 10 DNS lookups receivers allow.", "findings": [ { "id": "spf_builder.softfail", "severity": "info", "title": "This record ends in ~all", "detail": "", "fix": "Move to -all once DMARC reports show all your mail passes." } ], "data": { "kind": "spf", "name": "example.com", "type": "TXT", "value": "v=spf1 mx include:_spf.google.com include:sendgrid.net ~all", "strings": [ "v=spf1 mx include:_spf.google.com include:sendgrid.net ~all" ], "length": 59, "zone_line": "example.com. 3600 IN TXT \"v=spf1 mx include:_spf.google.com include:sendgrid.net ~all\"", "mode": "build", "spf": { "lookups": 6, "lookup_limit": 10, "void_lookups": 0, "capped": false, "tree": { "domain": "example.com", "status": "given", "record": "v=spf1 mx include:_spf.google.com include:sendgrid.net ~all", "errors": [], "terms": [ { "term": "mx", "mechanism": "mx", "qualifier": "+", "target": "example.com", "counted": true, "status": "ok", "addresses": [ "93.184.215.20" ], "hosts": [ "mx1.example.com" ], "detail": "" }, { "term": "include:_spf.google.com", "mechanism": "include", "qualifier": "+", "target": "_spf.google.com", "counted": true, "status": "ok", "addresses": [], "hosts": [], "detail": "", "child": { "domain": "_spf.google.com", "status": "found", "record": "v=spf1 include:_netblocks.google.com include:_netblocks2.google.com include:_netblocks3.google.com ~all", "errors": [], "terms": [ { "term": "include:_netblocks.google.com", "mechanism": "include", "qualifier": "+", "target": "_netblocks.google.com", "counted": true, "status": "ok", "addresses": [], "hosts": [], "detail": "", "child": { "domain": "_netblocks.google.com", "status": "found", "record": "v=spf1 ip4:35.190.247.0/24 ip4:64.233.160.0/19 ip4:66.102.0.0/20 ip4:66.249.80.0/20 ip4:72.14.192.0/18 ~all", "errors": [], "terms": [ { "term": "ip4:35.190.247.0/24", "mechanism": "ip4", "qualifier": "+", "target": "35.190.247.0", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "ip4:64.233.160.0/19", "mechanism": "ip4", "qualifier": "+", "target": "64.233.160.0", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "ip4:66.102.0.0/20", "mechanism": "ip4", "qualifier": "+", "target": "66.102.0.0", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "ip4:66.249.80.0/20", "mechanism": "ip4", "qualifier": "+", "target": "66.249.80.0", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "ip4:72.14.192.0/18", "mechanism": "ip4", "qualifier": "+", "target": "72.14.192.0", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "~all", "mechanism": "all", "qualifier": "~", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" } ] } }, { "term": "include:_netblocks2.google.com", "mechanism": "include", "qualifier": "+", "target": "_netblocks2.google.com", "counted": true, "status": "ok", "addresses": [], "hosts": [], "detail": "", "child": { "domain": "_netblocks2.google.com", "status": "found", "record": "v=spf1 ip6:2001:4860:4000::/36 ip6:2404:6800:4000::/36 ip6:2607:f8b0:4000::/36 ~all", "errors": [], "terms": [ { "term": "ip6:2001:4860:4000::/36", "mechanism": "ip6", "qualifier": "+", "target": "2001:4860:4000::", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "ip6:2404:6800:4000::/36", "mechanism": "ip6", "qualifier": "+", "target": "2404:6800:4000::", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "ip6:2607:f8b0:4000::/36", "mechanism": "ip6", "qualifier": "+", "target": "2607:f8b0:4000::", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "~all", "mechanism": "all", "qualifier": "~", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" } ] } }, { "term": "include:_netblocks3.google.com", "mechanism": "include", "qualifier": "+", "target": "_netblocks3.google.com", "counted": true, "status": "ok", "addresses": [], "hosts": [], "detail": "", "child": { "domain": "_netblocks3.google.com", "status": "found", "record": "v=spf1 ip4:172.217.0.0/19 ip4:172.217.32.0/20 ip4:108.177.96.0/19 ~all", "errors": [], "terms": [ { "term": "ip4:172.217.0.0/19", "mechanism": "ip4", "qualifier": "+", "target": "172.217.0.0", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "ip4:172.217.32.0/20", "mechanism": "ip4", "qualifier": "+", "target": "172.217.32.0", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "ip4:108.177.96.0/19", "mechanism": "ip4", "qualifier": "+", "target": "108.177.96.0", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "~all", "mechanism": "all", "qualifier": "~", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" } ] } }, { "term": "~all", "mechanism": "all", "qualifier": "~", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" } ] } }, { "term": "include:sendgrid.net", "mechanism": "include", "qualifier": "+", "target": "sendgrid.net", "counted": true, "status": "ok", "addresses": [], "hosts": [], "detail": "", "child": { "domain": "sendgrid.net", "status": "found", "record": "v=spf1 ip4:167.89.0.0/17 ip4:208.117.48.0/20 ~all", "errors": [], "terms": [ { "term": "ip4:167.89.0.0/17", "mechanism": "ip4", "qualifier": "+", "target": "167.89.0.0", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "ip4:208.117.48.0/20", "mechanism": "ip4", "qualifier": "+", "target": "208.117.48.0", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "~all", "mechanism": "all", "qualifier": "~", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" } ] } }, { "term": "~all", "mechanism": "all", "qualifier": "~", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" } ] }, "flattening": { "needed": false, "advice": "" } } }, "credits_remaining": 498 } ``` ## MCP ```json { "tool": "build_dns_record", "arguments": { "domain": "example.com" } } ``` ```text Your SPF record is ready to publish as a TXT record. It needs 6 of the 10 DNS lookups receivers allow. Name: example.com (TXT) Value: v=spf1 mx include:_spf.google.com include:sendgrid.net ~all Lookups: 6 of 10 Zone line: example.com. 3600 IN TXT "v=spf1 mx include:_spf.google.com include:sendgrid.net ~all" - info: This record ends in ~all Free | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/dmarc-generator # DMARC builder API Build a DMARC record step by step, with a rollout plan from monitoring to reject and the records report services need. `POST /v1/build/dmarc` - Price: Free; any API key works and nothing is charged. - Cache: Never cached; every call runs again. - MCP tool: `build_dns_record` A DMARC record built from your choices, with a rollout plan and the authorization records external report addresses need. Free; any API key works and nothing is charged. Never cached; every call runs again. ## Request body | Name | Type | Required | Description | | --- | --- | --- | --- | | `domain` | string or null | no | Your domain; names the record and checks report addresses. | | `policy` | "none" | "quarantine" | "reject" | yes | What receivers do with mail that fails DMARC. | | `subdomain_policy` | "none" | "quarantine" | "reject" or null | no | A different policy for subdomains; leave empty to use the main policy. | | `pct` | integer | no | Percentage of failing mail the policy applies to. | | `rua` | array of string or null | no | Addresses for daily aggregate reports, one per line. | | `ruf` | array of string or null | no | Addresses for failure reports, one per line. | | `adkim` | "r" | "s" | no | DKIM alignment, relaxed or strict. | | `aspf` | "r" | "s" | no | SPF alignment, relaxed or strict. | | `fo` | "0" | "1" | "d" | "s" or null | no | When failure reports are sent. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.kind` | "spf" | "dmarc" | "caa" | yes | | | `data.name` | string | yes | | | `data.type` | "TXT" | "CAA" | yes | | | `data.value` | string | yes | | | `data.strings` | array of string | yes | | | `data.length` | integer | yes | | | `data.zone_line` | string | yes | | | `data.mode` | "build" | "validate" | yes | | | `data.spf` | object or null | no | | | `data.dmarc` | object or null | no | | | `data.caa` | object or null | no | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) ## Example ```sh curl -X POST "https://api.dnssuper.com/v1/build/dmarc" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" \ -H "Content-Type: application/json" \ -d '{"domain":"example.com"}' ``` ```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.post("/v1/build/dmarc", json={ "domain": "example.com", }) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch("https://api.dnssuper.com/v1/build/dmarc", { method: "POST", headers: { Authorization: `Bearer ${process.env.DNSSUPER_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({"domain":"example.com"}), }); if (!response.ok) throw new Error((await response.json()).error.message); const result = await response.json(); console.log(result.summary, result.credits_used); ``` Example response: ```json { "tool": "dmarc-generator", "target": "", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 0, "summary": "Your DMARC record is ready: publish it as a TXT record at _dmarc.example.com. The report domains it names must publish the authorization records listed.", "findings": [ { "id": "dmarc_builder.external_reports", "severity": "info", "title": "Reports go to another domain", "detail": "reports.example.net", "fix": "That domain must publish an authorization record; the result lists it." } ], "data": { "kind": "dmarc", "name": "_dmarc.example.com", "type": "TXT", "value": "v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com,mailto:agg@reports.example.net", "strings": [ "v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com,mailto:agg@reports.example.net" ], "length": 83, "zone_line": "_dmarc.example.com. 3600 IN TXT \"v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com,mailto:agg@reports.example.net\"", "mode": "build", "dmarc": { "rollout": [ { "stage": 1, "policy": "none", "value": "v=DMARC1; p=none; rua=mailto:dmarc@example.com,mailto:agg@reports.example.net", "when": "Now: collect reports for two to four weeks and fix any sender that fails." }, { "stage": 2, "policy": "quarantine", "value": "v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com,mailto:agg@reports.example.net", "when": "When reports show all your own mail passes." }, { "stage": 3, "policy": "reject", "value": "v=DMARC1; p=reject; rua=mailto:dmarc@example.com,mailto:agg@reports.example.net", "when": "After a few weeks on quarantine without surprises." } ], "report_authorizations": [ { "domain": "reports.example.net", "name": "example.com._report._dmarc.reports.example.net", "value": "v=DMARC1" } ] } }, "credits_remaining": 498 } ``` ## MCP ```json { "tool": "build_dns_record", "arguments": { "domain": "example.com" } } ``` ```text Your DMARC record is ready: publish it as a TXT record at _dmarc.example.com. The report domains it names must publish the authorization records listed. Name: _dmarc.example.com (TXT) Value: v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com,mailto:agg@reports.example.net Zone line: _dmarc.example.com. 3600 IN TXT "v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com,mailto:agg@reports.example.net" Authorization needed: example.com._report._dmarc.reports.example.net TXT "v=DMARC1" - info: Reports go to another domain Free | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/caa-generator # CAA builder API Build CAA records that name the certificate authorities allowed to issue for your domain, without locking out your own. `POST /v1/build/caa` - Price: Free; any API key works and nothing is charged. - Cache: Never cached; every call runs again. - MCP tool: `build_dns_record` CAA records built from the certificate authorities you choose, as zone file lines. Free; any API key works and nothing is charged. Never cached; every call runs again. ## Request body | Name | Type | Required | Description | | --- | --- | --- | --- | | `domain` | string or null | no | Your domain; names the records. | | `issue` | array of string | yes | Certificate authorities allowed to issue, by id or CAA identifier; an empty list means no authority may issue. | | `wildcard` | "same" | "none" | "custom" | no | Who may issue wildcard certificates. | | `issuewild` | array of string or null | no | Authorities allowed to issue wildcard certificates, when wildcard is custom. | | `validation_methods` | array of "dns-01" | "http-01" | "tls-alpn-01" or null | no | Allowed validation methods, for every authority listed. | | `account_uri` | string or null | no | Your ACME account URI; only with exactly one authority. | | `iodef` | string or null | no | Where authorities report refused requests (mailto or https). | | `current_issuer` | string or null | no | The authority that issued your current certificate, to warn before locking it out. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.kind` | "spf" | "dmarc" | "caa" | yes | | | `data.name` | string | yes | | | `data.type` | "TXT" | "CAA" | yes | | | `data.value` | string | yes | | | `data.strings` | array of string | yes | | | `data.length` | integer | yes | | | `data.zone_line` | string | yes | | | `data.mode` | "build" | "validate" | yes | | | `data.spf` | object or null | no | | | `data.dmarc` | object or null | no | | | `data.caa` | object or null | no | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) ## Example ```sh curl -X POST "https://api.dnssuper.com/v1/build/caa" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" \ -H "Content-Type: application/json" \ -d '{"domain":"example.com"}' ``` ```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.post("/v1/build/caa", json={ "domain": "example.com", }) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch("https://api.dnssuper.com/v1/build/caa", { method: "POST", headers: { Authorization: `Bearer ${process.env.DNSSUPER_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({"domain":"example.com"}), }); if (!response.ok) throw new Error((await response.json()).error.message); const result = await response.json(); console.log(result.summary, result.credits_used); ``` Example response: ```json { "tool": "caa-generator", "target": "", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 0, "summary": "These 3 CAA records for example.com are ready to publish.", "findings": [], "data": { "kind": "caa", "name": "example.com", "type": "CAA", "value": "0 issue \"letsencrypt.org\"\n0 issue \"pki.goog\"\n0 iodef \"mailto:security@example.com\"", "strings": [ "0 issue \"letsencrypt.org\"", "0 issue \"pki.goog\"", "0 iodef \"mailto:security@example.com\"" ], "length": 82, "zone_line": "example.com. 3600 IN CAA 0 issue \"letsencrypt.org\"\nexample.com. 3600 IN CAA 0 issue \"pki.goog\"\nexample.com. 3600 IN CAA 0 iodef \"mailto:security@example.com\"", "mode": "build", "caa": { "records": [ { "flags": 0, "tag": "issue", "value": "letsencrypt.org", "presentation": "0 issue \"letsencrypt.org\"" }, { "flags": 0, "tag": "issue", "value": "pki.goog", "presentation": "0 issue \"pki.goog\"" }, { "flags": 0, "tag": "iodef", "value": "mailto:security@example.com", "presentation": "0 iodef \"mailto:security@example.com\"" } ], "zone_lines": [ "example.com. 3600 IN CAA 0 issue \"letsencrypt.org\"", "example.com. 3600 IN CAA 0 issue \"pki.goog\"", "example.com. 3600 IN CAA 0 iodef \"mailto:security@example.com\"" ] } }, "credits_remaining": 498 } ``` ## MCP ```json { "tool": "build_dns_record", "arguments": { "domain": "example.com" } } ``` ```text These 3 CAA records for example.com are ready to publish. Name: example.com (CAA) Zone line: example.com. 3600 IN CAA 0 issue "letsencrypt.org" Zone line: example.com. 3600 IN CAA 0 issue "pki.goog" Zone line: example.com. 3600 IN CAA 0 iodef "mailto:security@example.com" No issues found. Free | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/dkim-checker # DKIM record validator API Check a DKIM record: look it up by selector or paste it, and see its key type, size, flags and problems. `POST /v1/dkim-record` - Price: Free; any API key works and nothing is charged. - Cache: Never cached; every call runs again. - MCP tool: `validate_dkim_record` A DKIM record, pasted or looked up by selector, parsed into its key type, key size, flags and hash algorithms. Free; any API key works and nothing is charged. Never cached; every call runs again. ## Request body | Name | Type | Required | Description | | --- | --- | --- | --- | | `record` | string or null | no | A DKIM record to check, pasted as text. | | `domain` | string or null | no | Or a domain, with its selector, to look the record up. | | `selector` | string or null | no | The DKIM selector, such as google or s1. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.source` | "pasted" | "dns" | yes | | | `data.name` | string or null | yes | | | `data.record` | string or null | yes | | | `data.query_status` | string or null | yes | | | `data.version` | string or null | yes | | | `data.key_type` | string or null | yes | | | `data.key_bits` | integer or null | yes | | | `data.revoked` | boolean | yes | | | `data.testing` | boolean | yes | | | `data.strict` | boolean | yes | | | `data.hash_algorithms` | array of string or null | yes | | | `data.service_types` | array of string | yes | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) ## Example ```sh curl -X POST "https://api.dnssuper.com/v1/dkim-record" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" \ -H "Content-Type: application/json" \ -d '{"domain":"example.com"}' ``` ```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.post("/v1/dkim-record", json={ "domain": "example.com", }) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch("https://api.dnssuper.com/v1/dkim-record", { method: "POST", headers: { Authorization: `Bearer ${process.env.DNSSUPER_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({"domain":"example.com"}), }); if (!response.ok) throw new Error((await response.json()).error.message); const result = await response.json(); console.log(result.summary, result.credits_used); ``` Example response: ```json { "tool": "dkim-checker", "target": "", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 0, "summary": "The DKIM record at s2048._domainkey.example.com is valid (a 2048-bit RSA key).", "findings": [ { "id": "dkim_record.valid", "severity": "pass", "title": "The DKIM record is valid", "detail": "", "fix": "Nothing to do." } ], "data": { "source": "dns", "name": "s2048._domainkey.example.com", "record": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEApTGFY+knX9gV8lx+vLMRL+4h2Vef2XWTq1+IUtMY/ZRRoGQG31IR2Yz+FkzYaolUU2JMq2NbUzELco8z3Ef/iPmN4wITl7/cTQnwbn15fwvgeP59ICpyWpGtr/aq83ISRBjKEfTlRub1tRG/VVps0QaD4GjVBMGVPLYKKvlT9gG2Bzd86bLTkPOJcVHhjzqytVoqVW09guYc9W6J2XDfTES0ocQ7/p4zDR6/wmR4su5wwcy8C5GpeyKNERmR6w9DvH0c1ySrjtpvBMjDu4LTT4ruHJCHLqbWA1M31nFAi30vasgB0q6JZcEcOyM1ByetpiuqLfWNTLBm+RWQe4BguQIDAQAB", "query_status": "ok", "version": "DKIM1", "key_type": "rsa", "key_bits": 2048, "revoked": false, "testing": false, "strict": false, "service_types": [ "*" ] }, "credits_remaining": 498 } ``` ## MCP ```json { "tool": "validate_dkim_record", "arguments": { "domain": "example.com" } } ``` ```text The DKIM record at s2048._domainkey.example.com is valid (a 2048-bit RSA key). Looked up: s2048._domainkey.example.com Key: 2048-bit RSA 1 check passed Free | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/punycode-converter # IDN and punycode API Convert domain names between Unicode and punycode, and see which characters could fool a reader. `GET /v1/idn` - Price: Free; any API key works and nothing is charged. - Cache: Never cached; every call runs again. - MCP tool: `convert_idn` A domain converted between Unicode and punycode, label by label, with the scripts used, lookalike warnings and how browsers will likely show it. Free; any API key works and nothing is charged. Never cached; every call runs again. ## Query parameters | Name | Type | Required | Description | | --- | --- | --- | --- | | `name` | string | yes | A domain, label or URL, in Unicode or punycode. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.input` | string | yes | | | `data.direction` | "to_ascii" | "to_unicode" | "ascii_only" | yes | | | `data.ascii` | string or null | yes | | | `data.unicode` | string | yes | | | `data.valid` | boolean | yes | | | `data.labels` | array of object | yes | | | `data.labels.unicode` | string | yes | | | `data.labels.ascii` | string or null | yes | The A-label or ASCII label; null when invalid. | | `data.labels.valid` | boolean | yes | | | `data.labels.error` | object or null | yes | | | `data.labels.scripts` | array of string | yes | | | `data.labels.mixed_script` | boolean | yes | | | `data.labels.restriction` | "ascii" | "single_script" | "highly_restrictive" | "moderately_restrictive" | "minimally_restrictive" | yes | | | `data.labels.chars` | array of object | yes | Non-ASCII characters, at most 63. | | `data.labels.skeleton` | string | yes | | | `data.labels.imitates_ascii` | boolean | yes | | | `data.skeleton` | string | yes | | | `data.imitates` | string or null | yes | The ASCII name this one can pass for, if any. | | `data.transitional_ascii` | string or null | yes | What IDNA 2003 (transitional) software makes of the name, when it differs. | | `data.display` | object | yes | | | `data.display.likely` | "unicode" | "punycode" | yes | | | `data.display.reason` | string | yes | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) ## Example ```sh curl "https://api.dnssuper.com/v1/idn?name=b%C3%BCcher.example" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" ``` ```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/idn", params={ "name": "bücher.example", }) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch(`https://api.dnssuper.com/v1/idn?${new URLSearchParams({"name":"bücher.example"})}`, { 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); ``` Example response: ```json { "tool": "punycode-converter", "target": "", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 0, "summary": "bücher.example in punycode is xn--bcher-kva.example.", "findings": [], "data": { "input": "bücher.example", "direction": "to_ascii", "ascii": "xn--bcher-kva.example", "unicode": "bücher.example", "valid": true, "labels": [ { "unicode": "bücher", "ascii": "xn--bcher-kva", "valid": true, "scripts": [ "Latin" ], "mixed_script": false, "restriction": "single_script", "chars": [ { "char": "ü", "codepoint": "U+00FC", "name": "LATIN SMALL LETTER U WITH DIAERESIS", "scripts": [ "Latin" ], "identifier": "allowed" } ], "skeleton": "bücher", "imitates_ascii": false }, { "unicode": "example", "ascii": "example", "valid": true, "scripts": [ "Latin" ], "mixed_script": false, "restriction": "ascii", "chars": [], "skeleton": "exarnple", "imitates_ascii": false } ], "skeleton": "bücher.exarnple", "display": { "likely": "unicode", "reason": "Each label sticks to one writing system without lookalikes, so browsers will likely show it in Unicode." } }, "credits_remaining": 498 } ``` ## MCP ```json { "tool": "convert_idn", "arguments": { "name": "bücher.example" } } ``` ```text bücher.example in punycode is xn--bcher-kva.example. ASCII: xn--bcher-kva.example Unicode: bücher.example Label 1: Latin, single script, 1 non-ASCII character Label 2: plain ASCII Browsers will likely show: unicode (Each label sticks to one writing system without lookalikes, so browsers will likely show it in Unicode.) No issues found. Free | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/dns-migration-checker # Migration checker API Before you switch DNS providers, compare the new nameservers with the current ones, record by record. `POST /v1/migration` - Price: Costs 5 credits, reserved when the job starts and charged when it finishes. Failed runs are free. - Cache: Answers are cached for up to 1 minute; send fresh=true to ask the source again. - MCP tool: `check_migration` Record by record, how the new nameservers' answers compare with the current ones before you switch, with DNSSEC and TTL advice. Costs 5 credits, reserved when the job starts and charged when it finishes. Failed runs are free. Answers are cached for up to 1 minute; send fresh=true to ask the source again. ## Request body | Name | Type | Required | Description | | --- | --- | --- | --- | | `domain` | string | yes | The zone you are moving, such as example.com. | | `new_nameservers` | array of string | yes | The new provider's nameservers, one per line. | | `names` | array of string or null | no | Extra names to compare, such as www or mail, one per line. | | `fresh` | boolean | no | Skip the cache and ask the source again; costs the same. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `job_id` | string | yes | The job's ID; poll GET /v1/jobs/{id} | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.domain` | string | yes | | | `data.zone` | string | yes | | | `data.ready` | boolean | yes | | | `data.already_switched` | boolean | yes | | | `data.parent_ns` | array of string | yes | | | `data.parent_ns_ttl` | integer or null | no | | | `data.current_server` | object or null | no | | | `data.new_servers` | array of object | yes | | | `data.new_servers.name` | string | yes | | | `data.new_servers.address` | string or null | no | | | `data.new_servers.status` | "ok" | "not_authoritative" | "unreachable" | "no_address" | yes | | | `data.new_servers.serial` | integer or null | no | | | `data.rows` | array of object | yes | | | `data.rows.name` | string | yes | | | `data.rows.type` | string | yes | | | `data.rows.result` | "same" | "missing" | "different" | "extra" | "ttl_differs" | "unknown" | yes | | | `data.rows.current` | object | yes | | | `data.rows.new` | array of object | yes | | | `data.checked_names` | integer | yes | | | `data.names_from` | object | yes | | | `data.dnssec` | object | yes | | | `data.dnssec.parent_ds` | boolean or null | yes | The parent publishes a DS record; null when its DS couldn't be read | | `data.dnssec.new_signing` | boolean or null | no | | | `data.dnssec.ds_matches_new` | boolean or null | no | | | `data.max_record_ttl` | integer or null | no | | | `data.min_ttl` | integer or null | no | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `402` Balance below the call's price (`insufficient_credits`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) ## Example ```sh curl -X POST "https://api.dnssuper.com/v1/migration" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" \ -H "Content-Type: application/json" \ -d '{"domain":"example.com"}' ``` ```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.post("/v1/migration", json={ "domain": "example.com", }) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch("https://api.dnssuper.com/v1/migration", { method: "POST", headers: { Authorization: `Bearer ${process.env.DNSSUPER_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({"domain":"example.com"}), }); if (!response.ok) throw new Error((await response.json()).error.message); const result = await response.json(); console.log(result.summary, result.credits_used); ``` Example response: ```json { "job_id": "5ef1741e-8198-585b-8440-2b6634de62c9", "status": "queued", "total": 1, "credits_reserved": 5, "duplicates_removed": 0, "job_url": "https://api.dnssuper.localhost/v1/jobs/5ef1741e-8198-585b-8440-2b6634de62c9", "items_url": "https://api.dnssuper.localhost/v1/jobs/5ef1741e-8198-585b-8440-2b6634de62c9/items", "events_url": "https://api.dnssuper.localhost/v1/jobs/5ef1741e-8198-585b-8440-2b6634de62c9/events" } ``` ## MCP ```json { "tool": "check_migration", "arguments": { "domain": "example.com" } } ``` ```text example.com is ready to move: the new nameservers answer the same way for all 81 names we compared. Ready: yes Current: ns1.old-dns.example.net (192.0.2.1), serial 2026111401 New: ns1.new-dns.example.net (198.51.100.1) (ok, serial 2026111401); ns2.new-dns.example.net (198.51.100.2) (ok, serial 2026111401) Compared: 81 names, 12 records: 12 same - info: We checked 81 names; DNS can't list the rest - info: Lower your TTLs before you switch 1 check passed Credits: 5 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/subdomain-takeover-check # Dangling record check API Find DNS records that point to services, zones or domains you no longer control, before someone else claims them. `POST /v1/dangling` - Price: Costs 1 credit per name; cached answers cost the same. Names that fail upstream are free. - Cache: Answers are cached for the lowest record TTL, between 1 minute and 1 hour; send fresh=true to ask the source again. - MCP tool: `check_dangling_records` For each name, whether its CNAME, NS or address records point to a service, zone or domain that someone else could claim. Costs 1 credit per name; cached answers cost the same. Names that fail upstream are free. Answers are cached for the lowest record TTL, between 1 minute and 1 hour; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header. ## Request body | Name | Type | Required | Description | | --- | --- | --- | --- | | `names` | array of string | yes | The names to check, one per line, such as shop.example.com. | | `fresh` | boolean | no | Skip the cache and ask the source again; costs the same. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.name` | string | yes | | | `data.unicode` | string | yes | | | `data.exists` | boolean | yes | | | `data.cname_chain` | array of object | yes | | | `data.cname_chain.name` | string | yes | | | `data.cname_chain.target` | string | yes | | | `data.cname_chain.ttl` | integer | yes | | | `data.final_target` | string | yes | | | `data.final_status` | "ok" | "nxdomain" | "nodata" | "failed" | yes | | | `data.addresses` | array of string | yes | | | `data.provider` | object or null | no | | | `data.evidence` | object or null | no | | | `data.delegation` | object or null | no | | | `data.risk` | "high" | "medium" | "low" | "none" | "unknown" | yes | high: looks claimable now; medium: may be; low: broken but not claimable | | `data.min_ttl` | integer or null | no | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `402` Balance below the call's price (`insufficient_credits`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) - `502` Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to ## Example ```sh curl -X POST "https://api.dnssuper.com/v1/dangling" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" \ -H "Content-Type: application/json" \ -d '{}' ``` ```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.post("/v1/dangling", json={}) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch("https://api.dnssuper.com/v1/dangling", { method: "POST", headers: { Authorization: `Bearer ${process.env.DNSSUPER_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({}), }); if (!response.ok) throw new Error((await response.json()).error.message); const result = await response.json(); console.log(result.summary, result.credits_used); ``` Example response: ```json { "tool": "subdomain-takeover-check", "target": "shop.example.com", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 1, "summary": "shop.example.com looks like it could be taken over: GitHub Pages says it has no site for this name.", "findings": [ { "id": "dangling.service_unclaimed", "severity": "fail", "title": "This name points to a service where it looks unclaimed", "detail": "shop.example.com points to GitHub Pages, and its page says \"There isn't a GitHub Pages site here.\" (HTTP 404). The name looks unclaimed at the service, so someone else could claim it.", "fix": "Remove the DNS record now, or set the name up again in your account at that service." } ], "data": { "name": "shop.example.com", "unicode": "shop.example.com", "exists": true, "cname_chain": [ { "name": "shop.example.com", "target": "gone-user.github.io", "ttl": 300 } ], "final_target": "gone-user.github.io", "final_status": "ok", "addresses": [ "185.199.108.153" ], "provider": { "id": "github-pages", "name": "GitHub Pages", "takeover": "possible" }, "evidence": { "kind": "http", "http_status": 404, "matched": "There isn't a GitHub Pages site here." }, "risk": "high", "min_ttl": 300 }, "credits_remaining": 498 } ``` ## MCP ```json { "tool": "check_dangling_records", "arguments": {} } ``` ```text shop.example.com looks like it could be taken over: GitHub Pages says it has no site for this name. Risk: high (GitHub Pages) Chain: shop.example.com -> gone-user.github.io Evidence: the page says "There isn't a GitHub Pages site here." (HTTP 404) - fail: This name points to a service where it looks unclaimed. Fix: Remove the DNS record now, or set the name up again in your account at that service. Credits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/lookalike-domains # Lookalike detection API Find registered domains that look like yours: typos, swapped letters and look-alike characters. `GET /v1/lookalikes` - Price: Free; any API key works and nothing is charged. With check=true it costs credits (1 per 10 checked) and runs as a job: the most it can cost is reserved when it starts, and only what was done is charged when it finishes. Failed runs are free. - Cache: Answers are cached for up to 1 hour; send fresh=true to ask the source again. - MCP tool: `find_lookalikes` Lookalike variants of a domain (typos, look-alike characters, other endings, bit flips), and, as a job, which of them are registered, with their nameservers, mail servers, homepage title, registration date and a risk rating. Free; any API key works and nothing is charged. With check=true it costs credits (1 per 10 checked) and runs as a job: the most it can cost is reserved when it starts, and only what was done is charged when it finishes. Failed runs are free. Answers are cached for up to 1 hour; send fresh=true to ask the source again. ## Query parameters | Name | Type | Required | Description | | --- | --- | --- | --- | | `domain` | string | yes | Your domain; reduced to its registrable part. | | `typos` | boolean | no | Missing, doubled, swapped and extra letters, keyboard slips, vowel swaps, hyphens and dots. | | `homoglyphs` | boolean | no | Characters that look like yours: rn for m, accented, Cyrillic and Greek letters. | | `tld_swaps` | boolean | no | The same name under other endings, such as .co or .net. | | `bitsquatting` | boolean | no | One-bit flips of a letter (memory errors). | | `max_checks` | integer | no | Check at most this many variants, the most similar first. 1 credit per 10. | | `fresh` | boolean | no | Skip the cache and ask again; costs the same. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.mode` | "generate" | "check" | yes | | | `data.domain` | string | yes | | | `data.unicode` | string | yes | | | `data.reduced_from` | string or null | no | | | `data.generated` | integer | yes | | | `data.max_checks` | integer | yes | | | `data.checked` | integer | no | | | `data.not_reached` | integer | no | | | `data.by_kind` | object | no | | | `data.variants` | array of object | no | | | `data.variants.name` | string | yes | | | `data.variants.unicode` | string | yes | | | `data.variants.host` | string or null | no | | | `data.variants.kind` | "omission" | "repetition" | "transposition" | "adjacent_key" | "insertion" | "vowel_swap" | "bitsquatting" | "hyphenation" | "dot_insertion" | "ascii_lookalike" | "homoglyph" | "whole_script" | "tld_swap" | yes | | | `data.variants.similarity` | integer | yes | | | `data.variants.changed` | array of integer | no | | | `data.registered` | array of object | no | | | `data.registered.name` | string | yes | | | `data.registered.unicode` | string | yes | | | `data.registered.host` | string or null | no | | | `data.registered.kind` | "omission" | "repetition" | "transposition" | "adjacent_key" | "insertion" | "vowel_swap" | "bitsquatting" | "hyphenation" | "dot_insertion" | "ascii_lookalike" | "homoglyph" | "whole_script" | "tld_swap" | yes | | | `data.registered.similarity` | integer | yes | | | `data.registered.changed` | array of integer | no | | | `data.registered.risk` | integer | yes | | | `data.registered.risk_level` | "high" | "medium" | "low" | yes | | | `data.registered.reasons` | array of "new" | "mail" | "similar" | "website" | no | | | `data.registered.nameservers` | array of string | no | | | `data.registered.addresses` | array of string | no | | | `data.registered.mx` | array of string | no | | | `data.registered.mail_capable` | boolean | no | | | `data.registered.website` | object or null | no | | | `data.registered.created` | string or null | no | | | `data.registered.age_days` | integer or null | no | | | `data.registered.registrar` | string or null | no | | | `data.registered.created_source` | "rdap" | "whois" or null | no | | | `data.registered.enrichment` | "done" | "skipped" | "failed" | "known" | no | | | `data.no_dns` | array of string | no | | | `data.unknown` | array of string | no | | | `data.whois_looked_up` | integer | no | | | `data.whois_skipped` | integer | no | | | `data.titles_fetched` | integer | no | | | `data.price_to_check` | integer | no | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) ## Example ```sh curl "https://api.dnssuper.com/v1/lookalikes?domain=example.com" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" ``` ```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/lookalikes", params={ "domain": "example.com", }) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch(`https://api.dnssuper.com/v1/lookalikes?${new URLSearchParams({"domain":"example.com"})}`, { 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); ``` Example response: ```json { "tool": "lookalike-domains", "target": "example.com", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 0, "summary": "241 lookalikes of example.com; checking the 200 most similar costs 20 credits.", "findings": [], "data": { "mode": "generate", "domain": "example.com", "unicode": "example.com", "generated": 241, "max_checks": 200, "checked": 0, "not_reached": 0, "by_kind": { "omission": 7, "repetition": 7, "transposition": 6, "adjacent_key": 29, "insertion": 51, "vowel_swap": 12, "bitsquatting": 22, "hyphenation": 6, "dot_insertion": 3, "ascii_lookalike": 4, "homoglyph": 63, "tld_swap": 31 }, "variants": [ { "name": "xn--eample-w77b.com", "unicode": "eẍample.com", "kind": "homoglyph", "similarity": 95, "changed": [ 1 ] }, { "name": "xn--examle-lza.com", "unicode": "examþle.com", "kind": "homoglyph", "similarity": 95, "changed": [ 4 ] }, { "name": "xn--exampe-0cb.com", "unicode": "exampļe.com", "kind": "homoglyph", "similarity": 95, "changed": [ 5 ] }, { "name": "xn--exampe-0r7b.com", "unicode": "exampḽe.com", "kind": "homoglyph", "similarity": 95, "changed": [ 5 ] }, { "name": "xn--exampe-fdb.com", "unicode": "exampľe.com", "kind": "homoglyph", "similarity": 95, "changed": [ 5 ] }, { "name": "xn--exampe-mcb.com", "unicode": "exampĺe.com", "kind": "homoglyph", "similarity": 95, "changed": [ 5 ] }, { "name": "xn--exampe-tq7b.com", "unicode": "exampḷe.com", "kind": "homoglyph", "similarity": 95, "changed": [ 5 ] }, { "name": "xn--exampl-14a.com", "unicode": "examplę.com", "kind": "homoglyph", "similarity": 95, "changed": [ 6 ] }, { "name": "xn--exampl-1i8b.com", "unicode": "examplế.com", "kind": "homoglyph", "similarity": 95, "changed": [ 6 ] }, { "name": "xn--exampl-8h8b.com", "unicode": "examplẻ.com", "kind": "homoglyph", "similarity": 95, "changed": [ 6 ] }, { "name": "xn--exampl-8j8b.com", "unicode": "examplễ.com", "kind": "homoglyph", "similarity": 95, "changed": [ 6 ] }, { "name": "xn--exampl-8ua.com", "unicode": "examplè.com", "kind": "homoglyph", "similarity": 95, "changed": [ 6 ] }, { "name": "xn--exampl-g5a.com", "unicode": "examplě.com", "kind": "homoglyph", "similarity": 95, "changed": [ 6 ] }, { "name": "xn--exampl-gj8b.com", "unicode": "examplề.com", "kind": "homoglyph", "similarity": 95, "changed": [ 6 ] }, { "name": "xn--exampl-gva.com", "unicode": "examplé.com", "kind": "homoglyph", "similarity": 95, "changed": [ 6 ] }, { "name": "xn--exampl-n4a.com", "unicode": "examplė.com", "kind": "homoglyph", "similarity": 95, "changed": [ 6 ] }, { "name": "xn--exampl-ni8b.com", "unicode": "examplẽ.com", "kind": "homoglyph", "similarity": 95, "changed": [ 6 ] }, { "name": "xn--exampl-nk8b.com", "unicode": "examplệ.com", "kind": "homoglyph", "similarity": 95, "changed": [ 6 ] }, { "name": "xn--exampl-nva.com", "unicode": "examplê.com", "kind": "homoglyph", "similarity": 95, "changed": [ 6 ] }, { "name": "xn--exampl-u3a.com", "unicode": "examplē.com", "kind": "homoglyph", "similarity": 95, "changed": [ 6 ] }, { "name": "xn--exampl-uh8b.com", "unicode": "examplẹ.com", "kind": "homoglyph", "similarity": 95, "changed": [ 6 ] }, { "name": "xn--exampl-uj8b.com", "unicode": "examplể.com", "kind": "homoglyph", "similarity": 95, "changed": [ 6 ] }, { "name": "xn--exampl-uva.com", "unicode": "examplë.com", "kind": "homoglyph", "similarity": 95, "changed": [ 6 ] }, { "name": "xn--exaple-5s7b.com", "unicode": "exaṃple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 3 ] }, { "name": "xn--exaple-ds7b.com", "unicode": "exaḿple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 3 ] }, { "name": "xn--exmple-45b.com", "unicode": "exǎmple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-4d8b.com", "unicode": "exầmple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-4f8b.com", "unicode": "exằmple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-4ta.com", "unicode": "exãmple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-4za.com", "unicode": "exāmple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-cd8b.com", "unicode": "exảmple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-cf8b.com", "unicode": "exậmple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-ch8b.com", "unicode": "exặmple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-cua.com", "unicode": "exämple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-j0a.com", "unicode": "exămple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-je8b.com", "unicode": "exẩmple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-jg8b.com", "unicode": "exẳmple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-jta.com", "unicode": "exàmple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-jua.com", "unicode": "exåmple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-qd8b.com", "unicode": "exấmple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-qf8b.com", "unicode": "exắmple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-qta.com", "unicode": "exámple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-x0a.com", "unicode": "exąmple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-xc8b.com", "unicode": "exạmple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-xe8b.com", "unicode": "exẫmple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-xg8b.com", "unicode": "exẵmple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--exmple-xta.com", "unicode": "exâmple.com", "kind": "homoglyph", "similarity": 95, "changed": [ 2 ] }, { "name": "xn--xample-2h8b.com", "unicode": "ẻxample.com", "kind": "homoglyph", "similarity": 95, "changed": [ 0 ] }, { "name": "xn--xample-2j8b.com", "unicode": "ễxample.com", "kind": "homoglyph", "similarity": 95, "changed": [ 0 ] }, { "name": "xn--xample-2ua.com", "unicode": "èxample.com", "kind": "homoglyph", "similarity": 95, "changed": [ 0 ] }, { "name": "xn--xample-94a.com", "unicode": "ěxample.com", "kind": "homoglyph", "similarity": 95, "changed": [ 0 ] }, { "name": "xn--xample-9i8b.com", "unicode": "ềxample.com", "kind": "homoglyph", "similarity": 95, "changed": [ 0 ] }, { "name": "xn--xample-9ua.com", "unicode": "éxample.com", "kind": "homoglyph", "similarity": 95, "changed": [ 0 ] }, { "name": "xn--xample-h4a.com", "unicode": "ėxample.com", "kind": "homoglyph", "similarity": 95, "changed": [ 0 ] }, { "name": "xn--xample-hi8b.com", "unicode": "ẽxample.com", "kind": "homoglyph", "similarity": 95, "changed": [ 0 ] }, { "name": "xn--xample-hk8b.com", "unicode": "ệxample.com", "kind": "homoglyph", "similarity": 95, "changed": [ 0 ] }, { "name": "xn--xample-hva.com", "unicode": "êxample.com", "kind": "homoglyph", "similarity": 95, "changed": [ 0 ] }, { "name": "xn--xample-o3a.com", "unicode": "ēxample.com", "kind": "homoglyph", "similarity": 95, "changed": [ 0 ] }, { "name": "xn--xample-oh8b.com", "unicode": "ẹxample.com", "kind": "homoglyph", "similarity": 95, "changed": [ 0 ] }, { "name": "xn--xample-oj8b.com", "unicode": "ểxample.com", "kind": "homoglyph", "similarity": 95, "changed": [ 0 ] }, { "name": "xn--xample-ova.com", "unicode": "ëxample.com", "kind": "homoglyph", "similarity": 95, "changed": [ 0 ] }, { "name": "xn--xample-v4a.com", "unicode": "ęxample.com", "kind": "homoglyph", "similarity": 95, "changed": [ 0 ] }, { "name": "xn--xample-vi8b.com", "unicode": "ếxample.com", "kind": "homoglyph", "similarity": 95, "changed": [ 0 ] }, { "name": "examp1e.com", "unicode": "examp1e.com", "kind": "ascii_lookalike", "similarity": 90, "changed": [ 5 ] }, { "name": "exampie.com", "unicode": "exampie.com", "kind": "ascii_lookalike", "similarity": 90, "changed": [ 5 ] }, { "name": "exannple.com", "unicode": "exannple.com", "kind": "ascii_lookalike", "similarity": 90, "changed": [ 3, 4 ] }, { "name": "exarnple.com", "unicode": "exarnple.com", "kind": "ascii_lookalike", "similarity": 90, "changed": [ 3, 4 ] }, { "name": "eaxmple.com", "unicode": "eaxmple.com", "kind": "transposition", "similarity": 80, "changed": [ 1, 2 ] }, { "name": "examlpe.com", "unicode": "examlpe.com", "kind": "transposition", "similarity": 80, "changed": [ 4, 5 ] }, { "name": "exampel.com", "unicode": "exampel.com", "kind": "transposition", "similarity": 80, "changed": [ 5, 6 ] }, { "name": "exapmle.com", "unicode": "exapmle.com", "kind": "transposition", "similarity": 80, "changed": [ 3, 4 ] }, { "name": "exmaple.com", "unicode": "exmaple.com", "kind": "transposition", "similarity": 80, "changed": [ 2, 3 ] }, { "name": "xeample.com", "unicode": "xeample.com", "kind": "transposition", "similarity": 80, "changed": [ 0, 1 ] }, { "name": "eample.com", "unicode": "eample.com", "kind": "omission", "similarity": 75, "changed": [ 1 ] }, { "name": "examle.com", "unicode": "examle.com", "kind": "omission", "similarity": 75, "changed": [ 4 ] }, { "name": "exampe.com", "unicode": "exampe.com", "kind": "omission", "similarity": 75, "changed": [ 5 ] }, { "name": "exampl.com", "unicode": "exampl.com", "kind": "omission", "similarity": 75, "changed": [ 5 ] }, { "name": "exaple.com", "unicode": "exaple.com", "kind": "omission", "similarity": 75, "changed": [ 3 ] }, { "name": "exmple.com", "unicode": "exmple.com", "kind": "omission", "similarity": 75, "changed": [ 2 ] }, { "name": "xample.com", "unicode": "xample.com", "kind": "omission", "similarity": 75, "changed": [ 0 ] }, { "name": "eexample.com", "unicode": "eexample.com", "kind": "repetition", "similarity": 75, "changed": [ 1 ] }, { "name": "exaample.com", "unicode": "exaample.com", "kind": "repetition", "similarity": 75, "changed": [ 3 ] }, { "name": "exammple.com", "unicode": "exammple.com", "kind": "repetition", "similarity": 75, "changed": [ 4 ] }, { "name": "examplee.com", "unicode": "examplee.com", "kind": "repetition", "similarity": 75, "changed": [ 7 ] }, { "name": "examplle.com", "unicode": "examplle.com", "kind": "repetition", "similarity": 75, "changed": [ 6 ] }, { "name": "exampple.com", "unicode": "exampple.com", "kind": "repetition", "similarity": 75, "changed": [ 5 ] }, { "name": "exxample.com", "unicode": "exxample.com", "kind": "repetition", "similarity": 75, "changed": [ 2 ] }, { "name": "3xample.com", "unicode": "3xample.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 0 ] }, { "name": "4xample.com", "unicode": "4xample.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 0 ] }, { "name": "dxample.com", "unicode": "dxample.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 0 ] }, { "name": "ecample.com", "unicode": "ecample.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 1 ] }, { "name": "edample.com", "unicode": "edample.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 1 ] }, { "name": "esample.com", "unicode": "esample.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 1 ] }, { "name": "exajple.com", "unicode": "exajple.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 3 ] }, { "name": "exakple.com", "unicode": "exakple.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 3 ] }, { "name": "exam0le.com", "unicode": "exam0le.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 4 ] }, { "name": "examlle.com", "unicode": "examlle.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 4 ] }, { "name": "examole.com", "unicode": "examole.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 4 ] }, { "name": "exampke.com", "unicode": "exampke.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 5 ] }, { "name": "exampl3.com", "unicode": "exampl3.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 6 ] }, { "name": "exampl4.com", "unicode": "exampl4.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 6 ] }, { "name": "exampld.com", "unicode": "exampld.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 6 ] }, { "name": "examplr.com", "unicode": "examplr.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 6 ] }, { "name": "exampls.com", "unicode": "exampls.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 6 ] }, { "name": "examplw.com", "unicode": "examplw.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 6 ] }, { "name": "exampoe.com", "unicode": "exampoe.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 5 ] }, { "name": "examppe.com", "unicode": "examppe.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 5 ] }, { "name": "exanple.com", "unicode": "exanple.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 3 ] }, { "name": "exqmple.com", "unicode": "exqmple.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 2 ] }, { "name": "exsmple.com", "unicode": "exsmple.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 2 ] }, { "name": "exwmple.com", "unicode": "exwmple.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 2 ] }, { "name": "exzmple.com", "unicode": "exzmple.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 2 ] }, { "name": "ezample.com", "unicode": "ezample.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 1 ] }, { "name": "rxample.com", "unicode": "rxample.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 0 ] }, { "name": "sxample.com", "unicode": "sxample.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 0 ] }, { "name": "wxample.com", "unicode": "wxample.com", "kind": "adjacent_key", "similarity": 70, "changed": [ 0 ] }, { "name": "axample.com", "unicode": "axample.com", "kind": "vowel_swap", "similarity": 70, "changed": [ 0 ] }, { "name": "exampla.com", "unicode": "exampla.com", "kind": "vowel_swap", "similarity": 70, "changed": [ 6 ] }, { "name": "exampli.com", "unicode": "exampli.com", "kind": "vowel_swap", "similarity": 70, "changed": [ 6 ] }, { "name": "examplo.com", "unicode": "examplo.com", "kind": "vowel_swap", "similarity": 70, "changed": [ 6 ] }, { "name": "examplu.com", "unicode": "examplu.com", "kind": "vowel_swap", "similarity": 70, "changed": [ 6 ] }, { "name": "exemple.com", "unicode": "exemple.com", "kind": "vowel_swap", "similarity": 70, "changed": [ 2 ] }, { "name": "eximple.com", "unicode": "eximple.com", "kind": "vowel_swap", "similarity": 70, "changed": [ 2 ] }, { "name": "exomple.com", "unicode": "exomple.com", "kind": "vowel_swap", "similarity": 70, "changed": [ 2 ] }, { "name": "exumple.com", "unicode": "exumple.com", "kind": "vowel_swap", "similarity": 70, "changed": [ 2 ] }, { "name": "ixample.com", "unicode": "ixample.com", "kind": "vowel_swap", "similarity": 70, "changed": [ 0 ] }, { "name": "oxample.com", "unicode": "oxample.com", "kind": "vowel_swap", "similarity": 70, "changed": [ 0 ] }, { "name": "uxample.com", "unicode": "uxample.com", "kind": "vowel_swap", "similarity": 70, "changed": [ 0 ] }, { "name": "example.cm", "unicode": "example.cm", "kind": "tld_swap", "similarity": 70, "changed": [ 8, 9 ] }, { "name": "example.co", "unicode": "example.co", "kind": "tld_swap", "similarity": 70, "changed": [ 8, 9 ] }, { "name": "example.om", "unicode": "example.om", "kind": "tld_swap", "similarity": 70, "changed": [ 8, 9 ] }, { "name": "3example.com", "unicode": "3example.com", "kind": "insertion", "similarity": 65, "changed": [ 0 ] }, { "name": "4example.com", "unicode": "4example.com", "kind": "insertion", "similarity": 65, "changed": [ 0 ] }, { "name": "dexample.com", "unicode": "dexample.com", "kind": "insertion", "similarity": 65, "changed": [ 0 ] }, { "name": "e3xample.com", "unicode": "e3xample.com", "kind": "insertion", "similarity": 65, "changed": [ 1 ] }, { "name": "e4xample.com", "unicode": "e4xample.com", "kind": "insertion", "similarity": 65, "changed": [ 1 ] }, { "name": "ecxample.com", "unicode": "ecxample.com", "kind": "insertion", "similarity": 65, "changed": [ 1 ] }, { "name": "edxample.com", "unicode": "edxample.com", "kind": "insertion", "similarity": 65, "changed": [ 1 ] }, { "name": "erxample.com", "unicode": "erxample.com", "kind": "insertion", "similarity": 65, "changed": [ 1 ] }, { "name": "esxample.com", "unicode": "esxample.com", "kind": "insertion", "similarity": 65, "changed": [ 1 ] }, { "name": "ewxample.com", "unicode": "ewxample.com", "kind": "insertion", "similarity": 65, "changed": [ 1 ] }, { "name": "exajmple.com", "unicode": "exajmple.com", "kind": "insertion", "similarity": 65, "changed": [ 3 ] }, { "name": "exakmple.com", "unicode": "exakmple.com", "kind": "insertion", "similarity": 65, "changed": [ 3 ] }, { "name": "exam0ple.com", "unicode": "exam0ple.com", "kind": "insertion", "similarity": 65, "changed": [ 4 ] }, { "name": "examjple.com", "unicode": "examjple.com", "kind": "insertion", "similarity": 65, "changed": [ 4 ] }, { "name": "examkple.com", "unicode": "examkple.com", "kind": "insertion", "similarity": 65, "changed": [ 4 ] }, { "name": "examlple.com", "unicode": "examlple.com", "kind": "insertion", "similarity": 65, "changed": [ 4 ] }, { "name": "examnple.com", "unicode": "examnple.com", "kind": "insertion", "similarity": 65, "changed": [ 4 ] }, { "name": "examople.com", "unicode": "examople.com", "kind": "insertion", "similarity": 65, "changed": [ 4 ] }, { "name": "examp0le.com", "unicode": "examp0le.com", "kind": "insertion", "similarity": 65, "changed": [ 5 ] }, { "name": "exampkle.com", "unicode": "exampkle.com", "kind": "insertion", "similarity": 65, "changed": [ 5 ] }, { "name": "exampl3e.com", "unicode": "exampl3e.com", "kind": "insertion", "similarity": 65, "changed": [ 6 ] }, { "name": "exampl4e.com", "unicode": "exampl4e.com", "kind": "insertion", "similarity": 65, "changed": [ 6 ] }, { "name": "examplde.com", "unicode": "examplde.com", "kind": "insertion", "similarity": 65, "changed": [ 6 ] }, { "name": "example3.com", "unicode": "example3.com", "kind": "insertion", "similarity": 65, "changed": [ 7 ] }, { "name": "example4.com", "unicode": "example4.com", "kind": "insertion", "similarity": 65, "changed": [ 7 ] }, { "name": "exampled.com", "unicode": "exampled.com", "kind": "insertion", "similarity": 65, "changed": [ 7 ] }, { "name": "exampler.com", "unicode": "exampler.com", "kind": "insertion", "similarity": 65, "changed": [ 7 ] }, { "name": "examples.com", "unicode": "examples.com", "kind": "insertion", "similarity": 65, "changed": [ 7 ] }, { "name": "examplew.com", "unicode": "examplew.com", "kind": "insertion", "similarity": 65, "changed": [ 7 ] }, { "name": "examplke.com", "unicode": "examplke.com", "kind": "insertion", "similarity": 65, "changed": [ 6 ] }, { "name": "examploe.com", "unicode": "examploe.com", "kind": "insertion", "similarity": 65, "changed": [ 6 ] }, { "name": "examplpe.com", "unicode": "examplpe.com", "kind": "insertion", "similarity": 65, "changed": [ 6 ] }, { "name": "examplre.com", "unicode": "examplre.com", "kind": "insertion", "similarity": 65, "changed": [ 6 ] }, { "name": "examplse.com", "unicode": "examplse.com", "kind": "insertion", "similarity": 65, "changed": [ 6 ] }, { "name": "examplwe.com", "unicode": "examplwe.com", "kind": "insertion", "similarity": 65, "changed": [ 6 ] }, { "name": "exampole.com", "unicode": "exampole.com", "kind": "insertion", "similarity": 65, "changed": [ 5 ] }, { "name": "exanmple.com", "unicode": "exanmple.com", "kind": "insertion", "similarity": 65, "changed": [ 3 ] }, { "name": "exaqmple.com", "unicode": "exaqmple.com", "kind": "insertion", "similarity": 65, "changed": [ 3 ] }, { "name": "exasmple.com", "unicode": "exasmple.com", "kind": "insertion", "similarity": 65, "changed": [ 3 ] }, { "name": "exawmple.com", "unicode": "exawmple.com", "kind": "insertion", "similarity": 65, "changed": [ 3 ] }, { "name": "exazmple.com", "unicode": "exazmple.com", "kind": "insertion", "similarity": 65, "changed": [ 3 ] }, { "name": "excample.com", "unicode": "excample.com", "kind": "insertion", "similarity": 65, "changed": [ 2 ] }, { "name": "exdample.com", "unicode": "exdample.com", "kind": "insertion", "similarity": 65, "changed": [ 2 ] }, { "name": "exqample.com", "unicode": "exqample.com", "kind": "insertion", "similarity": 65, "changed": [ 2 ] }, { "name": "exsample.com", "unicode": "exsample.com", "kind": "insertion", "similarity": 65, "changed": [ 2 ] }, { "name": "exwample.com", "unicode": "exwample.com", "kind": "insertion", "similarity": 65, "changed": [ 2 ] }, { "name": "exzample.com", "unicode": "exzample.com", "kind": "insertion", "similarity": 65, "changed": [ 2 ] }, { "name": "ezxample.com", "unicode": "ezxample.com", "kind": "insertion", "similarity": 65, "changed": [ 1 ] }, { "name": "rexample.com", "unicode": "rexample.com", "kind": "insertion", "similarity": 65, "changed": [ 0 ] }, { "name": "sexample.com", "unicode": "sexample.com", "kind": "insertion", "similarity": 65, "changed": [ 0 ] }, { "name": "wexample.com", "unicode": "wexample.com", "kind": "insertion", "similarity": 65, "changed": [ 0 ] }, { "name": "e-xample.com", "unicode": "e-xample.com", "kind": "hyphenation", "similarity": 65, "changed": [ 1 ] }, { "name": "ex-ample.com", "unicode": "ex-ample.com", "kind": "hyphenation", "similarity": 65, "changed": [ 2 ] }, { "name": "exa-mple.com", "unicode": "exa-mple.com", "kind": "hyphenation", "similarity": 65, "changed": [ 3 ] }, { "name": "exam-ple.com", "unicode": "exam-ple.com", "kind": "hyphenation", "similarity": 65, "changed": [ 4 ] }, { "name": "examp-le.com", "unicode": "examp-le.com", "kind": "hyphenation", "similarity": 65, "changed": [ 5 ] }, { "name": "exampl-e.com", "unicode": "exampl-e.com", "kind": "hyphenation", "similarity": 65, "changed": [ 6 ] }, { "name": "e8ample.com", "unicode": "e8ample.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 1 ] }, { "name": "ehample.com", "unicode": "ehample.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 1 ] }, { "name": "epample.com", "unicode": "epample.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 1 ] }, { "name": "exa-ple.com", "unicode": "exa-ple.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 3 ] }, { "name": "exaeple.com", "unicode": "exaeple.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 3 ] }, { "name": "exaiple.com", "unicode": "exaiple.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 3 ] }, { "name": "exalple.com", "unicode": "exalple.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 3 ] }, { "name": "exampde.com", "unicode": "exampde.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 5 ] }, { "name": "examphe.com", "unicode": "examphe.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 5 ] }, { "name": "examplg.com", "unicode": "examplg.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 6 ] }, { "name": "examplm.com", "unicode": "examplm.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 6 ] }, { "name": "exampme.com", "unicode": "exampme.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 5 ] }, { "name": "exampne.com", "unicode": "exampne.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 5 ] }, { "name": "examqle.com", "unicode": "examqle.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 4 ] }, { "name": "examrle.com", "unicode": "examrle.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 4 ] }, { "name": "examtle.com", "unicode": "examtle.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 4 ] }, { "name": "examxle.com", "unicode": "examxle.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 4 ] }, { "name": "exaople.com", "unicode": "exaople.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 3 ] }, { "name": "excmple.com", "unicode": "excmple.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 2 ] }, { "name": "eyample.com", "unicode": "eyample.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 1 ] }, { "name": "gxample.com", "unicode": "gxample.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 0 ] }, { "name": "mxample.com", "unicode": "mxample.com", "kind": "bitsquatting", "similarity": 60, "changed": [ 0 ] }, { "name": "example.ai", "unicode": "example.ai", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9 ] }, { "name": "example.app", "unicode": "example.app", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9, 10 ] }, { "name": "example.au", "unicode": "example.au", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9 ] }, { "name": "example.biz", "unicode": "example.biz", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9, 10 ] }, { "name": "example.ca", "unicode": "example.ca", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9 ] }, { "name": "example.cc", "unicode": "example.cc", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9 ] }, { "name": "example.co.uk", "unicode": "example.co.uk", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9, 10, 11, 12 ] }, { "name": "example.de", "unicode": "example.de", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9 ] }, { "name": "example.dev", "unicode": "example.dev", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9, 10 ] }, { "name": "example.es", "unicode": "example.es", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9 ] }, { "name": "example.eu", "unicode": "example.eu", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9 ] }, { "name": "example.fr", "unicode": "example.fr", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9 ] }, { "name": "example.in", "unicode": "example.in", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9 ] }, { "name": "example.info", "unicode": "example.info", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9, 10, 11 ] }, { "name": "example.io", "unicode": "example.io", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9 ] }, { "name": "example.it", "unicode": "example.it", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9 ] }, { "name": "example.me", "unicode": "example.me", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9 ] }, { "name": "example.net", "unicode": "example.net", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9, 10 ] }, { "name": "example.nl", "unicode": "example.nl", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9 ] }, { "name": "example.online", "unicode": "example.online", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9, 10, 11, 12, 13 ] }, { "name": "example.org", "unicode": "example.org", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9, 10 ] }, { "name": "example.shop", "unicode": "example.shop", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9, 10, 11 ] }, { "name": "example.site", "unicode": "example.site", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9, 10, 11 ] }, { "name": "example.store", "unicode": "example.store", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9, 10, 11, 12 ] }, { "name": "example.tv", "unicode": "example.tv", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9 ] }, { "name": "example.uk", "unicode": "example.uk", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9 ] }, { "name": "example.us", "unicode": "example.us", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9 ] }, { "name": "example.xyz", "unicode": "example.xyz", "kind": "tld_swap", "similarity": 60, "changed": [ 8, 9, 10 ] }, { "name": "ample.com", "unicode": "ex.ample.com", "host": "ex.ample.com", "kind": "dot_insertion", "similarity": 50, "changed": [ 2 ] }, { "name": "mple.com", "unicode": "exa.mple.com", "host": "exa.mple.com", "kind": "dot_insertion", "similarity": 50, "changed": [ 3 ] }, { "name": "ple.com", "unicode": "exam.ple.com", "host": "exam.ple.com", "kind": "dot_insertion", "similarity": 50, "changed": [ 4 ] } ], "registered": [], "no_dns": [], "unknown": [], "whois_looked_up": 0, "whois_skipped": 0, "titles_fetched": 0, "price_to_check": 20 }, "credits_remaining": 498 } ``` ## With check on `POST /v1/lookalikes` Free; any API key works and nothing is charged. With check=true it costs credits (1 per 10 checked) and runs as a job: the most it can cost is reserved when it starts, and only what was done is charged when it finishes. Failed runs are free. Request body with `check`: | Name | Type | Required | Description | | --- | --- | --- | --- | | `domain` | string | yes | Your domain; reduced to its registrable part. | | `typos` | boolean | no | Missing, doubled, swapped and extra letters, keyboard slips, vowel swaps, hyphens and dots. | | `homoglyphs` | boolean | no | Characters that look like yours: rn for m, accented, Cyrillic and Greek letters. | | `tld_swaps` | boolean | no | The same name under other endings, such as .co or .net. | | `bitsquatting` | boolean | no | One-bit flips of a letter (memory errors). | | `max_checks` | integer | no | Check at most this many variants, the most similar first. 1 credit per 10. | | `check` | boolean | no | Check which variants are registered. Runs as a job; 1 credit per 10 checked. | | `fresh` | boolean | no | Skip the cache and ask again; costs the same. | ```sh curl -X POST "https://api.dnssuper.com/v1/lookalikes" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" \ -H "Content-Type: application/json" \ -d '{"domain":"example.com","check":true}' ``` ```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.post("/v1/lookalikes", json={ "domain": "example.com", "check": True, }) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch("https://api.dnssuper.com/v1/lookalikes", { method: "POST", headers: { Authorization: `Bearer ${process.env.DNSSUPER_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({"domain":"example.com","check":true}), }); if (!response.ok) throw new Error((await response.json()).error.message); const result = await response.json(); console.log(result.summary, result.credits_used); ``` Example response with `check`: ```json { "job_id": "aa73c218-1d34-5ac5-988d-20152141e703", "status": "queued", "total": 1, "credits_reserved": 1, "duplicates_removed": 0, "job_url": "https://api.dnssuper.localhost/v1/jobs/aa73c218-1d34-5ac5-988d-20152141e703", "items_url": "https://api.dnssuper.localhost/v1/jobs/aa73c218-1d34-5ac5-988d-20152141e703/items", "events_url": "https://api.dnssuper.localhost/v1/jobs/aa73c218-1d34-5ac5-988d-20152141e703/events" } ``` ## MCP ```json { "tool": "find_lookalikes", "arguments": { "domain": "example.com" } } ``` ```text 241 lookalikes of example.com; checking the 200 most similar costs 20 credits. Generated 241 lookalikes: homoglyph 63, insertion 51, tld_swap 31, +9 kinds Most similar: eẍample.com, examþle.com, exampļe.com, exampḽe.com exampľe.com, exampĺe.com, exampḷe.com, examplę.com examplế.com, examplẻ.com, examplễ.com, examplè.com Checking the 200 most similar costs 20 credits; call again with check=true. No issues found. Free | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/domain-expiry-calendar # Expiry calendar API One calendar of when your domains expire, straight from the registries. `POST /v1/expiry-calendar` - Price: Costs 2 credits per name; cached answers cost the same. Names that fail upstream are free. - Cache: Never cached; every call runs again. - MCP tool: `export_expiry_calendar` Each domain's expiry date, days left, state (active, expiring, expired, ending, not registered or unknown), registrar name and EPP status codes, from the registry's RDAP or WHOIS service. Costs 2 credits per name; cached answers cost the same. Names that fail upstream are free. Never cached; every call runs again. ## Request body | Name | Type | Required | Description | | --- | --- | --- | --- | | `domains` | array of string | yes | Up to 200 domains, one per line. | | `fresh` | boolean | no | Skip the cache and ask the registries again; costs the same. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `job_id` | string | yes | The job's ID; poll GET /v1/jobs/{id} | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.name` | string | yes | | | `data.unicode` | string | yes | | | `data.tld` | string | yes | | | `data.tier` | "A" | "B" | "C" | "D" | yes | | | `data.reduced_from` | string or null | no | | | `data.registered` | boolean or null | no | | | `data.expires` | string or null | no | | | `data.expires_at` | string or null | no | | | `data.days_to_expiry` | integer or null | no | | | `data.state` | "active" | "expiring" | "expired" | "ending" | "not_registered" | "unknown" | no | | | `data.unknown_reason` | "unsupported_tld" | "unpublished" | "unparsed" or null | no | | | `data.registrar` | string or null | no | | | `data.statuses` | array of string | no | | | `data.source` | "rdap" | "whois" or null | no | | | `data.checked_at` | string | yes | | | `data.retry_after_s` | number or null | no | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `402` Balance below the call's price (`insufficient_credits`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) ## Example ```sh curl -X POST "https://api.dnssuper.com/v1/expiry-calendar" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" \ -H "Content-Type: application/json" \ -d '{}' ``` ```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.post("/v1/expiry-calendar", json={}) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch("https://api.dnssuper.com/v1/expiry-calendar", { method: "POST", headers: { Authorization: `Bearer ${process.env.DNSSUPER_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({}), }); if (!response.ok) throw new Error((await response.json()).error.message); const result = await response.json(); console.log(result.summary, result.credits_used); ``` ## MCP ```json { "tool": "export_expiry_calendar", "arguments": {} } ``` ```text verisign.com expires on 1 June 2034 (in 2756 days). Expires: 1 Jun 2034 (2756 days); state active Registrar: CSC Corporate Domains, Inc. Statuses: clientDeleteProhibited, clientTransferProhibited, clientUpdateProhibited, serverDeleteProhibited, serverTransferProhibited, serverUpdateProhibited No issues found. Credits: 2 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/email-checker # Email setup audit API Check a domain's whole email setup: mail servers, SPF, DMARC and DKIM, graded, with a fix for every problem. `GET /v1/email-audit` - Price: Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free. - Cache: Answers are cached for the lowest record TTL, between 1 minute and 1 hour; send fresh=true to ask the source again. - MCP tool: `audit_email` The domain's MX, SPF (with its lookup count), DMARC and DKIM records, the mail provider they point to, and the findings that set the grade. Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for the lowest record TTL, between 1 minute and 1 hour; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header. ## Query parameters | Name | Type | Required | Description | | --- | --- | --- | --- | | `domain` | string | yes | A domain, URL or email address; for an email address only the part after @ is used. | | `selector` | string or null | no | A DKIM selector to try first, such as s1. | | `fresh` | boolean | no | Skip the cache and ask the source again; costs the same. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.name` | string | yes | | | `data.unicode` | string | yes | | | `data.nxdomain` | boolean | yes | | | `data.providers` | array of object | no | | | `data.providers.id` | string | yes | | | `data.providers.name` | string | yes | | | `data.providers.source` | "mx" | "spf" | yes | | | `data.mx` | object or null | no | | | `data.spf` | object or null | no | | | `data.dmarc` | object or null | no | | | `data.dkim` | object or null | no | | | `data.policies` | object or null | no | | | `data.min_ttl` | integer or null | no | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `402` Balance below the call's price (`insufficient_credits`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) - `502` Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to ## Example ```sh curl "https://api.dnssuper.com/v1/email-audit?domain=example.com" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" ``` ```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/email-audit", params={ "domain": "example.com", }) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch(`https://api.dnssuper.com/v1/email-audit?${new URLSearchParams({"domain":"example.com"})}`, { 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); ``` Example response: ```json { "tool": "email-checker", "target": "example.com", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 2, "summary": "Email for example.com is set up well: grade A, 100 of 100. Mail is handled by Google Workspace.", "score": 100, "findings": [ { "id": "spf.softfail_all", "severity": "info", "title": "Your SPF record ends in ~all", "detail": "", "fix": "Move to -all once DMARC reports show all your mail passes." }, { "id": "bimi.missing", "severity": "info", "title": "No BIMI record", "detail": "", "fix": "Publish a BIMI record if you want your logo shown next to your mail in supporting inboxes." }, { "id": "mx.ok", "severity": "pass", "title": "Your mail servers are set up", "detail": "", "fix": "Nothing to do." }, { "id": "spf.valid", "severity": "pass", "title": "Your SPF record is valid", "detail": "", "fix": "Nothing to do." }, { "id": "dmarc.enforced", "severity": "pass", "title": "Your DMARC policy is enforced", "detail": "p=reject", "fix": "Nothing to do." }, { "id": "dkim.found", "severity": "pass", "title": "DKIM keys found", "detail": "google", "fix": "Nothing to do." }, { "id": "mta_sts.enforced", "severity": "pass", "title": "MTA-STS is enforced", "detail": "", "fix": "Nothing to do; keep the policy's mx lines in step with your MX records." }, { "id": "tls_rpt.valid", "severity": "pass", "title": "TLS reporting is set up", "detail": "", "fix": "Nothing to do; read the reports now and then." } ], "data": { "name": "example.com", "unicode": "example.com", "nxdomain": false, "providers": [ { "id": "google-workspace", "name": "Google Workspace", "source": "mx" } ], "mx": { "status": "found", "null_mx": false, "implicit": false, "records": [ { "preference": 1, "host": "aspmx.l.google.com", "ttl": 3600, "is_ip": false, "A": [ "142.250.27.26" ], "AAAA": [ "2a00:1450:4025:401::1a" ], "status": "ok", "provider": "google-workspace" }, { "preference": 5, "host": "alt1.aspmx.l.google.com", "ttl": 3600, "is_ip": false, "A": [ "142.250.153.27" ], "AAAA": [], "status": "ok", "provider": "google-workspace" } ] }, "spf": { "status": "found", "record": "v=spf1 include:_spf.google.com ~all", "records": [ "v=spf1 include:_spf.google.com ~all" ], "all": "~all", "lookups": 4, "lookup_limit": 10, "void_lookups": 0, "capped": false, "tree": { "domain": "example.com", "status": "found", "record": "v=spf1 include:_spf.google.com ~all", "errors": [], "terms": [ { "term": "include:_spf.google.com", "mechanism": "include", "qualifier": "+", "target": "_spf.google.com", "counted": true, "status": "ok", "addresses": [], "hosts": [], "detail": "", "child": { "domain": "_spf.google.com", "status": "found", "record": "v=spf1 include:_netblocks.google.com include:_netblocks2.google.com include:_netblocks3.google.com ~all", "errors": [], "terms": [ { "term": "include:_netblocks.google.com", "mechanism": "include", "qualifier": "+", "target": "_netblocks.google.com", "counted": true, "status": "ok", "addresses": [], "hosts": [], "detail": "", "child": { "domain": "_netblocks.google.com", "status": "found", "record": "v=spf1 ip4:35.190.247.0/24 ip4:64.233.160.0/19 ip4:66.102.0.0/20 ip4:66.249.80.0/20 ip4:72.14.192.0/18 ~all", "errors": [], "terms": [ { "term": "ip4:35.190.247.0/24", "mechanism": "ip4", "qualifier": "+", "target": "35.190.247.0", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "ip4:64.233.160.0/19", "mechanism": "ip4", "qualifier": "+", "target": "64.233.160.0", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "ip4:66.102.0.0/20", "mechanism": "ip4", "qualifier": "+", "target": "66.102.0.0", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "ip4:66.249.80.0/20", "mechanism": "ip4", "qualifier": "+", "target": "66.249.80.0", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "ip4:72.14.192.0/18", "mechanism": "ip4", "qualifier": "+", "target": "72.14.192.0", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "~all", "mechanism": "all", "qualifier": "~", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" } ] } }, { "term": "include:_netblocks2.google.com", "mechanism": "include", "qualifier": "+", "target": "_netblocks2.google.com", "counted": true, "status": "ok", "addresses": [], "hosts": [], "detail": "", "child": { "domain": "_netblocks2.google.com", "status": "found", "record": "v=spf1 ip6:2001:4860:4000::/36 ip6:2404:6800:4000::/36 ip6:2607:f8b0:4000::/36 ~all", "errors": [], "terms": [ { "term": "ip6:2001:4860:4000::/36", "mechanism": "ip6", "qualifier": "+", "target": "2001:4860:4000::", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "ip6:2404:6800:4000::/36", "mechanism": "ip6", "qualifier": "+", "target": "2404:6800:4000::", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "ip6:2607:f8b0:4000::/36", "mechanism": "ip6", "qualifier": "+", "target": "2607:f8b0:4000::", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "~all", "mechanism": "all", "qualifier": "~", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" } ] } }, { "term": "include:_netblocks3.google.com", "mechanism": "include", "qualifier": "+", "target": "_netblocks3.google.com", "counted": true, "status": "ok", "addresses": [], "hosts": [], "detail": "", "child": { "domain": "_netblocks3.google.com", "status": "found", "record": "v=spf1 ip4:172.217.0.0/19 ip4:172.217.32.0/20 ip4:108.177.96.0/19 ~all", "errors": [], "terms": [ { "term": "ip4:172.217.0.0/19", "mechanism": "ip4", "qualifier": "+", "target": "172.217.0.0", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "ip4:172.217.32.0/20", "mechanism": "ip4", "qualifier": "+", "target": "172.217.32.0", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "ip4:108.177.96.0/19", "mechanism": "ip4", "qualifier": "+", "target": "108.177.96.0", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" }, { "term": "~all", "mechanism": "all", "qualifier": "~", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" } ] } }, { "term": "~all", "mechanism": "all", "qualifier": "~", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" } ] } }, { "term": "~all", "mechanism": "all", "qualifier": "~", "counted": false, "status": "ok", "addresses": [], "hosts": [], "detail": "" } ] } }, "dmarc": { "status": "found", "name": "_dmarc.example.com", "source": "exact", "record": "v=DMARC1; p=reject; rua=mailto:dmarc@example.com", "policy": "reject", "effective_policy": "reject", "pct": 100, "adkim": "r", "aspf": "r", "reports": [ { "kind": "rua", "uri": "mailto:dmarc@example.com", "domain": "example.com", "external": false, "authorized": true } ] }, "dkim": { "selectors_tried": [ "google", "selector1", "selector2", "zmail", "zoho", "fm1", "fm2", "fm3", "protonmail", "protonmail2", "protonmail3", "hostingermail-a", "hostingermail-b", "hostingermail-c", "sig1", "s1", "s2", "smtp", "mx", "k1", "pic", "k2", "k3", "pm", "brevo1", "brevo2", "mail", "scph0920", "scph1021", "hs1", "hs2", "zendesk1", "zendesk2", "default", "dkim", "selector", "key1", "key2", "email", "dkim1" ], "failed": [], "found": [ { "selector": "google", "name": "google._domainkey.example.com", "status": "ok", "key_type": "rsa", "key_bits": 2048, "testing": false, "provider": "google-workspace", "record": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEApTGFY+knX9gV8lx+vLMRL+4h2Vef2XWTq1+IUtMY/ZRRoGQG31IR2Yz+FkzYaolUU2JMq2NbUzELco8z3Ef/iPmN4wITl7/cTQnwbn15fwvgeP59ICpyWpGtr/aq83ISRBjKEfTlRub1tRG/VVps0QaD4GjVBMGVPLYKKvlT9gG2Bzd86bLTkPOJcVHhjzqytVoqVW09guYc9W6J2XDfTES0ocQ7/p4zDR6/wmR4su5wwcy8C5GpeyKNERmR6w9DvH0c1ySrjtpvBMjDu4LTT4ruHJCHLqbWA1M31nFAi30vasgB0q6JZcEcOyM1ByetpiuqLfWNTLBm+RWQe4BguQIDAQAB" } ] }, "policies": { "checked": true, "mta_sts": { "present": true, "record": "v=STSv1; id=2026111401", "verdict": "enforced", "headline": "MTA-STS is enforced: senders must deliver over verified TLS.", "checked": true }, "tls_rpt": { "present": true, "record": "v=TLSRPTv1; rua=mailto:tlsrpt@example.com", "verdict": "valid", "headline": "TLS-RPT reports are requested.", "checked": true }, "bimi": { "present": false, "verdict": "missing", "headline": "No BIMI record, so no brand logo in inboxes.", "checked": true } }, "min_ttl": 300 }, "credits_remaining": 498 } ``` ## MCP ```json { "tool": "audit_email", "arguments": { "domain": "example.com" } } ``` ```text Email for example.com is set up well: grade A, 100 of 100. Mail is handled by Google Workspace. Score: 100/100 Providers: Google Workspace (MX) MX: aspmx.l.google.com (1), alt1.aspmx.l.google.com (5) SPF: v=spf1 include:_spf.google.com ~all (4 of 10 lookups) DMARC: p=reject, 1 report address DKIM: google (2048-bit RSA); tried 40 selectors Policies: MTA-STS enforced, TLS-RPT yes, BIMI no - info: Your SPF record ends in ~all - info: No BIMI record 6 checks passed Credits: 2 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/mta-sts-checker # MTA-STS, TLS-RPT, BIMI API Check a domain's MTA-STS policy, TLS reporting and BIMI logo, straight from DNS and the policy file. `GET /v1/mail-policies` - Price: Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free. - Cache: Answers are cached for up to 15 minutes; send fresh=true to ask the source again. - MCP tool: `check_mail_policies` MTA-STS policy and DNS record, TLS-RPT reporting addresses and BIMI logo and mark certificate facts for a domain's mail. Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 15 minutes; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header. ## Query parameters | Name | Type | Required | Description | | --- | --- | --- | --- | | `domain` | string | yes | A domain, URL or email address; for an email address only the part after @ is used. | | `fresh` | boolean | no | Skip the cache and ask the source again; costs the same. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.name` | string | yes | | | `data.unicode` | string | yes | | | `data.nxdomain` | boolean | yes | | | `data.mx_hosts` | array of string | yes | | | `data.mta_sts` | object or null | no | | | `data.tls_rpt` | object or null | no | | | `data.bimi` | object or null | no | | | `data.min_ttl` | integer or null | no | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `402` Balance below the call's price (`insufficient_credits`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) - `502` Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to ## Example ```sh curl "https://api.dnssuper.com/v1/mail-policies?domain=example.com" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" ``` ```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/mail-policies", params={ "domain": "example.com", }) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch(`https://api.dnssuper.com/v1/mail-policies?${new URLSearchParams({"domain":"example.com"})}`, { 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); ``` Example response: ```json { "tool": "mta-sts-checker", "target": "example.com", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 1, "summary": "MTA-STS is enforced for example.com and TLS reports are requested. BIMI is ready to show a logo.", "findings": [ { "id": "mta_sts.enforced", "severity": "pass", "title": "MTA-STS is enforced", "detail": "", "fix": "Nothing to do; keep the policy's mx lines in step with your MX records." }, { "id": "tls_rpt.valid", "severity": "pass", "title": "TLS reporting is set up", "detail": "", "fix": "Nothing to do; read the reports now and then." }, { "id": "bimi.valid", "severity": "pass", "title": "BIMI is set up", "detail": "", "fix": "Nothing to do; keep the logo and certificate current." } ], "data": { "name": "example.com", "unicode": "example.com", "nxdomain": false, "mx_hosts": [ "mx1.example.com", "mx2.example.net" ], "mta_sts": { "verdict": "enforced", "record": { "present": true, "records": [ "v=STSv1; id=20261101000000" ], "id": "20261101000000", "errors": [] }, "policy": { "url": "https://mta-sts.example.com/.well-known/mta-sts.txt", "fetched": true, "status": 200, "content_type": "text/plain", "size_bytes": 90, "version": "STSv1", "mode": "enforce", "max_age": 604800, "mx_patterns": [ "mx1.example.com", "mx2.example.net" ], "errors": [] }, "mx": [ { "host": "mx1.example.com", "pattern": "mx1.example.com" }, { "host": "mx2.example.net", "pattern": "mx2.example.net" } ], "null_mx": false, "mx_certificates": "not_checked" }, "tls_rpt": { "verdict": "valid", "present": true, "records": [ "v=TLSRPTv1; rua=mailto:tls-reports@example.com" ], "rua": [ { "uri": "mailto:tls-reports@example.com", "scheme": "mailto", "valid": true } ] }, "bimi": { "verdict": "ready", "present": true, "record": "v=BIMI1; l=https://bimi.example.com/logo.svg; a=https://bimi.example.com/vmc.pem", "logo": { "url": "https://bimi.example.com/logo.svg", "fetched": true, "status": 200, "content_type": "image/svg+xml", "size_bytes": 237, "square": true, "profile_ok": true, "title_present": true, "problems": [], "sha256": "14b0dd49f02a91c94261c4bf59e572be83eac371fc85cfe1177a0c633cf861e5" }, "certificate": { "url": "https://bimi.example.com/vmc.pem", "fetched": true, "kind": "vmc", "subject_org": "Example Brand Ltd", "issuer_org": "DNS Super Test Mark CA", "not_before": "2026-10-15T10:00:00Z", "not_after": "2027-11-14T10:00:00Z", "days_left": 365, "domains": [ "example.com" ], "covers_domain": true, "eku_ok": true, "mark_type": "Registered Mark" }, "dmarc": { "policy": "reject", "pct": 100, "testing": false, "inherited": false, "enforced_for_all": true } }, "min_ttl": 3600 }, "credits_remaining": 498 } ``` ## MCP ```json { "tool": "check_mail_policies", "arguments": { "domain": "example.com" } } ``` ```text MTA-STS is enforced for example.com and TLS reports are requested. BIMI is ready to show a logo. MTA-STS: enforced (max_age 604800; 2 of 2 MX hosts covered) TLS-RPT: reports to mailto:tls-reports@example.com BIMI: ready (logo SVG Tiny PS, square; VMC for Example Brand Ltd, 365 days left) DMARC for BIMI: p=reject, enforced for all mail 3 checks passed Credits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/email-header-analyzer # Email header analyzer API Paste a message's headers to see every hop, the delays between them and whether SPF, DKIM and DMARC passed. `POST /v1/headers` - Price: Free; any API key works and nothing is charged. What you paste is processed in memory and never stored. - Cache: Never cached; every call runs again. - MCP tool: `analyze_email_headers` The delivery path, authentication results and alignment read from pasted email headers. Free; any API key works and nothing is charged. What you paste is processed in memory and never stored. Never cached; every call runs again. ## Request body | Name | Type | Required | Description | | --- | --- | --- | --- | | `headers` | string | yes | The message headers, copied with "Show original" or "View source". A whole message works too; only the headers are read. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.header_count` | integer | yes | | | `data.received_count` | integer | yes | | | `data.hops` | array of object | yes | | | `data.hops.index` | integer | yes | | | `data.hops.from_helo` | string or null | yes | | | `data.hops.from_rdns` | string or null | yes | | | `data.hops.from_ip` | string or null | yes | | | `data.hops.ip_scope` | "public" | "private" | "loopback" | "link_local" | "cgnat" | "reserved" | "documentation" or null | yes | | | `data.hops.by_host` | string or null | yes | | | `data.hops.protocol` | string or null | yes | | | `data.hops.tls` | boolean or null | yes | | | `data.hops.queue_id` | string or null | yes | | | `data.hops.received_at` | string or null | yes | | | `data.hops.delay_s` | integer or null | yes | | | `data.hops.clock_skew` | boolean | yes | | | `data.hops.largest_delay` | boolean | yes | | | `data.hops.boundary` | boolean | yes | | | `data.hops.network` | object or null | no | | | `data.total_transit_s` | integer or null | yes | | | `data.auth_results` | array of object | yes | | | `data.auth_results.authserv_id` | string | yes | | | `data.auth_results.trusted` | boolean | yes | | | `data.auth_results.spf` | object or null | yes | | | `data.auth_results.dkim` | array of object | yes | | | `data.auth_results.dmarc` | object or null | yes | | | `data.auth_results.arc` | object or null | yes | | | `data.auth_results.other` | array of object | yes | | | `data.alignment` | object | yes | | | `data.alignment.from_domains` | array of string | yes | | | `data.alignment.return_path_domain` | string or null | yes | | | `data.alignment.spf_aligned` | boolean or null | yes | | | `data.alignment.dkim_domains_claimed` | array of string | yes | | | `data.alignment.dkim_aligned_pass` | boolean or null | yes | | | `data.arc_instances` | integer | yes | | | `data.arc_cv` | array of string | yes | | | `data.message_id_domain` | string or null | yes | | | `data.sending_software` | string or null | yes | | | `data.unsubscribe` | object | yes | | | `data.spam` | array of object | yes | | | `data.public_ips` | array of string | yes | | | `data.verdict` | "dmarc_pass" | "dmarc_fail" | "no_dmarc" | "unknown" | yes | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) ## Example ```sh curl -X POST "https://api.dnssuper.com/v1/headers" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" \ -H "Content-Type: application/json" \ -d '{}' ``` ```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.post("/v1/headers", json={}) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch("https://api.dnssuper.com/v1/headers", { method: "POST", headers: { Authorization: `Bearer ${process.env.DNSSUPER_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({}), }); if (!response.ok) throw new Error((await response.json()).error.message); const result = await response.json(); console.log(result.summary, result.credits_used); ``` Example response: ```json { "tool": "email-header-analyzer", "target": "", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 0, "summary": "DMARC passed: the receiver authenticated this message as coming from example.com. It took 3 hops in 3 seconds.", "findings": [ { "id": "email_headers.dmarc_pass", "severity": "pass", "title": "The message passed DMARC", "detail": "mx.example.net: example.com", "fix": "Nothing to do." } ], "data": { "header_count": 15, "received_count": 3, "hops": [ { "index": 0, "from_helo": "app.example.com", "from_rdns": "app.example.com", "from_ip": "198.51.100.10", "ip_scope": "documentation", "by_host": "mail-out.example.com", "protocol": "ESMTPS", "tls": true, "queue_id": "4XyZ1q2w3e", "received_at": "2026-11-14T17:00:01Z", "clock_skew": false, "largest_delay": false, "boundary": false, "network": { "asn": 64497, "name": "EXEMPLE-RESEAU", "country": "FR" } }, { "index": 1, "from_helo": "mail-out.example.com", "from_rdns": "mail-out.example.com", "from_ip": "192.0.2.25", "ip_scope": "documentation", "by_host": "mx.example.net", "protocol": "ESMTPS", "tls": true, "queue_id": "a1b2c3d4e5.12.2026.11.14.09.00.03", "received_at": "2026-11-14T17:00:03Z", "delay_s": 2, "clock_skew": false, "largest_delay": true, "boundary": true, "network": { "asn": 64496, "name": "EXAMPLE-NET", "country": "NL" } }, { "index": 2, "by_host": "2002:a05:6a10:1234:b0:5f1:aaaa:bbbb", "protocol": "SMTP", "tls": false, "queue_id": "x12csp123456pxa", "received_at": "2026-11-14T17:00:04Z", "delay_s": 1, "clock_skew": false, "largest_delay": false, "boundary": false } ], "total_transit_s": 3, "auth_results": [ { "authserv_id": "mx.example.net", "trusted": true, "spf": { "result": "pass", "domain": "example.com" }, "dkim": [ { "result": "pass", "domain": "example.com", "selector": "s1" } ], "dmarc": { "result": "pass", "domain": "example.com" }, "other": [] } ], "alignment": { "from_domains": [ "example.com" ], "return_path_domain": "example.com", "spf_aligned": true, "dkim_domains_claimed": [ "example.com" ], "dkim_aligned_pass": true }, "arc_instances": 0, "arc_cv": [], "message_id_domain": "app.example.com", "sending_software": "Example Mailer 4.2", "unsubscribe": { "present": false, "https": false, "mailto": false, "one_click": false }, "spam": [], "public_ips": [], "verdict": "dmarc_pass" }, "credits_remaining": 498 } ``` ## MCP ```json { "tool": "analyze_email_headers", "arguments": {} } ``` ```text DMARC passed: the receiver authenticated this message as coming from example.com. It took 3 hops in 3 seconds. Verdict: DMARC pass (receiver mx.example.net) Path: 3 hops in 3 seconds; entered at mx.example.net SPF: pass for example.com (aligned) | DKIM: pass for example.com (aligned) | DMARC: pass 1 check passed Free | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/dkim-verifier # DKIM signature verifier API Paste a whole message or upload an .eml file to verify every DKIM and ARC signature on it. `POST /v1/dkim-verify` - Price: Free; any API key works and nothing is charged. What you paste is processed in memory and never stored. - Cache: Never cached; every call runs again. - MCP tool: `verify_dkim_signature` Each DKIM signature of a pasted or uploaded message, verified against the key in DNS, and its ARC chain. Free; any API key works and nothing is charged. What you paste is processed in memory and never stored. Never cached; every call runs again. ## Request body | Name | Type | Required | Description | | --- | --- | --- | --- | | `message` | string or null | no | The whole message as received, headers and body, exactly as "Show original" shows it. | | `message_base64` | string or null | no | The .eml file, base64-encoded. Send either this or the pasted message, not both. | | `verify_arc` | boolean | no | Also verify the ARC chain that forwarders and mailing lists add. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.message_bytes` | integer | yes | | | `data.line_endings_converted` | boolean | yes | | | `data.from_domain` | string or null | yes | | | `data.signatures` | array of object | yes | | | `data.unverified_signatures` | integer | yes | | | `data.arc` | object or null | yes | | | `data.aligned_pass` | boolean | yes | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) ## Example ```sh curl -X POST "https://api.dnssuper.com/v1/dkim-verify" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" \ -H "Content-Type: application/json" \ -d '{}' ``` ```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.post("/v1/dkim-verify", json={}) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch("https://api.dnssuper.com/v1/dkim-verify", { method: "POST", headers: { Authorization: `Bearer ${process.env.DNSSUPER_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({}), }); if (!response.ok) throw new Error((await response.json()).error.message); const result = await response.json(); console.log(result.summary, result.credits_used); ``` Example response: ```json { "tool": "dkim-verifier", "target": "", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 0, "summary": "2 of 2 DKIM signatures verified, including one that aligns with the From domain example.com.", "findings": [ { "id": "arc.none", "severity": "info", "title": "No ARC headers", "detail": "", "fix": "Nothing to do; ARC is added only by forwarders and mailing lists." }, { "id": "dkim_signature.verified", "severity": "pass", "title": "A DKIM signature verified", "detail": "d=example.com s=ed; d=example.com s=rsa2048", "fix": "Nothing to do." } ], "data": { "message_bytes": 1309, "line_endings_converted": false, "from_domain": "example.com", "signatures": [ { "index": 0, "domain": "example.com", "selector": "ed", "algorithm": "ed25519-sha256", "canonicalization": "relaxed/relaxed", "signed_headers": [ "from", "to", "subject", "date", "message-id", "mime-version", "content-type" ], "identity_domain": "example.com", "signed_at": "2025-11-14T09:00:00Z", "expires_at": "2099-01-01T00:00:00Z", "key": { "record_name": "ed._domainkey.example.com", "status": "found", "key_type": "ed25519", "key_bits": 256, "testing": false }, "body_hash_ok": true, "signature_ok": true, "result": "pass", "reason": "Verified with the key at ed._domainkey.example.com.", "aligned_with_from": true }, { "index": 1, "domain": "example.com", "selector": "rsa2048", "algorithm": "rsa-sha256", "canonicalization": "relaxed/relaxed", "signed_headers": [ "from", "to", "subject", "date", "message-id", "mime-version", "content-type" ], "identity_domain": "example.com", "signed_at": "2025-11-14T09:00:00Z", "expires_at": "2099-01-01T00:00:00Z", "key": { "record_name": "rsa2048._domainkey.example.com", "status": "found", "key_type": "rsa", "key_bits": 2048, "testing": false }, "body_hash_ok": true, "signature_ok": true, "result": "pass", "reason": "Verified with the key at rsa2048._domainkey.example.com.", "aligned_with_from": true } ], "unverified_signatures": 0, "arc": { "chain": "none", "structure_ok": true, "sets": [] }, "aligned_pass": true }, "credits_remaining": 498 } ``` ## MCP ```json { "tool": "verify_dkim_signature", "arguments": {} } ``` ```text 2 of 2 DKIM signatures verified, including one that aligns with the From domain example.com. From domain: example.com (an aligned signature passed) d=example.com s=ed ed25519-sha256: pass (aligned) d=example.com s=rsa2048 rsa-sha256: pass (aligned) - info: No ARC headers 1 check passed Free | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/security-headers # HTTP and security headers API Grade a website's HTTPS redirects, HSTS, Content-Security-Policy, cookies and other security headers. `GET /v1/http` - Price: Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free. - Cache: Answers are cached for up to 15 minutes; send fresh=true to ask the source again. - MCP tool: `check_http` How a site answers on http and https with and without www, its redirects, security headers, HSTS, CSP and cookies, graded. Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 15 minutes; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header. ## Query parameters | Name | Type | Required | Description | | --- | --- | --- | --- | | `url` | string | yes | A domain or URL; only the site (scheme and host) is used. | | `fresh` | boolean | no | Skip the cache and ask the source again; costs the same. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.host` | string | yes | | | `data.alternate_host` | string or null | yes | | | `data.reachable` | boolean | yes | | | `data.no_website` | boolean | no | | | `data.entry_points` | array of object | yes | | | `data.entry_points.start_url` | string | yes | | | `data.entry_points.final_url` | string or null | yes | | | `data.entry_points.final_status` | integer or null | yes | | | `data.entry_points.hops` | array of object | yes | | | `data.entry_points.outcome` | "ok" | "loop" | "too_many" | "no_address" | "connect" | "refused" | "tls_failed" | "timeout" | "blocked" | "ipv6_only" | "error" | yes | | | `data.primary_url` | string or null | yes | | | `data.primary_status` | integer or null | yes | | | `data.http_version` | string or null | yes | | | `data.headers` | object | yes | | | `data.hsts` | object | yes | | | `data.hsts.present` | boolean | yes | | | `data.hsts.max_age` | integer or null | yes | | | `data.hsts.include_subdomains` | boolean | yes | | | `data.hsts.preload` | boolean | yes | | | `data.hsts.problems` | array of string | yes | | | `data.preload` | object | yes | | | `data.preload.eligible` | boolean | yes | | | `data.preload.applicable` | boolean | yes | | | `data.preload.missing` | array of string | yes | | | `data.csp` | array of object | yes | | | `data.csp.source` | "header" | "meta" | yes | | | `data.csp.report_only` | boolean | yes | | | `data.csp.directives` | object | yes | | | `data.csp.weaknesses` | array of string | yes | | | `data.csp.upgrade_insecure_requests` | boolean | yes | | | `data.framing` | "frame-ancestors" | "x-frame-options" | "none" | yes | | | `data.referrer_policy` | string or null | yes | | | `data.permissions_policy` | array of string | yes | | | `data.coop` | string or null | yes | | | `data.coep` | string or null | yes | | | `data.corp` | string or null | yes | | | `data.cookies` | array of object | yes | | | `data.cookies.name` | string | yes | | | `data.cookies.domain` | string or null | yes | | | `data.cookies.path` | string or null | yes | | | `data.cookies.secure` | boolean | yes | | | `data.cookies.http_only` | boolean | yes | | | `data.cookies.same_site` | string or null | yes | | | `data.cookies.session` | boolean | yes | | | `data.cookies.prefix_ok` | boolean | yes | | | `data.cookies.over_https` | boolean | yes | | | `data.disclosed` | array of object | yes | | | `data.disclosed.header` | string | yes | | | `data.disclosed.value` | string | yes | | | `data.disclosed.version` | string | yes | | | `data.http2` | boolean or null | yes | | | `data.http3_advertised` | boolean | yes | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `402` Balance below the call's price (`insufficient_credits`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) - `502` Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to - `503` Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged ## Example ```sh curl "https://api.dnssuper.com/v1/http?url=example.com" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" ``` ```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/http", params={ "url": "example.com", }) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch(`https://api.dnssuper.com/v1/http?${new URLSearchParams({"url":"example.com"})}`, { 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); ``` Example response: ```json { "tool": "security-headers", "target": "https://example.com/", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 2, "summary": "Grade A (100/100) for example.com. HTTPS, redirects and the main security headers are in place.", "score": 100, "findings": [], "data": { "host": "example.com", "alternate_host": "www.example.com", "reachable": true, "no_website": false, "entry_points": [ { "start_url": "http://example.com/", "final_url": "https://www.example.com/", "final_status": 200, "hops": [ { "url": "http://example.com/", "status": 301, "location": "https://example.com/", "elapsed_ms": 12, "cookie_names": [], "kind": "http" }, { "url": "https://example.com/", "status": 301, "location": "https://www.example.com/", "elapsed_ms": 12, "cookie_names": [], "kind": "http" }, { "url": "https://www.example.com/", "status": 200, "elapsed_ms": 12, "cookie_names": [ "__Host-session" ], "kind": "http" } ], "outcome": "ok" }, { "start_url": "https://example.com/", "final_url": "https://www.example.com/", "final_status": 200, "hops": [ { "url": "https://example.com/", "status": 301, "location": "https://www.example.com/", "elapsed_ms": 12, "cookie_names": [], "kind": "http" }, { "url": "https://www.example.com/", "status": 200, "elapsed_ms": 12, "cookie_names": [ "__Host-session" ], "kind": "http" } ], "outcome": "ok" }, { "start_url": "http://www.example.com/", "final_url": "https://www.example.com/", "final_status": 200, "hops": [ { "url": "http://www.example.com/", "status": 301, "location": "https://www.example.com/", "elapsed_ms": 12, "cookie_names": [], "kind": "http" }, { "url": "https://www.example.com/", "status": 200, "elapsed_ms": 12, "cookie_names": [ "__Host-session" ], "kind": "http" } ], "outcome": "ok" }, { "start_url": "https://www.example.com/", "final_url": "https://www.example.com/", "final_status": 200, "hops": [ { "url": "https://www.example.com/", "status": 200, "elapsed_ms": 12, "cookie_names": [ "__Host-session" ], "kind": "http" } ], "outcome": "ok" } ], "primary_url": "https://www.example.com/", "primary_status": 200, "http_version": "HTTP/1.1", "headers": { "strict-transport-security": "max-age=63072000; includeSubDomains; preload", "content-security-policy": "default-src 'self'; script-src 'self' 'nonce-r4nd0m'; object-src 'none'; base-uri 'none'; frame-ancestors 'self'", "x-frame-options": "SAMEORIGIN", "x-content-type-options": "nosniff", "referrer-policy": "strict-origin-when-cross-origin", "permissions-policy": "camera=(), microphone=(), geolocation=()", "cross-origin-opener-policy": "same-origin", "server": "nginx", "alt-svc": "h3=\":443\"; ma=86400" }, "hsts": { "present": true, "max_age": 63072000, "include_subdomains": true, "preload": true, "problems": [] }, "preload": { "eligible": true, "applicable": true, "missing": [] }, "csp": [ { "source": "header", "report_only": false, "directives": { "default-src": [ "'self'" ], "script-src": [ "'self'", "'nonce-r4nd0m'" ], "object-src": [ "'none'" ], "base-uri": [ "'none'" ], "frame-ancestors": [ "'self'" ] }, "weaknesses": [], "upgrade_insecure_requests": false } ], "framing": "frame-ancestors", "referrer_policy": "strict-origin-when-cross-origin", "permissions_policy": [ "camera", "microphone", "geolocation" ], "coop": "same-origin", "cookies": [ { "name": "__Host-session", "path": "/", "secure": true, "http_only": true, "same_site": "lax", "session": true, "prefix_ok": true, "over_https": true } ], "disclosed": [], "http2": true, "http3_advertised": true }, "credits_remaining": 498 } ``` ## MCP ```json { "tool": "check_http", "arguments": { "url": "example.com" } } ``` ```text Grade A (100/100) for example.com. HTTPS, redirects and the main security headers are in place. Score: 100/100 http://example.com/ -> 301 -> 301 -> https://www.example.com/ 200 https://example.com/ -> 301 -> https://www.example.com/ 200 http://www.example.com/ -> 301 -> https://www.example.com/ 200 https://www.example.com/ 200 Present: HSTS, CSP, X-Content-Type-Options, Referrer-Policy, Permissions-Policy, framing protection; HTTP/2, HTTP/3 advertised No issues found. Credits: 2 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/seo-audit # Technical SEO audit API Audit a page's indexing rules, canonical, titles, headings and sitemap, with an optional rendered check. `GET /v1/seo` - Price: Costs 3 credits per call; cached answers cost the same. Rendered mode costs 8 credits and runs as a job: reserved when it starts, charged when it finishes, and only 3 if the browser part fails. Calls that fail upstream (502) and failed runs are free. - Cache: Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again. - MCP tool: `audit_seo` Indexability, canonical, content, links, sitemap and redirects of a page, graded; optionally compared with the rendered page. Costs 3 credits per call; cached answers cost the same. Rendered mode costs 8 credits and runs as a job: reserved when it starts, charged when it finishes, and only 3 if the browser part fails. Calls that fail upstream (502) and failed runs are free. Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header. ## Query parameters | Name | Type | Required | Description | | --- | --- | --- | --- | | `url` | string | yes | A page URL or a domain; a domain means its home page. | | `fresh` | boolean | no | Skip the cache and ask the source again; costs the same. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.url` | string | yes | | | `data.final_url` | string or null | yes | | | `data.status` | integer or null | yes | | | `data.hops` | array of object | yes | | | `data.html_bytes` | integer | yes | | | `data.truncated` | boolean | yes | | | `data.elapsed_ms` | integer | yes | | | `data.indexability` | object | yes | | | `data.canonical` | object | yes | | | `data.content` | object | yes | | | `data.links` | object | yes | | | `data.sitemap` | object | yes | | | `data.presence` | object | yes | | | `data.redirects` | object | yes | | | `data.js` | object | yes | | | `data.rendered` | object or null | yes | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `402` Balance below the call's price (`insufficient_credits`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) - `502` Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to - `503` Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged ## Example ```sh curl "https://api.dnssuper.com/v1/seo?url=example.com" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" ``` ```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/seo", params={ "url": "example.com", }) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch(`https://api.dnssuper.com/v1/seo?${new URLSearchParams({"url":"example.com"})}`, { 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); ``` Example response: ```json { "tool": "seo-audit", "target": "https://example.com/", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 3, "summary": "example.com gets an A for technical SEO. Nothing stops search engines from indexing it.", "score": 100, "findings": [], "data": { "url": "https://example.com/", "final_url": "https://example.com/", "status": 200, "hops": [ { "url": "https://example.com/", "status": 200, "kind": "http" } ], "html_bytes": 1901, "truncated": false, "elapsed_ms": 12, "indexability": { "indexable": true, "meta_robots": [], "x_robots_tag": [], "robots": { "status": "ok", "googlebot_allowed": true, "rule": "Allow: /", "line": 2 } }, "canonical": { "href": "https://example.com/", "count": 1, "absolute": true, "target_status": 200, "self_referencing": true, "cross_domain": false }, "content": { "title": "Example Widgets: handmade widgets since 1999", "title_length": 44, "description": "Handmade widgets in every colour, shipped across Europe. Browse the catalogue, read the care guide and order online.", "description_length": 116, "h1": [ "Handmade widgets" ], "headings": [ { "level": 1, "text": "Handmade widgets" }, { "level": 2, "text": "Caring for your widget" } ], "lang": "en", "viewport": "width=device-width, initial-scale=1", "text_chars": 754 }, "links": { "images": 1, "images_missing_alt": 0, "internal": 3, "external": 1, "nofollow": 1 }, "sitemap": { "source": "robots", "files": [ { "url": "https://example.com/sitemap.xml", "status": 200, "kind": "urlset", "urls": 2, "gz": false, "truncated": false } ], "url_count": 2, "listed": true, "truncated": false }, "presence": { "favicon": true, "jsonld": true, "microdata": false, "rdfa": false, "hreflang": false, "open_graph": true, "twitter_card": true }, "redirects": { "checked": true, "consistent": true, "https_upgrade": true }, "js": { "likely_client_rendered": false, "text_chars": 754, "script_tags": 1, "inline_script_bytes": 117 } }, "credits_remaining": 498 } ``` ## With rendered on `POST /v1/seo` Costs 3 credits per call; cached answers cost the same. Rendered mode costs 8 credits and runs as a job: reserved when it starts, charged when it finishes, and only 3 if the browser part fails. Calls that fail upstream (502) and failed runs are free. Request body with `rendered`: | Name | Type | Required | Description | | --- | --- | --- | --- | | `url` | string | yes | A page URL or a domain; a domain means its home page. | | `rendered` | boolean | no | Load the page in a headless browser and compare with the raw HTML. Costs 8 credits and runs as a job. | | `fresh` | boolean | no | Skip the cache and ask the source again; costs the same. | ```sh curl -X POST "https://api.dnssuper.com/v1/seo" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"example.com","rendered":true}' ``` ```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.post("/v1/seo", json={ "url": "example.com", "rendered": True, }) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch("https://api.dnssuper.com/v1/seo", { method: "POST", headers: { Authorization: `Bearer ${process.env.DNSSUPER_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({"url":"example.com","rendered":true}), }); if (!response.ok) throw new Error((await response.json()).error.message); const result = await response.json(); console.log(result.summary, result.credits_used); ``` Example response with `rendered`: ```json { "job_id": "28599f0b-c508-5837-9150-ac104d674fcd", "status": "queued", "total": 1, "credits_reserved": 8, "duplicates_removed": 0, "job_url": "https://api.dnssuper.localhost/v1/jobs/28599f0b-c508-5837-9150-ac104d674fcd", "items_url": "https://api.dnssuper.localhost/v1/jobs/28599f0b-c508-5837-9150-ac104d674fcd/items", "events_url": "https://api.dnssuper.localhost/v1/jobs/28599f0b-c508-5837-9150-ac104d674fcd/events" } ``` ## MCP ```json { "tool": "audit_seo", "arguments": { "url": "example.com" } } ``` ```text example.com gets an A for technical SEO. Nothing stops search engines from indexing it. Score: 100/100 Indexable: yes (robots.txt allows Googlebot) Title: "Example Widgets: handmade widgets since 1999" (44 characters) Canonical: https://example.com/ (this page) Sitemap: 2 URLs in 1 file, listed in robots.txt; this page is listed Redirects: every entry point ends on the same address No issues found. Credits: 3 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/structured-data-validator # Structured data and hreflang API Check a page's JSON-LD, microdata and RDFa against schema.org, and test its hreflang alternates. `GET /v1/structured-data` - Price: Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free. - Cache: Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again. - MCP tool: `validate_structured_data` JSON-LD, microdata and RDFa items on a page checked against schema.org rules, and hreflang alternates. Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header. ## Query parameters | Name | Type | Required | Description | | --- | --- | --- | --- | | `url` | string | yes | A page URL or a domain; a domain means its home page. | | `fresh` | boolean | no | Skip the cache and ask the source again; costs the same. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.url` | string | yes | | | `data.final_url` | string or null | yes | | | `data.status` | integer or null | yes | | | `data.truncated` | boolean | yes | | | `data.items` | array of object | yes | | | `data.jsonld_errors` | array of object | yes | | | `data.counts` | object | yes | | | `data.hreflang` | object | yes | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `402` Balance below the call's price (`insufficient_credits`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) - `502` Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to - `503` Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged ## Example ```sh curl "https://api.dnssuper.com/v1/structured-data?url=example.com" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" ``` ```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/structured-data", params={ "url": "example.com", }) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch(`https://api.dnssuper.com/v1/structured-data?${new URLSearchParams({"url":"example.com"})}`, { 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); ``` Example response: ```json { "tool": "structured-data-validator", "target": "https://example.com/", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 2, "summary": "example.com has 3 valid structured data items (Organization, Product and BreadcrumbList). Search engines decide whether to show rich results.", "findings": [ { "id": "hreflang.none", "severity": "info", "title": "No hreflang alternates", "detail": "", "fix": "Nothing to do unless the site has other language versions." }, { "id": "structured_data.valid", "severity": "pass", "title": "The structured data is valid", "detail": "", "fix": "Nothing to do; search engines decide whether to show rich results." } ], "data": { "url": "https://example.com/", "final_url": "https://example.com/", "status": 200, "truncated": false, "items": [ { "syntax": "json-ld", "types": [ "Organization" ], "id": "https://example.com/#org", "properties": [ "logo", "name", "sameAs", "url" ], "problems": [], "rule": "Organization" }, { "syntax": "json-ld", "types": [ "Product" ], "properties": [ "brand", "description", "image", "name", "offers", "sku" ], "problems": [], "rule": "Product" }, { "syntax": "json-ld", "types": [ "BreadcrumbList" ], "properties": [ "itemListElement" ], "problems": [], "rule": "BreadcrumbList" } ], "jsonld_errors": [], "counts": { "jsonld": 3, "microdata": 0, "rdfa": 0 }, "hreflang": { "sources": { "html": 0, "header": 0, "sitemap": 0 }, "alternates": [], "self_reference": false, "x_default": false, "invalid_codes": [], "conflicts": [], "relative": [], "limit_reached": false } }, "credits_remaining": 498 } ``` ## MCP ```json { "tool": "validate_structured_data", "arguments": { "url": "example.com" } } ``` ```text example.com has 3 valid structured data items (Organization, Product and BreadcrumbList). Search engines decide whether to show rich results. Items: 3 (JSON-LD 3, microdata 0, RDFa 0) Organization (json-ld): no problems Product (json-ld): no problems BreadcrumbList (json-ld): no problems hreflang: none - info: No hreflang alternates 1 check passed Credits: 2 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC ``` --- Source: https://dnssuper.com/docs/tools/accessibility-checker # Basic accessibility API Run basic automated accessibility checks on a page, with an optional colour contrast check. `GET /v1/accessibility` - Price: Costs 2 credits per call; cached answers cost the same. Contrast mode costs 5 credits and runs as a job: reserved when it starts, charged when it finishes, and only 2 if the browser part fails. Calls that fail upstream (502) and failed runs are free. - Cache: Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again. - MCP tool: `audit_accessibility` Basic automated accessibility checks of a page; optionally colour contrast and axe-core rules in a browser. Costs 2 credits per call; cached answers cost the same. Contrast mode costs 5 credits and runs as a job: reserved when it starts, charged when it finishes, and only 2 if the browser part fails. Calls that fail upstream (502) and failed runs are free. Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header. ## Query parameters | Name | Type | Required | Description | | --- | --- | --- | --- | | `url` | string | yes | A page URL or a domain; a domain means its home page. | | `fresh` | boolean | no | Skip the cache and ask the source again; costs the same. | ## Response | Name | Type | Required | Description | | --- | --- | --- | --- | | `tool` | string | yes | | | `target` | string | yes | | | `status` | "ok" | "partial" | "error" | yes | | | `fetched_at` | string | no | | | `cached` | boolean | no | | | `credits_used` | integer | no | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in | | `summary` | string | yes | | | `score` | integer or null | no | | | `findings` | array of object | no | | | `credits_remaining` | integer | yes | Your balance after this call. It can be below zero after a refund; free tools still work then | | `data` | object | yes | This tool's result | | `data.url` | string | yes | | | `data.final_url` | string or null | yes | | | `data.status` | integer or null | yes | | | `data.mode` | "static" | "contrast" | yes | | | `data.disclaimer` | string | yes | | | `data.truncated` | boolean | yes | | | `data.counts` | object | yes | | | `data.headings` | array of object | yes | | | `data.instances` | object | yes | | | `data.axe` | object or null | yes | | ## Errors - `400` Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`) - `401` Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`) - `402` Balance below the call's price (`insufficient_credits`) - `403` Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`) - `429` Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged - `500` Unexpected error (`internal_error`) - `502` Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to - `503` Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged ## Example ```sh curl "https://api.dnssuper.com/v1/accessibility?url=example.com" \ -H "Authorization: Bearer $DNSSUPER_API_KEY" ``` ```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/accessibility", params={ "url": "example.com", }) response.raise_for_status() result = response.json() print(result["summary"], result["credits_used"]) ``` ```ts const response = await fetch(`https://api.dnssuper.com/v1/accessibility?${new URLSearchParams({"url":"example.com"})}`, { 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); ``` Example response: ```json { "tool": "accessibility-checker", "target": "https://example.com/order", "status": "ok", "fetched_at": "2026-11-14T10:00:00Z", "cached": false, "credits_used": 2, "summary": "7 checks found problems on example.com/order. Automated checks find only some accessibility problems; this is a starting point, not a compliance certificate.", "findings": [ { "id": "a11y.img_alt_missing", "severity": "fail", "title": "Images without alt text", "detail": "4 images have no text alternative.", "fix": "Add alt text; use alt=\"\" for decorative images." }, { "id": "a11y.form_label_missing", "severity": "fail", "title": "Form fields without labels", "detail": "5 form fields have no label.", "fix": "Give each field a