Frequently asked questions

Coverage, licensing, pricing, update cadence and getting started — the common questions about The DataGarden, answered plainly.

Which countries and regions does The DataGarden cover?

Coverage depends on the data domain. Demographics spans 190+ countries via the UN World Population Prospects, plus EU/EEA regions at NUTS-2 level via Eurostat. Four countries have deep national-statistics-office coverage today: the Netherlands (down to postcode-4 and municipality), France (IRIS sub-municipal), the United Kingdom (ONS geographies) and the United States (national, state and county), with more sources being added. Every dataset states its exact coverage on its catalog page.

How is this different from querying Eurostat, CBS or INSEE directly?

Each official source has its own format, geography codes, update schedule and API. The DataGarden ingests them and normalizes everything into one schema with consistent geographic identifiers (postal code, H3 cell, NUTS region) and aligned time periods — so you make one kind of request instead of onboarding each provider separately, and you can compare across sources and countries directly. Every response cites its upstream source.

What are the licensing and reuse terms of the data?

The underlying data comes from official public sources, each under its own open terms, and every response cites its origin. TODO(maarten): confirm and state The DataGarden's own licensing and reuse terms for the harmonized data and API responses.

How much does it cost?

The DataGarden offers a free tier (currently 1,000 queries per month) plus paid plans for higher volume. TODO(maarten): confirm the current paid tiers and prices before publishing — kept general here because pricing is still being finalised.

How often is the data updated?

Data refreshes when the upstream source publishes new figures, and every response carries the publication date of each source, so you always know how current a value is. Cadence varies by domain and source — demographic series are typically annual and many economic series quarterly. TODO(maarten): confirm the exact update cadence per domain/source before stating specifics.

How do I get an API key?

Create a free account, then generate a key under My Account → API keys. Send it on every request in the X-API-Key header, and keep it secret. The API quickstart walks through your first call with copy-pasteable curl and Python examples.