iptocc

PyPI Python License

Python bindings for the iptocc Rust crate. Offline IPv4 and IPv6 to ISO 3166-1 alpha-2 country code lookup.

Note: Country codes reflect the country assigned by a Regional Internet Registry (RIR) to each IP block, not where the block is being used. RIR data agrees with MaxMind for ~95% of IPv4 addresses and has minimal discrepancies for IPv6 (Zander, 2012).

Important: iptocc 3.0 is a complete Rust rewrite. Versions 2.x and earlier were pure Python on top of pandas. The public API stays mostly compatible (see migration notes below), single-lookup latency dropped from ~78 ms to ~44-141 ns, and a batch API was added.

Features

  • Offline lookup, no API keys, no network calls
  • IPv4 and IPv6 in one call
  • Single string OR batch (any iterable of strings)
  • Lookup data embedded in the wheel; no runtime file I/O
  • iptocc CLI installed with pip install iptocc
  • Data refreshed nightly from the five Regional Internet Registries

Install

Requires Python 3.10 or newer.

pip install iptocc

Usage

from iptocc import country_code

country_code("8.8.8.8")                       # "US"
country_code(["8.8.8.8", "1.0.16.1"])         # ["US", "JP"]

A CLI is installed alongside the library:

$ iptocc 8.8.8.8 1.0.16.1
8.8.8.8 US
1.0.16.1 JP

Migrating from 2.x

# 2.x
from iptocc import get_country_code, CountryCodeNotFound
try:
    cc = get_country_code("8.8.8.8")
except CountryCodeNotFound:
    cc = None

# 3.x
from iptocc import country_code
cc = country_code("8.8.8.8")  # returns None on miss

See also

Project links

Data verified by PyPI on Sep 5, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (3.3.129)

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for roniemartinez from gravatar.com roniemartinez Avatar for ronmarti from gravatar.com ronmarti

Credits

Author: Ronie Martinez

GitHub Statistics

Data verified by PyPI on Sep 5, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT OR Apache-2.0
View SPDX License List

Requires

Python >=3.10

Tags

geoip country ip ipv4 ipv6 rust

Classifiers

Report project as malware

Download files

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

Source Distribution

