Skip to main content

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

Project description


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

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).

Latest stable version on PyPI:

.. code-block:: none

$ pip install tld

Latest development version:

.. code-block:: none

$ pip install -e hg+

Usage example
To get the top level domain name from the URL given:

.. code-block:: python

from tld import get_tld
print get_tld("")
# ''

print get_tld("", fail_silently=True)
# None

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

.. code-block:: python

from tld import get_tld
res = get_tld("", as_object=True)
print res
# ''

print res.subdomain
# 'some.subdomain'

print res.domain
# 'google'

print res.suffix
# ''

print res.tld
# ''

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

.. code-block:: none

$ python tld/

or simply do:

.. code-block:: python

from tld.utils import update_tld_names

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
Filename, size File type Python version Upload date Hashes
Filename, size tld-0.7.tar.gz (27.8 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