Skip to main content

Extract the top level domain (TLD) from the URL given.

Project description

Extract the top level domain (TLD) from the URL given. List of TLD names is taken from Mozilla.

Optionally raises exceptions on non-existing TLDs or silently fails (if fail_silently argument is set to True). Knows about active and inactive TLDs. If only active TLDs shall be matched against, active_only argument shall be set to True (default - False).


  • Python 2.6, 2.7, 3.4, 3.5, 3.6 and PyPy


Latest stable version on PyPI:

pip install tld

Or latest stable version from GitHub:

pip install

Or latest stable version from BitBucket:

pip install

Usage examples

Get the TLD name as string from the URL given:

from tld import get_tld

# ''

get_tld("", fail_silently=True)
# None

If you wish, you could get the TLD as an object:

from tld import get_tld

res = get_tld("", as_object=True)

# ''

# 'some.subdomain'

# 'google'

# ''

# ''

Get TLD name, ignoring the missing protocol:

from tld import get_tld

get_tld("", fix_protocol=True)
# ''

Update the list of TLD names

To update/sync the tld names with the most recent version run the following from your terminal:


Or simply do:

from tld.utils import update_tld_names



If somehow domain names listed here are not recognised, make sure you have the most recent version of TLD names in your virtual environment:



Simply type:


Or use tox:


Or use tox to check specific env:

tox -e py36


MPL 1.1/GPL 2.0/LGPL 2.1


For any issues contact me at the e-mail given in the Author section.


Artur Barseghyan <>

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for tld, version 0.7.10
Filename, size File type Python version Upload date Hashes
Filename, size tld-0.7.10-py2.py3-none-any.whl (221.6 kB) File type Wheel Python version 3.5 Upload date Hashes View
Filename, size tld-0.7.10.tar.gz (228.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page