Metadata-Version: 2.4
Name: pequi-api-client
Version: 0.1.0
Summary: Official Python SDK for the Pequi API — Colombian real estate data for developers
Author-email: MCPVOT <dev@xpequi.xyz>
License: MIT
Project-URL: Homepage, https://xpequi.xyz/developers
Project-URL: Repository, https://github.com/MCPVOT/pequi
Project-URL: Documentation, https://xpequi.xyz/developers/api-ref
Keywords: colombia,real-estate,ibague,propiedades,inmobiliario,pequi
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: urllib3>=2.0.0
Requires-Dist: python-dateutil>=2.8.0
Requires-Dist: certifi>=2024.0.0

# pequi-api-client

Official Python SDK for the Pequi API — Colombian real estate data for developers.

## Install

```bash
pip install pequi-api-client
```

## Quick Start

```python
from pequi_api_client import PequiClient

client = PequiClient(api_key="pk_live_your_key_here")

# Search properties
props = client.properties.search(city="ibague", tipo="apartamento", limit=5)
for p in props:
    print(f"{p['name']} - ${p['monthlyRent'] or p['salePrice']:,} COP")

# List neighborhoods
barrios = client.barrios.list()
print(f"Found {len(barrios)} neighborhoods")

# Geocode an address
location = client.geocode.geocode("Calle 10 #3-15, Ibagué")
print(f"Coordinates: {location['lat']}, {location['lng']}")
```

## Documentation

Full API reference: https://xpequi.xyz/developers/api-ref
Developer portal: https://xpequi.xyz/developers
