Skip to content
NetTools API

API reference

Every tool below runs the same engine as networktoolbox.org and returns JSON. Authenticate with Authorization: Bearer <key>. Keys in the URL are refused. Paid tools cost the listed credits per successful call; free tools cost nothing. The API is in free beta.

curl -H "Authorization: Bearer $NTB_KEY" \
  "https://app.networktoolbox.org/api/v1/tools/mx-lookup?domain=example.com"

Machine-readable catalog: GET https://app.networktoolbox.org/api/v1/tools

DNS

DNS Propagation Checker

dns-propagation 5 credits

Compare how public resolvers worldwide answer the same DNS query, with TTLs and consensus.

Parameters for DNS Propagation Checker
ParameterType and allowed values
domain* domain
type enum · one of A, AAAA, CNAME, MX, TXT, NS, SOA, CAA, SRV, PTR · default A
GET https://app.networktoolbox.org/api/v1/tools/dns-propagation?domain=example.com

DNS Records Checker

dns-records 1 credit

Look up A, AAAA, CNAME, MX, TXT, NS, SOA, CAA, SRV and PTR records for a domain.

Parameters for DNS Records Checker
ParameterType and allowed values
domain* domain
types csv_enum · one of A, AAAA, CNAME, MX, TXT, NS, SOA, CAA, SRV, PTR, TLSA · default A,AAAA,CNAME,MX,TXT,NS,SOA,CAA
resolver enum · one of 1.1.1.1, 8.8.8.8, 9.9.9.9, 208.67.222.222 · default 1.1.1.1
GET https://app.networktoolbox.org/api/v1/tools/dns-records?domain=example.com

DNSSEC Checker

dnssec-check 5 credits

Checks DNSKEY, DS, RRSIG and resolver validation to assess a zone's DNSSEC status.

Parameters for DNSSEC Checker
ParameterType and allowed values
domain* domain
GET https://app.networktoolbox.org/api/v1/tools/dnssec-check?domain=example.com

Domain to IP Lookup

domain-to-ip 1 credit

Resolve a domain to its IPv4 and IPv6 addresses, with hosting location and network owner.

Parameters for Domain to IP Lookup
ParameterType and allowed values
domain* domain
GET https://app.networktoolbox.org/api/v1/tools/domain-to-ip?domain=example.com

NS Lookup

ns-lookup 1 credit

List a domain's nameservers and check they are in sync with each other.

Parameters for NS Lookup
ParameterType and allowed values
domain* domain
GET https://app.networktoolbox.org/api/v1/tools/ns-lookup?domain=example.com

Public DNS Servers

dns-servers free

Browse verified public DNS resolvers by country, with operator, ASN and response time.

Parameters for Public DNS Servers
ParameterType and allowed values
country string
GET https://app.networktoolbox.org/api/v1/tools/dns-servers

Reverse DNS Lookup

reverse-dns 1 credit

Find the PTR (reverse DNS) record for an IP address and forward-confirm it.

Parameters for Reverse DNS Lookup
ParameterType and allowed values
ip* ip
resolver enum · one of 1.1.1.1, 8.8.8.8, 9.9.9.9, 208.67.222.222 · default 1.1.1.1
GET https://app.networktoolbox.org/api/v1/tools/reverse-dns?ip=8.8.8.8

Domain

ASN WHOIS Lookup

asn-whois 2 credits

Look up the organisation, country and registration details behind an AS number or IP.

Parameters for ASN WHOIS Lookup
ParameterType and allowed values
asn* string
GET https://app.networktoolbox.org/api/v1/tools/asn-whois?asn=AS13335

Domain DNS Health Checker

domain-health 10 credits

Full health report for a domain: nameservers, mail, SPF, DMARC, DNSSEC, CAA and expiry.

Parameters for Domain DNS Health Checker
ParameterType and allowed values
domain* domain
GET https://app.networktoolbox.org/api/v1/tools/domain-health?domain=example.com

Domain WHOIS Lookup

domain-whois 2 credits

Look up a domain's registrar, registration and expiry dates, nameservers and status codes.

