Public API

v1 · 60 req/min/IP

SharkDNS Public API

Query DNS records, reverse IP relationships, subdomains, rDNS records, DNS history, and DNSSEC data from https://api.sharkdns.com.

Request Builder

Choose an endpoint, edit parameters, then send a live request from this page.

Server URL

Endpoint

GET/v1/dns/lookup

Resolve standard DNS records for domains, IPv4 addresses, or IPv4 CIDR targets.

Use type=ALL when you want the normalized record set shown in the SharkDNS console.

Public API examples use SharkDNS defaults and do not require provider selection.

Parameters

Query String

domain* string

Domain name, IPv4 address, or IPv4 CIDR target. The API also accepts ip as an alias.

type string

Record type: ALL, A, AAAA, CNAME, MX, NS, TXT, SOA, CAA, SRV, or PTR.

https://api.sharkdns.com/v1/dns/lookup?domain=example.com&type=ALL

Readyapplication/json

{
  "message": "Click Send Request to run this endpoint from your browser."
}

Code Examples

Generated from the request builder.

curl -X GET "https://api.sharkdns.com/v1/dns/lookup?domain=example.com&type=ALL" \
  -H "Accept: application/json"

Response Example

Shape for the selected endpoint.

{
  "code": 0,
  "data": {
    "domain": "example.com",
    "records": {
      "A": ["93.184.216.34"],
      "MX": []
    }
  },
  "cached": false,
  "timestamp": 1783340000
}

Endpoints

All public endpoints are GET endpoints under https://api.sharkdns.com.

DNS Lookup

GET/v1/dns/lookup

Resolve standard DNS records for domains, IPv4 addresses, or IPv4 CIDR targets.

domain*type

Reverse IP

GET/v1/dns/reverse-ip

Find public domains observed on the same IPv4 address using best-effort public datasets.

ip*

Subdomains

GET/v1/dns/subdomains

Discover observed subdomains for a registered domain.

domain*limit

Reverse NS

GET/v1/dns/reverse-ns

Find domains sharing authoritative name-server infrastructure.

domain*limit

Reverse MX

GET/v1/dns/reverse-mx

Find domains sharing mail exchanger infrastructure.

domain*limit

rDNS Search

GET/v1/dns/rdns

Search stored PTR records by keyword.

keyword*modelimit

DNSSEC

GET/v1/dns/dnssec

Inspect DS, DNSKEY, RRSIG, and NSEC records with a simple security score.

domain*

SSL Certificate

GET/v1/dns/ssl

Inspect the TLS certificate, chain trust, and negotiated connection security for a domain or IP.

target*port

Mail Security

GET/v1/dns/mail-security

Validate SPF, DKIM, DMARC, MTA-STS, TLS-RPT, and BIMI with a posture score.

domain*selector

IP Blacklist

GET/v1/dns/blacklist

Check an IPv4 address against public DNS blocklists (RBL/DNSBL).

ip*

Global Propagation

GET/v1/dns/propagation

Query a record from public DoH resolvers across North America, Europe, and Asia, and compare answer consistency.

domain*type

DNS Health Check

GET/v1/dns/health-check

Audit delegation, nameservers, SOA, MX, DNSSEC, SPF, DMARC, and CAA with a weighted score.

domain*

ECS Test

GET/v1/dns/ecs

Probe ECS-aware resolvers with EDNS Client Subnet options from multiple regions and detect GeoDNS variation.

domain*subnet

Subdomain Takeover

GET/v1/dns/takeover

Scan discovered subdomains for dangling CNAME records pointing at claimable hosting services.

domain*

DNS History

GET/v1/dns/history

Read passive DNS history records stored by SharkDNS.

domain*limit

DNS Record Types

Record types supported by the DNS lookup endpoint.

A

IPv4 address mapping

AAAA

IPv6 address mapping

CNAME

Alias target chain

MX

Mail routing host and priority

NS

Authoritative name servers

TXT

SPF, DMARC, DKIM, and verification strings

SOA

Zone authority metadata

CAA

Allowed certificate authorities

SRV

Service target, port, priority, and weight

PTR

Reverse lookup hostname

HTTPS / SVCB

Service binding parameters and ECH config

DS / DNSKEY

DNSSEC delegation and public signing keys

TLSA

DANE certificate associations

SSHFP

SSH server key fingerprints

NAPTR

Naming authority pointer rules

Response & Errors

Common response codes returned by the public API.

200

Request succeeded. The response body contains code, data, cached when applicable, and timestamp.

400

Missing or invalid query parameter.

404

No matching DNS or relationship records were found.

405

Unsupported HTTP method. Public endpoints use GET.

429

Rate limit exceeded. The public v1 API is limited to 60 requests per minute per client IP.

500 / 502

Server or upstream source error. Retry later or reduce request scope.

SharkDNS queries public DNS infrastructure and public datasets. Reverse relationships and subdomain results are best-effort and may be incomplete or delayed.