---
id: pygeocodio
version: "2.0.1"
license: BSD
license_treatment: permissive
maintenance: aging
---

# pygeocodio — Python wrapper for Geocod.io API

License: permissive · Maintenance: aging · Downloads: 77.2K/mo

## 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 above — 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

pip install pygeocodio
uv add pygeocodio
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_current
- Install friction: low
- Maintenance: aging
- Downloads: 77.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

geocoding api client, address geocoding python, reverse geocoding, batch geocoding, address parsing, geocodio wrapper, location lookup, geocoding, location-services, api-client

[View on SkillFed](https://skillfed.io/packages/pygeocodio) · [View on PyPI](https://pypi.org/project/pygeocodio/)