Metadata-Version: 2.4
Name: datumforge
Version: 0.0.1
Summary: DatumForge — one API for the reference data your app assumes exists. Sixteen public sources, one schema. Name placeholder; the Python client is not published yet.
Author-email: Loved Digital Consulting <support@loveddigital.com>
Project-URL: Documentation, https://api.loveddigital.com/docs
Project-URL: Attribution, https://api.loveddigital.com/attribution
Keywords: reference-data,countries,states,cities,zip-codes,cbsa,dma,area-codes,public-holidays,exchange-rates,api-client
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# DatumForge

One API for the reference data your app assumes exists. Sixteen public sources, one schema.
From Loved Digital Consulting.

> **This package is a name placeholder.** The Python client is not published yet. The API is live
> and usable directly over HTTP today — see the docs below.

## What the API serves

- **Geography / administrative** — countries, states and subdivisions, cities, US counties, ZIP
  codes, CBSAs, DMAs, NANPA area codes
- **Indicators** — World Bank, US Census ACS, BEA, BLS, IRS, broadband
- **Operational lookups** — currency exchange rates, public holidays

Sixteen public and open-licensed sources arrive in sixteen shapes and leave as one object with one
contract. Every list endpoint supports `fields`, `sort`, and `limit`/`offset` pagination, and
returns an `X-Total-Count` header.

## Using it today

```python
import httpx

base = "https://api.loveddigital.com"

httpx.get(f"{base}/countries/", params={"name": "Japan", "fields": "common_name,cca2"}).json()
httpx.get(f"{base}/zip/90210").json()
httpx.get(f"{base}/rates/USD/EUR", params={"amount": 100}).json()
```

- **Docs** — <https://api.loveddigital.com/docs>
- **OpenAPI spec** — <https://api.loveddigital.com/openapi.json>

## Licensing

This package is proprietary and reserved for future use by Loved Digital Consulting.

The **data** the API returns carries per-source obligations and cannot be collapsed into a single
licence — ODbL 1.0, CC BY 4.0, public domain, MIT, and Nielsen-proprietary sources are all
represented. Credits are published per source at
<https://api.loveddigital.com/attribution>, which is the authoritative statement.

## Contact

<support@loveddigital.com>
