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 Aug 23, 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.116)

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 Aug 23, 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.111.tar.gz (446.9 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.111-cp310-abi3-win_amd64.whl (517.5 kB view details)

Uploaded CPython 3.10+Windows x86-64

iptocc-3.3.111-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (630.5 kB view details)

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

iptocc-3.3.111-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (630.1 kB view details)

Uploaded CPython 3.10+manylinux: glibc 2.17+ ARM64

iptocc-3.3.111-cp310-abi3-macosx_11_0_arm64.whl (620.3 kB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

iptocc-3.3.111-cp310-abi3-macosx_10_12_x86_64.whl (619.5 kB view details)

Uploaded CPython 3.10+macOS 10.12+ x86-64

File details

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

File metadata

  • Download URL: iptocc-3.3.111.tar.gz
  • Upload date:
  • Size: 446.9 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.111.tar.gz
Algorithm Hash digest
SHA256 5d3deb27c144aa255afc884f97c59ce82c68eaa2dea8e30f499868dfb6aa48f7
MD5 5efa001b161fc7fd66eeeaa2399980b6
BLAKE2b-256 033d49930f81a11aab853741f8d0603ca6c400979852da158ad961f4df6d2a7c

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.111.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.111-cp310-abi3-win_amd64.whl.

File metadata

  • Download URL: iptocc-3.3.111-cp310-abi3-win_amd64.whl
  • Upload date:
  • Size: 517.5 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.111-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 b753acdd745cf738ea0fd375f377817a712ef2221e8e442dec23d4618cd37e52
MD5 45d36f521404ef8249593912a7b0ffa6
BLAKE2b-256 c96ed4ceef088c4e436bbb02d2d1fbd0e9bebb284085c60bb2b9daf8648f736c

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.111-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.111-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for iptocc-3.3.111-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 53f4ed96cb6dee6e5c68316043bca8c00b5a0f1988c6273aa14add45b426dc37
MD5 2a7af4ee06412d01c4f7e765716845b2
BLAKE2b-256 635f16b733b5c98132a805f35b3572760f3cfcb4a038a5017529ee7c28c74a4c

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.111-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.111-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for iptocc-3.3.111-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 4a9a8d0537de2673520e467813ba858c31c033d8fe19238e274c59eeaaa4de64
MD5 d1108f79701d0924809b74093bf339de
BLAKE2b-256 71b63c47a92903921a7b12cb5491bd286cfba7ae3af4f21b4e1582bcd286653e

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.111-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.111-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for iptocc-3.3.111-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 7f1ad8ea42512065f83f13bbc64feee12023efb0807fcc4a6a8b5fe514a1ef8f
MD5 d983951941e50d0b184d4da039d5938d
BLAKE2b-256 7a0c3e8fbe457066cddd23332704257894ace5923c20fd6d885a4d78fa3e598f

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.111-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.111-cp310-abi3-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for iptocc-3.3.111-cp310-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 e469bb331fbd52ee0833696f3bf0d08d552a8cdaa1a241253ec5243c87882b03
MD5 0241359c2ebf21b3f74a19df2b1f13b0
BLAKE2b-256 5cdcb4c11c1f0481f66c8de13838b278f4c3cf23dd2d7808c679bb69dc36421f

See more details on using hashes here.

Provenance

The following attestation bundles were made for iptocc-3.3.111-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.116

6 files

3.3.115

6 files

3.3.114

6 files

3.3.113

6 files

3.3.112

6 files

This release

3.3.111 This release

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