API REFERENCE · 27 ENDPOINTS

DomainScan API documentation — REST reference for WHOIS, DNS, IP intelligence, SSL, email authentication and security headers.

Complete reference for the DomainScan REST API. 27 endpoints across Domain, Network/IP and Security categories. JSON responses with a consistent envelope, bearer-token auth (or anonymous calls), predictable rate limits, stable error codes and date-pinned versioning. Every endpoint on this site is also a UI tool — switch between them with a click.

01 · GET STARTED

Start here

Six short guides covering everything you need before your first integration:

Quickstart (60 seconds)

First successful API call with cURL or fetch. Anonymous and authenticated examples side by side.

Authentication (Auth)

Bearer tokens, anonymous access, multi-key isolation and how to rotate compromised credentials.

Versioning (Stability)

Date-based version tags, stability levels (STABLE, BETA, DEPRECATED) and backward-compatibility guarantees.

Rate limits (Throughput)

Per-plan caps, burst behavior, X-RateLimit-* headers and how to design retries with exponential backoff.

Errors (Failure modes)

Every error code with HTTP status, machine code, human description and recommended client-side response.

Pricing & quotas (Plans)

Free 100 credits/mo, Starter $5, Pro $18, Business $82. Credit weights per endpoint.

02 · ENDPOINTS · DOMAIN

Domain endpoints — WHOIS, DNS, email authentication

Domain Lookup (GET /api/v1/domain/lookup)

WHOIS / RDAP — owner, age, expiry, nameservers, DNSSEC.

DNS Query (GET /api/v1/domain/dns)

Any record type (A, AAAA, MX, TXT, CNAME, NS, SOA, CAA, SRV, ALL).

DNS Resolver List (GET /api/v1/domain/dns-servers)

Resolver catalogue used across DNS endpoints.

Reverse DNS (PTR) (GET /api/v1/ip/reverse)

PTR query against a chosen public resolver.

DNS Propagation (GET /api/v1/domain/propagation)

Per-resolver agreement across Google / Cloudflare / OpenDNS / Quad9.

Domain Trust Score (GET /api/v1/domain/trust)

Composite 0–100 Trust Score with AI recommendations.

Nameserver Details (GET /api/v1/domain/ns)

NS records with optional A/AAAA resolution.

Domain Snapshot (GET /api/v1/domain/snapshot)

Playwright-rendered PNG/JPEG/PDF captures.

SPF Record (GET /api/v1/domain/spf)

Validate SPF and count DNS lookups.

DMARC Record (GET /api/v1/domain/dmarc)

Inspect DMARC policy, enforcement, reporting.

DKIM Record (GET /api/v1/domain/dkim)

Selector, public key, key strength, DNSSEC.

AI Readiness (GET /api/v1/domain/ai-ready)

GPTBot / ClaudeBot / Perplexity visibility check.

03 · ENDPOINTS · NETWORK & IP

Network / IP endpoints

My IP (GET /api/v1/ip/myip)

Caller IPv4/IPv6 with geo, ISP, ASN.

IP Lookup (GET /api/v1/ip/lookup)

Full geolocation, ISP, ASN, trust score.

IP ISP (GET /api/v1/ip/isp)

ISP/carrier and ASN slice of IP Lookup.

Port Scan (GET /api/v1/ip/port)

Probe arbitrary TCP ports — open / closed / filtered.

Ping (GET /api/v1/ip/ping)

Latency, packet loss and connection stability.

Traceroute (GET /api/v1/ip/traceroute)

Network path with per-hop latency.

Common Ports (GET /api/v1/ip/common-ports)

Sweep standard service ports in one call.

Subnet Calculator (GET /api/v1/ip/subnet)

Network/broadcast/mask/range from CIDR.

Reverse IP (GET /api/v1/ip/reverse-ip)

Domains hosted on a given IP.

04 · ENDPOINTS · SECURITY

Security endpoints

SSL Info (GET /api/v1/security/ssl-info)

Cert, chain, grade, protocols, ciphers.

SSL Chain (GET /api/v1/security/ssl-chain)

Intermediate + root validation with missing-link detection.

Blacklist (GET /api/v1/security/blacklist)

Multi-source DNSBL + reputation check.

MAC Info (GET /api/v1/security/mac-info)

OUI → vendor + country lookup.

MAC Vendor Search (GET /api/v1/security/mac-vendor)

Vendor → all assigned OUI blocks.

Security Headers (GET /api/v1/security/headers)

HSTS / CSP / XFO / referrer / permissions policy.