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.
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 /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.