skillfed

pygeocodio

Python wrapper for Geocod.io API

pygeocodio v2.0.1 77.2K downloads/30d#14,550 on PyPI102
Permissive license BSD AGING released

What it is and what it does

Pygeocodio is a Python wrapper around the Geocodio geocoding service, which converts addresses to coordinates and vice versa. It handles single and batch operations—up to 10,000 addresses or points per request—and can parse addresses into their component parts. The library depends only on requests and works with Python 3.9 and later.

The package is designed for developers who need to integrate address lookup, validation, or geographic coordinate retrieval into applications serving U.S. and Canadian users. It abstracts away HTTP request handling and response parsing, returning results as Python objects with convenient accessors for coordinates and formatted addresses.

Use it for:

  • Geocode a list of customer addresses in bulk to populate a map or location-based service.
  • Reverse geocode GPS coordinates from a mobile app to display human-readable street addresses.
  • Parse and validate address components from user input before storing in a database.
  • Build a location lookup feature for e-commerce or delivery routing applications.
  • Integrate address standardization into data import pipelines for CRM systems.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Python client library for the Geocodio API, enabling geocoding, reverse geocoding, batch operations, and address parsing for U.S. and Canadian addresses.

Yes, if you need Geocodio integration and can work within its U.S./Canada scope. Low install friction, permissive license, and no known vulnerabilities make it a straightforward choice. The aging maintenance status (422 days since last release) is a minor concern—monitor the repository for breaking changes in the Geocodio API itself, but the package is stable and production-ready for current Python versions.

Install

pygeocodio on PyPI

pip

pip install pygeocodio

uv

uv add pygeocodio

poetry

poetry add pygeocodio

Installing pygeocodio

Before you install

Low install friction with a single runtime dependency (requests). Package is in production/stable status, though aging—last release was 422 days ago. Supports current Python versions (3.9 through 3.13).

License in practice

BSD License (permissive) places no restrictions on use, modification, or redistribution in proprietary or open-source projects.

Quickstart

pip install pygeocodio

from geocodio import GeocodioClient
client = GeocodioClient(YOUR_API_KEY)
geocode_result = client.geocode('42370 Bob Hope Drive, Rancho Mirage CA')
print(geocode_result.coords)

Requires a valid Geocodio API key; service is limited to U.S. and Canadian addresses.

Verify before relying

  • Whether the package is actively maintained or in maintenance-only mode given the 422-day gap since last release.
  • Current status of Geocodio API service and any breaking changes since the package's last update.

Package facts

License BSD (permissive)
Python support supports the current Python release (>=3.9)
Install friction low — pure-Python wheel
Runtime dependencies 1 — requests
Maintenance aging — 422 days since the last release
Last repo commit
First released
Downloads 77,178/month — #14,550 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: pygeocodio-2.0.1-py3-none-any.whl

Keywords: geocodio

Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: BSD LicenseNatural Language :: EnglishProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.9Topic :: Internet :: WWW/HTTP

Tags

geocoding api clientaddress geocoding pythonreverse geocodingbatch geocodingaddress parsinggeocodio wrapperlocation lookup
geocodinglocation-servicesapi-client

More WWW/HTTP packages