Metadata-Version: 2.4
Name: amalgament
Version: 0.1.0
Summary: Thin zero-dependency client for the Amalgament public-query API (clean public government data, entity + parcel keyed)
Author: Amalgament
License: MIT
Project-URL: Homepage, https://amalgament.com
Project-URL: API, https://api.amalgament.com
Keywords: public data,government data,parcel,entity resolution,api
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# amalgament (Python SDK)

Thin, **zero-dependency** client for the Amalgament public-query API — clean public
and government data across the US, entity- and parcel-keyed.

## Install

```bash
pip install amalgament
```

## First call

```python
import amalgament
c = amalgament.Client(api_key="pq_...")        # or export AMALGAMENT_API_KEY=pq_...

c.search("BROOKLYN BREWERY", limit=5)          # 2 credits
c.parcel("4098390003")                         # 1 credit — owner + permits + evictions + ...
c.entity("REPUBLIC SERVICES OF FLORIDA")       # 2 credits — cross-source dossier
c.owns("EIN:123456789")                        # 3 credits — ownership portfolio
c.context(zip="11432")                         # 1 credit — ACS/FEMA/BLS/NOAA/EIA stack
c.datasets(); c.freshness(); c.account()       # free

c.last_credits                                 # {'charged': 2, 'remaining': 498}
for r in c.iter_search("liquor license", page_size=100, max_records=300):
    ...                                        # paged (each page = one metered call)
```

No key yet? `POST /signup {"email": "..."}` at `https://api.amalgament.com/signup`
returns a key + 500 free credits.

## CLI

```bash
export AMALGAMENT_API_KEY=pq_...
amalgament search "BROOKLYN BREWERY" --limit 5
amalgament parcel 4098390003
amalgament entity "REPUBLIC SERVICES OF FLORIDA"
amalgament context --zip 11432
amalgament balance
```
