Skip to main content

Accurately separate the TLD from the registered domain and subdomains of a URL, using the Public Suffix List. By default, this includes the public ICANN TLDs and their exceptions. You can optionally support the Public Suffix List's private domains as well.

Project description

tldextract accurately separates the gTLD or ccTLD (generic or country code top-level domain) from the registered domain and subdomains of a URL.

>>> import tldextract
>>> tldextract.extract('http://forums.news.cnn.com/')
ExtractResult(subdomain='forums.news', domain='cnn', suffix='com')
>>> tldextract.extract('http://forums.bbc.co.uk/') # United Kingdom
ExtractResult(subdomain='forums', domain='bbc', suffix='co.uk')
>>> tldextract.extract('http://www.worldbank.org.kg/') # Kyrgyzstan
ExtractResult(subdomain='www', domain='worldbank', suffix='org.kg')

ExtractResult is a namedtuple, so it’s simple to access the parts you want.

>>> ext = tldextract.extract('http://forums.bbc.co.uk')
>>> (ext.subdomain, ext.domain, ext.suffix)
('forums', 'bbc', 'co.uk')
>>> # rejoin subdomain and domain
>>> '.'.join(ext[:2])
'forums.bbc'
>>> # a common alias
>>> ext.registered_domain
'bbc.co.uk'

By default, this package supports the public ICANN TLDs and their exceptions. You can optionally support the Public Suffix List’s private domains as well.

Project details


Download files

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

Source Distribution

tldextract-2.1.0.tar.gz (51.1 kB view details)

Uploaded Source

Built Distribution

tldextract-2.1.0-py2.py3-none-any.whl (52.6 kB view details)

Uploaded Python 2Python 3

File details

Details for the file tldextract-2.1.0.tar.gz.

File metadata

  • Download URL: tldextract-2.1.0.tar.gz
  • Upload date:
  • Size: 51.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for tldextract-2.1.0.tar.gz
Algorithm Hash digest
SHA256 796d86aa22c382770b28db45547b298cbf855dcdcd8e1c7264419d96c0f2381a
MD5 f0c54bebd3e1a4ac64df16a603c56bd2
BLAKE2b-256 158c6c852f0dd1cc6ddd43d4eb8b67b78a099d6b8e25d6144f85bdfb08df9645

See more details on using hashes here.

File details

Details for the file tldextract-2.1.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for tldextract-2.1.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 6a705710f3a1d5ce8a084c888db7bad7aff1dcdf27962f7c7f7058cc42349212
MD5 e5ed6c681cfaad146dcad8124b4b0200
BLAKE2b-256 395e57290fb1322b5ca14983216ae78ad3ae1c2dd4dc7182e6a88e0c3491e4a6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page