HERA is a standards-aligned atlas of public census and human-geography data for every country. This page covers how to authenticate, the base URL, and the core endpoints. Your API key arrives on the checkout confirmation page and by email.
Every authenticated request carries your API key. HERA accepts it in either of two headers — use whichever your HTTP client makes easy:
# canonical header X-HERA-API-Key: hera_your_key_here # or a standard bearer token (equivalent) Authorization: Bearer hera_your_key_here
Requests without a valid key still work for public endpoints, but return the limited anonymous view (e.g. a 10-row sample for paid data products). A valid key on a paid tier returns the full data. Keep your key secret; if it leaks, email support@masegoinc.com for a rotation.
https://hera.masegoinc.com
All endpoints below are relative to this host. Responses are JSON unless noted.
| Endpoint | Description |
|---|---|
| GET /api/v1/storefront/listings | List published data products (SKUs) with tier, pricing, and metadata. |
| GET /api/v1/storefront/download/{product_code} | Download a product bundle. Anonymous → a 10-row JSON sample; a paid-tier key → the full bundle as 24-hour presigned download URLs. |
| GET /dashboard/api/country/{iso3} | Country summary: datasets, tables, record counts, sources, SEL/CCL field
coverage, and admin levels (e.g. USA, GBR). |
| GET /dashboard/api/commercial/summary | US county-commercial catalog totals and score distributions. |
This is the stable, documented surface. Additional dashboard/data endpoints exist and may change without notice — build against the ones above.
# List products curl -H 'X-HERA-API-Key: hera_your_key_here' \ https://hera.masegoinc.com/api/v1/storefront/listings # Fetch the full US County Commercial bundle (paid tier) curl -H 'Authorization: Bearer hera_your_key_here' \ https://hera.masegoinc.com/api/v1/storefront/download/USA-county-commercial-v1.0
The download response includes access_level (sample or
full), a file_count, and — for paid tiers — a
bundle of presigned URLs valid for 24 hours.