Metadata-Version: 2.4
Name: gocreative-zip-validator
Version: 0.1.0
Summary: Validate a US ZIP / postal code and return city, state, county, timezone via the GoCreative AI pay-per-call API.
Author-email: Colin Hughes <contact@gocreativeai.com>
License: MIT
Project-URL: Homepage, https://api.gocreativeai.com
Project-URL: Pricing, https://api.gocreativeai.com/credits/buy
Keywords: zip,zipcode,postal-code,us-zip,zip-lookup,validation,gocreative,ai-agents,x402,api-client
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25
Dynamic: license-file

# gocreative-zip-validator

Tiny US ZIP / postal-code validator that returns city, state, county, timezone, and lat/lon centroid for the ZIP, via the GoCreative AI API.

## Install

```bash
pip install gocreative-zip-validator
```

## 30-second quickstart

```python
from gocreative_zip_validator import lookup

# Free demo tier (no key needed, 5 calls/day per IP):
print(lookup('94103'))

# Or with a paid API key:
print(lookup('94103', api_key="gck_your_key_here"))
```

You can also set `GOCREATIVE_API_KEY=gck_...` in your environment.

## What this returns

A dict fetched live from the GoCreative AI API — validate a us zip / postal code and return city, state, county, timezone.

## Need more endpoints?

This package wraps just **one** GoCreative endpoint. For the full SDK with
enrich / lookup / scrape / search across 145+ endpoints, install:

```bash
pip install gocreative
```

Powered by **GoCreative AI** — free tier 5 calls/day, paid plans at
<https://api.gocreativeai.com/credits/buy>.

## License

MIT
