When you update DNS records, changes don't take effect instantly. DNS propagation — the process of DNS servers worldwide updating their cached records — can take minutes to hours depending on TTL values.
Why Monitor Propagation?
After changing nameservers, updating A records, or modifying MX records, you need to know when those changes have reached users worldwide. Manual checking via dig or nslookup is tedious and doesn't scale.
Using the DNS Propagation API
The DNS Toolkit API provides a propagation endpoint that queries 20+ global resolvers simultaneously and returns per-resolver results with latency data.
Example
curl -H "X-API-Key: YOUR_KEY" \
"https://api.dnstoolkit.io/dns/propagation?domain=example.com&record_type=A"The response includes propagation percentage, individual resolver results, and response times — everything you need to build automated monitoring.