Skip to content

Choosing TLDs

By level

--level filters the --tld list by where the name would actually sit:

Value Keeps Count under --tld all
any (default) everything 1659
second plain TLDs — apple.com, apple.de 1274
third multi-label suffixes — apple.co.uk, apple.com.au 385

Handy for --tld all, which otherwise sweeps hundreds of restricted zones (gov.bd, ernet.in, edu.gt) you cannot register under anyway. A full domain typed out by hand is always checked as given — --level only filters TLD lists.

By length

--cctld keeps only country-code TLDs — the two-letter ones, which is exactly what ICANN reserves for ISO 3166-1 country codes:

ds apple --tld all --cctld                  # 505 (includes co.uk, com.au, ...)
ds apple --tld all --cctld --level second   # 140 bare ccTLDs: de, io, jp, ...

--tld-len is the general form, measured on the last label so co.uk counts as 2:

Spec Keeps Count under --tld all
--tld-len 2 two-letter (same as --cctld) 505
--tld-len 3 com, net, xyz, … 236
--tld-len -3 three characters or fewer 741
--tld-len 4- four or more 918

These pages are generated from the project README, so they never drift from what ships with the binary.