Query over 1500 global DNS servers and colate their results. Track the propagation of your domains around the world.

pip install dnsyo==2.0.7




DNSYO is a little tool I built to help me keep track of DNS propagation.

In short, it's dig, if dig queried over 1000 servers and collated their results.

Here's what it does

$ dnsyo -t 100 -q ALL example.com
Status: Queried 1804 of 1804 servers, duration: 0:00:09.334441


I asked 1804 servers for A records related to example.com,
1771 responded with records and 33 gave errors
Here are the results;

1738 servers responded with;

26 servers responded with;

1 servers responded with;

1 servers responded with;

1 servers responded with;

1 servers responded with;

2 servers responded with;

1 servers responded with;

And here are the errors;

8 servers responded with;
No Nameservers

4 servers responded with;
No Answer

21 servers responded with;
Server Timeout


DNSYO requires Python 2.6 or later. The easiest way to install is by running

pip install dnsyo --upgrade

You should probably install it within a virtualenv.

If all goes well, you should be clear to start querying stuff

To test, try running

dnsyo google.com

It will query 500 random DNS servers in the database, and give you the results.


For more information on the flags run dnsyo -h

Output modes

DNSYO has 3 output modes;

  • standard - Will display all the results and errors from querying
  • extended - Same as standard but includes the names and addresses of the servers it queried
  • simple - Simple output mode which is useful for UNIX scripting

To change output mode, pass ether --extended or --simple to DNSYO.

Resolver list

DNSYO periodically updates it's internal resolver database from this repo. The first time you run it, and once every 2 weeks, it will try to download the resolver-list.yml file and store it to ~/.dnsyo-resolvers-list.yaml directory. If you know of any more open DNS resolvers feel free to add them to the resolver-list-source.yml file. There's a job that runs every month to update the working list from the source and remove any dead or misfunctioning servers.

By default, DNSYO will pick 500 servers at random from it's list to query. You can change this with the --servers or -q flag. If you want DNSYO to query all the servers just pass --servers=ALL or -q=ALL.

Record types

Just like dig, you can pass the record type as the second positional argument to DNSYO, so to get Google's MX records just do

dnsyo google.com MX


DNSYO is released under the MIT licence, see LICENCE.txt for more info


Module documentation is available for dnsyo, you can view the module documentation as generated by epydoc or docco