iptocc-3.3.122.tar.gz (447.3 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

iptocc-3.3.122-cp310-abi3-win_amd64.whl (521.2 kB view details)

Uploaded CPython 3.10+Windows x86-64

iptocc-3.3.122-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (631.0 kB view details)

Uploaded CPython 3.10+manylinux: glibc 2.17+ x86-64

iptocc-3.3.122-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (631.0 kB view details)

Uploaded CPython 3.10+manylinux: glibc 2.17+ ARM64

iptocc-3.3.122-cp310-abi3-macosx_11_0_arm64.whl (620.4 kB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

iptocc-3.3.122-cp310-abi3-macosx_10_12_x86_64.whl (620.0 kB view details)

Uploaded CPython 3.10+macOS 10.12+ x86-64

File details

Details for the file iptocc-3.3.122.tar.gz.

File metadata

  • Download URL: iptocc-3.3.122.tar.gz
  • Upload date:
  • Size: 447.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for iptocc-3.3.122.tar.gz
Algorithm Hash digest
SHA256 6fe39d879c5d3e248ea75d4c594a0ec2ce6c42091583feae8d4a10de01733750
MD5 20c081c76dca77cff840dc51344328fa
BLAKE2b-256 f8fe60eca9473654a3b33abe631261cfdf578aaa070758d028780a7ba361c105

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.122.tar.gz:

Publisher: publish-pypi.yml on roniemartinez/IPToCC

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file iptocc-3.3.122-cp310-abi3-win_amd64.whl.

File metadata

  • Download URL: iptocc-3.3.122-cp310-abi3-win_amd64.whl
  • Upload date:
  • Size: 521.2 kB
  • Tags: CPython 3.10+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for iptocc-3.3.122-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 4f61a454113394908074c88a10149db887c315fa025ca92f9dc6565ba65eacab
MD5 d55de34f088f08fa8b6fec0b4a92c6fa
BLAKE2b-256 227b422bea8c9442c8acc108e6f81d708b6b788eb710b25256fe237e7d8454a3

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.122-cp310-abi3-win_amd64.whl:

Publisher: publish-pypi.yml on roniemartinez/IPToCC

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file iptocc-3.3.122-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for iptocc-3.3.122-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 a35fd0a44a0774ead1a0cfe8e2a891488ba53b15649eb595c3e86a06552026ef
MD5 50a11ccc7a00aa1c3d0cce40729836ec
BLAKE2b-256 0584c984b819467e7256e1bfcf410dc8e6aae41dca15ae9fcddb9c6b910835fe

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.122-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: publish-pypi.yml on roniemartinez/IPToCC

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file iptocc-3.3.122-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for iptocc-3.3.122-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 a366de3a593b009575b39c7f8a0e22fa873ce10291534116c44fc821c4180fce
MD5 6527862b8644a5f5644ed4fa0d34cfcf
BLAKE2b-256 5ed7186433519667de76dd98e91da0d085567743b3e4f213119f66eea7495daa

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.122-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: publish-pypi.yml on roniemartinez/IPToCC

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file iptocc-3.3.122-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for iptocc-3.3.122-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 08c9652476ffd2a154ab63fd533a4e5b7b24cd70d04d1aef6775f3ae7cb7c607
MD5 b5ecea2cb4717581a0350112e4bcde08
BLAKE2b-256 93278830d4fb8b4d1de63380220f55b7c080c0e289cc2e132a029561ad111060

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.122-cp310-abi3-macosx_11_0_arm64.whl:

Publisher: publish-pypi.yml on roniemartinez/IPToCC

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file iptocc-3.3.122-cp310-abi3-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for iptocc-3.3.122-cp310-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 a13531eb504dd83e40b62d798cde914ba1c3d4f2b86206593204ddf005f7e005
MD5 806b068c46a5845465627f5f24e7228f
BLAKE2b-256 cb2c60a638c560806c90b51fd86b4b12f53b4af89508559201edfe51bfad95eb

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.122-cp310-abi3-macosx_10_12_x86_64.whl:

Publisher: publish-pypi.yml on roniemartinez/IPToCC

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

3.3.129

6 files

3.3.128

6 files

3.3.127

6 files

3.3.126

6 files

3.3.125

6 files

3.3.124

6 files

3.3.123

6 files

This release

3.3.122 This release

6 files

3.3.121

6 files

3.3.120

6 files

3.3.119

6 files

3.3.118

6 files

3.3.117

6 files

3.3.116

6 files

3.3.115

6 files

3.3.114

6 files

3.3.113

6 files

3.3.112

6 files

3.3.111

6 files

3.3.110

6 files

3.3.109

6 files

3.3.108

6 files

3.3.107

6 files

3.3.106

6 files

3.3.105

6 files

3.3.104

6 files

3.3.103

6 files

3.3.102

6 files

3.3.101

6 files

3.3.100

6 files

3.3.99

6 files

3.3.98

6 files

3.3.97

6 files

3.3.96

6 files

3.3.95

6 files

3.3.94

6 files

3.3.93

6 files

3.3.92

6 files

3.3.91

6 files

3.3.90

6 files

3.3.89

6 files

3.3.88

6 files

3.3.87

6 files

3.3.86

6 files

3.3.85

6 files

3.3.84

6 files

3.3.83

6 files

3.3.82

6 files

3.3.81

6 files

3.3.80

6 files

3.3.78

6 files

3.3.77

6 files

3.3.76

6 files

3.3.75

6 files

3.3.74

6 files

3.3.73

6 files

3.3.72

6 files

3.3.71

6 files

3.3.70

6 files

3.3.69

6 files

3.3.68

6 files

3.3.67

6 files

3.3.66

6 files

3.3.65

6 files

3.3.64

6 files

3.3.63

6 files

3.3.62

6 files

3.3.61

6 files

3.3.60

6 files

3.3.59

6 files

3.3.58

6 files

3.3.57

6 files

3.3.56

6 files

3.3.55

6 files

3.3.54

6 files

3.3.53

6 files

3.3.52

6 files

3.3.51

6 files

3.3.50

6 files

3.3.49

6 files

3.3.48

6 files

3.3.47

6 files

3.3.46

6 files

3.3.45

6 files

3.3.44

6 files

3.3.43

6 files

3.3.42

6 files

3.3.41

6 files

3.3.40

6 files

3.3.39

6 files

3.3.38

6 files

3.3.37

6 files

3.3.36

6 files

3.3.35

6 files

3.3.34

6 files

3.3.33

6 files

3.3.32

6 files

3.3.31

6 files

3.3.30

6 files

3.3.29

6 files

3.3.28

6 files

3.3.27

6 files

3.3.26

6 files

3.3.25

6 files

3.3.24

6 files

3.3.23

6 files

3.3.22

6 files

3.3.21

6 files

3.3.20

6 files

3.3.19

6 files

3.3.18

6 files

3.3.17

6 files

3.3.16

6 files

3.3.15

6 files

3.3.14

6 files

3.3.13

6 files

3.3.12

6 files

3.3.11

6 files

3.3.10

6 files

3.3.9

6 files

3.3.8

6 files

3.3.7

6 files

3.3.6

6 files

3.3.5

6 files

3.3.4

6 files

3.3.3

6 files

3.3.2

6 files

3.3.1

6 files

3.3.0

6 files

3.2.3

6 files

3.2.2

6 files

3.2.1

6 files

3.2.0

6 files

3.1.2

6 files

3.1.1

6 files

3.1.0

6 files

3.0.0

6 files

Pre-release

3.0.0a1

6 files

2.1.2

2 files

2.1.1

2 files

2.1.0

2 files

2.0.1

2 files

2.0.0

3 files

1.1.2

1 file

Pre-release

1.1.1a0

1 file

1.0.8

1 file

1.0.7

1 file

1.0.6

1 file

1.0.5

1 file

1.0.4

1 file

1.0.3

1 file

1.0.2

1 file

1.0.1

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page