Skip to main content

Get a public suffix for a domain name using the Public Suffix List.

Project description

This module allows you to get the public suffix of a domain name using the Public Suffix List from

A public suffix is one under which Internet users can directly register names. Some examples of public suffixes are .com, and Accurately knowing the public suffix of a domain is useful when handling web browser cookies, highlighting the most important part of a domain name in a user interface or sorting URLs by web site.

The Python module ships with a (possibly out-dated) copy of the Public Suffix List so that it is usable out of the box. It’s up the user to keep it up-to-date with the most recent version of the list available on

Module content

The module exports a class that parses the Public Suffix List and allows queries for individual domain names:

>>> from publicsuffix import PublicSuffixList
>>> psl = PublicSuffixList()
>>> psl.get_public_suffix("")

Please note that the host part of an URL can contain strings that are not plain DNS domain names (IP addresses, Punycode-encoded names, name in combination with a port number or an username, etc.). It is up to the caller to ensure only domain names are passed to the get_public_suffix() method.


You can get a local copy of the development repository with:

git clone

Project details

Release history Release notifications

History Node


This version
History Node


History Node


History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
publicsuffix-1.0.5.tar.gz (44.1 kB) Copy SHA256 hash SHA256 Source None Jan 24, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page