Partners
Put district intelligence inside your own product: property portals, SME banking and fintech apps, chambers of commerce, franchise networks, development agencies, data marketplaces.
REST API
JSON over HTTPS, read-only, refreshed nightly. Authenticate with your key in the X-API-Key header. Keys are rate limited per minute and metered per day; /usage shows your own consumption.
curl -H "X-API-Key: $KEY" \ https://locumetry.com/api/v1/districts/TR_34_1421
| Endpoint | Returns |
|---|---|
/api/v1/usage | Request counts for the calling customer key, per day and route. |
/api/v1/health | health |
/api/v1/districts | districts |
/api/v1/provinces | provinces |
/api/v1/districts/{geo_id} | district |
/api/v1/provinces/{geo_id} | A province's own features and province-level scores, plus its districts. |
/api/v1/scores/history | Yearly values and ranks of a district's scores (or a province's, for province-level scores). |
/api/v1/screen | Districts that carry every `label`, none of `without_label`, and sit at or above / below the given national |
/api/v1/labels | Every district label with its meaning and how many districts carry it. |
/api/v1/labels/{label} | Districts carrying a label, with the inputs that fired the rule. |
/api/v1/districts/{geo_id}/history | history |
/api/v1/districts/{geo_id}/observations | observations |
/api/v1/rankings | rankings |
/api/v1/features | feature rankings |
/api/v1/metrics | metrics |
/api/v1/scores | scores |
/api/v1/catalog/features | feature catalog |
/api/v1/h3 | h3 cells |
/api/v1/neighborhoods | neighborhoods |
/api/v1/districts/{geo_id}/similar | Districts most like this one, with the features where each differs most and the labels they share. |
Interactive reference: /api/v1/docs · schema: openapi.json
Embeddable widget
A compact district card (population, personas, headline scores) for any page, in one line. It counts against your key like an API call.
<iframe src="https://locumetry.com/widget/TR_34_1421?key=YOUR_KEY"
width="360" height="420" style="border:0" loading="lazy"></iframe>
Preview: Kadıköy card.
Terms in one page
- You display the data inside your product; you do not resell the raw dataset.
- Keys are per organisation, revocable, metered. Volume tiers by monthly request count.
- Outputs are engineered indicators over public sources and are provided as is.
- Place-source attribution is available on request if your use requires it.