The data API

Search the library, fetch any statistic by id, or construct an exact statistic from a source's dimensions.

Search

Search returns matching statistics with their ids. Search is per source; source defaults to worldbank. The source ids come from the registry.

GET /v1/statistics?search=gdp&source=worldbank { "results": [ { "id": 4821, "title": "GDP (current US$) · World", "source": "worldbank" }, … ] }

Fetch a statistic

A statistic id is stable: the same id always resolves to the same selection, with the data refreshed live from the source.

GET /v1/statistic/4821 { "id": 4821, "title": "United States GDP", "unit": "current US$", "geography": "United States", "source": { "publisher": "World Bank", "series": "NY.GDP.MKTP.CD", "url": "https://data.worldbank.org", "license": "CC BY 4.0" }, "coverage": [1960, 2024], "periods": [1960, …, 2024], "values": [543300000000, …, 29184890000000] }

The same shape for every source: a period axis, a value series, and enough metadata to cite it.

Construct an exact statistic

Search covers the common statistics. For anything else a source measures, construct the exact statistic from the source's dimensions: pass one value per dimension and the API mints a stable id for that selection and resolves it.

# what dimensions does a source take? GET /v1/sources/worldbank { "dimensions": [ { "id": "statistic" }, { "id": "country" } ] } # browse a dimension's valid values GET /v1/sources/worldbank/dimensions/country?search=germ { "values": [ { "value": "DEU", "label": "Germany" } ] } # construct: one value per dimension → the statistic, with a minted id GET /v1/statistic?source=worldbank&statistic=NY.GDP.MKTP.CD&country=DEU

An omitted dimension falls back to the source's default where one exists (the World Bank default country is World); otherwise the response is 422 missing_dimension naming what to add.

The source registry

GET /v1/sources lists every connected source with its publisher, cadence, coverage, and license. GET /v1/sources/{source} describes one source's dimensions, and GET /v1/sources/{source}/dimensions/{dim} browses a dimension's values.