Parameters for Domain WHOIS Lookup
ParameterType and allowed values
domain* domain
GET https://app.networktoolbox.org/api/v1/tools/domain-whois?domain=example.com

Email

Domain Blacklist Check

email-blacklist 5 credits

Check whether a sending domain or its mail servers appear on email blocklists.

Parameters for Domain Blacklist Check
ParameterType and allowed values
domain* domain
GET https://app.networktoolbox.org/api/v1/tools/email-blacklist?domain=example.com

MX Lookup

mx-lookup 1 credit

List a domain's mail servers in priority order and check for common MX misconfigurations.

Parameters for MX Lookup
ParameterType and allowed values
domain* domain
GET https://app.networktoolbox.org/api/v1/tools/mx-lookup?domain=example.com

SMTP Test

smtp-test 2 credits

Connects to an SMTP server, performs EHLO, and optionally STARTTLS.

Parameters for SMTP Test
ParameterType and allowed values
host* host
port enum · one of 25, 465, 587 · default 587
starttls bool · default 1
timeout int · default 5 · 3–15
GET https://app.networktoolbox.org/api/v1/tools/smtp-test?host=example.com

HTTP

Check HTTP Headers

http-headers 2 credits

Fetches HTTP response headers with optional redirect following.

Parameters for Check HTTP Headers
ParameterType and allowed values
url* url
method enum · one of GET, HEAD · default HEAD
follow bool · default 1
timeout int · default 8 · 3–20
GET https://app.networktoolbox.org/api/v1/tools/http-headers?url=https%3A%2F%2Fexample.com

Check Website OS

website-os 2 credits

Heuristically infers server OS from response headers.

Parameters for Check Website OS
ParameterType and allowed values
url* url
GET https://app.networktoolbox.org/api/v1/tools/website-os?url=https%3A%2F%2Fexample.com

IP

IP Blacklist Check

ip-blacklist 5 credits

Checks common DNSBLs for an IP address.

Parameters for IP Blacklist Check
ParameterType and allowed values
ip* ip
GET https://app.networktoolbox.org/api/v1/tools/ip-blacklist?ip=8.8.8.8

IP Location Lookup

ip-location 1 credit

Look up the country, region, city, network and ASN for an IP address.

Parameters for IP Location Lookup
ParameterType and allowed values
ip* ip
GET https://app.networktoolbox.org/api/v1/tools/ip-location?ip=8.8.8.8

IP WHOIS Lookup

ip-whois 2 credits

Fetch WHOIS/RDAP data for an IP address.

Parameters for IP WHOIS Lookup
ParameterType and allowed values
ip* ip
GET https://app.networktoolbox.org/api/v1/tools/ip-whois?ip=8.8.8.8

What is my IP

what-is-my-ip free

Shows your public IP address, how it was detected, and its network and location.

GET https://app.networktoolbox.org/api/v1/tools/what-is-my-ip

Network

MAC Address Lookup

mac-lookup 1 credit

Identify the manufacturer of a MAC address and decode its local, multicast and OUI flags.

Parameters for MAC Address Lookup
ParameterType and allowed values
mac* string
GET https://app.networktoolbox.org/api/v1/tools/mac-lookup?mac=00%3A1A%3A2B%3A3C%3A4D%3A5E

Port Checker

port-check 1 credit

Check whether a common service port is open and reachable on a public host.

Parameters for Port Checker
ParameterType and allowed values
host* host
port enum · one of 21, 22, 25, 53, 80, 110, 143, 443, 465, 587, 993, 995, 3306, 3389, 5432, 6379, 8080, 8443 · default 443
timeout int · default 5 · 2–10
GET https://app.networktoolbox.org/api/v1/tools/port-check?host=example.com

Security

SSL Certificate Checker

ssl-check 2 credits

Inspect a site's TLS certificate: expiry, hostname match, chain, signature strength and issuer.

Parameters for SSL Certificate Checker
ParameterType and allowed values
host* host
port int · default 443 · 1–65535
timeout int · default 8 · 3–20
GET https://app.networktoolbox.org/api/v1/tools/ssl-check?host=example.com