Skip to main content

world -- top level domain code mappings

Project description

This script takes a list of Internet top-level domain names and prints out where in the world those domains originate from. For example:

$ world tz us
tz originates from Tanzania, United Republic of
us originates from United States of America (the)

Reverse look ups are also supported:

$ world -r united
Matches for "united":
  ae: United Arab Emirates (the)
  gb: United Kingdom of Great Britain and Northern Ireland (the)
  tz: Tanzania, United Republic of
  uk: United Kingdom (common practice)
  um: United States Minor Outlying Islands (the)
  us: United States of America (the)

Only two-letter country codes are supported, since these are the only ones that were freely available from the ISO 3166 standard. However, as of 2015-01-09, even these are no longer freely available in a machine readable format.

This script also knows about non-geographic, generic, USA-centric, historical, common usage, and reserved top-level domains.

Project details


world is Copyright (C) 2013-2022 Barry Warsaw <>

Licensed under the Apache License, Version 2.0 (the “License”). See the LICENSE file for details.

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

world-5.0.1.tar.gz (21.2 kB view hashes)

Uploaded Source

Built Distribution

world-5.0.1-py3-none-any.whl (12.7 kB view hashes)

Uploaded Python 3

Supported by

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