The DataGarden · REST API

Location-enriched public data.
One API call away.

Query demographics, economics, real estate, and domain signals by postal code, H3 cell, or bounding box — across 195+ countries. No data pipeline to build. No normalization headaches.

Get free API key → Read the docs

REST API Python SDK 195+ countries Postal-code granularity Free sandbox

example.py — enrich by postal code

# pip install the-datagarden
from the_datagarden import DataGarden

dg = DataGarden(api_key="your-api-key")

# Get demographics for a French postal code
data = dg.region("FR-75001").get([
    "population",
    "income_avg",
    "household_count",
    "pet_ownership_index"
])

# Bulk enrichment for your entire outlet list
enriched = dg.enrich_batch(
    postcodes=["75001", "69001", "13001"],
    country="FR",
    fields=["demographics", "economics"]
)

How it works

Built for data engineers

Integrate in minutes. Scale to millions of locations.

Register for a free API key

Instant access. No sales call, no approval process. Free sandbox tier includes 1,000 calls/month.

Install the SDK or use REST directly

pip install the-datagarden or call the REST API from any language. Full Postman collection and OpenAPI spec available.

Query by postal code, H3, or bounding box

Send a postcode, get back a JSON object with all available signals for that location. Batch enrichment for up to 10,000 locations per request.

Integrate into your pipeline

Pandas DataFrames, GeoDataFrames, or raw JSON. Pull fresh data on a schedule or enrich on-the-fly. Response time: <200ms for single queries.

HTTP · GET /v1/region/FR-75001/all

GET /v1/region/FR-75001/all
Authorization: Bearer your-api-key

HTTP 200 OK
{
  "postal_code": "75001",
  "country": "FR",
  "region": "Île-de-France",
  "demographics": {
    "population": 17151,
    "households": 8920,
    "income_avg": 42300,
    "age_median": 38.4
  },
  "domain_signals": {
    "pet_ownership_index": 0.72,
    "purchasing_power": 1.24,
    "urbanization_score": 0.98
  }
}

Core endpoints

Clean REST, consistent patterns

Same shape across all data types — postal code, H3, bounding box, batch, and catalog.

GET /v1/region/{postal_code}/{theme} Demographics, economics, real estate for a specific postal code

GET /v1/h3/{h3_index}/{theme} Data by H3 hexagonal cell (resolutions 5–10)

POST /v1/batch/enrich Bulk enrichment for up to 10,000 locations per request

GET /v1/country/{iso_code}/summary National-level summary statistics with time-series data

GET /v1/catalog/themes List all available data themes and coverage per country

Coverage

One API. The world.

Postal-code granularity everywhere it's available. National rollups where it isn't.

195+

Countries

Data themes

50+

Domain signals

Postal

code granularity

Demographics

Economics

Real Estate

Health

Education

Environment

Labour Market

Transport

Business Registry

Points of Interest

Pricing

Start free. Pay for what you use.

No surprise bills. All plans include the full catalog — no feature gating.

Sandbox

Free

forever

1,000 API calls/mo

Build and test your integration. No time limit, no credit card.

Common questions

How is the data kept up to date?

We run automated collection pipelines against government portals and national statistics offices. Most datasets refresh annually. The API metadata endpoint shows the last update date and source for each data field.

What happens if a postal code isn't covered?

The API returns what's available for that location with field-level coverage flags. You'll always know what data exists vs. what's missing — no silent nulls.

Can I use this for real-time enrichment at request time?

Yes. Single-location queries respond in <200ms. Batch endpoints are optimized for offline processing of large datasets.

Is there an SLA for production use?

99.9% uptime SLA is available on Pro and Enterprise plans. The sandbox tier is best-effort.

Can I access the Python SDK documentation?

Full SDK docs are at docs.the-datagarden.io. The SDK wraps the REST API and returns pandas DataFrames or GeoDataFrames depending on the query type.

Commercial use terms?

You can use enriched data in your commercial products and pipelines. You cannot re-sell or redistribute the raw data itself. Full terms are in the API terms of service.

Start building with real-world data

Free API key. No credit card. 1,000 calls to explore before you commit to anything.

Subscribe free → Browse documentation

Location-enriched public data.One API call away.