Skip to content
POST AI agent ready /v1/dns/compare

DNS Compare API - Query 5 Resolvers Side by Side

Queries a domain against Google (8.8.8.8), Cloudflare (1.1.1.1), Quad9 (9.9.9.9), OpenDNS (208.67.222.222), and the Authoritative nameserver simultaneously. Returns records and response times from each resolver, a consistency flag, and a differences array highlighting any mismatches. Supports A, AAAA, MX, TXT, CNAME, NS, SOA, and PTR record types.

Parameters

stringrequired

Domain name to query.

string

DNS record type to query. Defaults to A.

Code examples

curl -X POST https://api.botoi.com/v1/dns/compare \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","type":"A"}'

When to use this API

DNS migration verification

After changing DNS providers or updating records, query all five resolvers to confirm the new records have propagated. The consistent flag tells you at a glance if all resolvers agree.

Propagation debugging

When users report DNS issues, compare resolver results to see if a specific resolver has stale cached data. The differences array pinpoints which resolvers return different values.

Resolver performance benchmarking

Compare response_time_ms across resolvers to choose the fastest one for your infrastructure. Use the data to justify switching from a slow resolver to a faster alternative.

Frequently asked questions

Which resolvers are queried?
Google (8.8.8.8), Cloudflare (1.1.1.1), Quad9 (9.9.9.9), OpenDNS (208.67.222.222), and the Authoritative nameserver for the domain. All five are queried in parallel.
What record types are supported?
A, AAAA, MX, TXT, CNAME, NS, SOA, and PTR. The default is A if no type is specified.
What does consistent: false mean?
At least one resolver returned a different set of records than the others. Check the differences array to see which resolver disagrees and what its records are. This usually means a DNS change is still propagating.
How long does DNS propagation take?
Most changes propagate within 5 minutes for records with low TTLs. Records with long TTLs (24-48 hours) take longer because resolvers cache them until the TTL expires. This endpoint shows you the current state across resolvers in real time.
Can I compare DNS for internal/private domains?
No. The resolvers are public DNS servers. They can only resolve domains registered in the public DNS system. Private or split-horizon DNS zones are not accessible.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.