for your information

For analysts & researchers

If you live in Excel, R, or a Jupyter notebook — stop scraping Stats NZ. Get CSV, DataFrames, and ggplot-ready tibbles for 1059+ NZ datasets, one line of code.

Get your free API key

10 requests/month free, no credit card.

What you can do in one line

📈 Pull a time series

CPI, unemployment, GDP, house prices, fiscal aggregates — all the usual NZ macro series.

df <- eolas_get("nz_cpi")

🗺 Pull a boundary

SA1, SA2, TA, Region, Urban Area — every Stats NZ Geospatial polygon, in WKT or sf.

sa2 <- eolas_get("sa2_2023")

📊 Census tables

2023, 2018, 2013 — joinable on SA1 / SA2 / Region. Demographics, housing, dwellings.

eolas_get("census_2023_housing_sa2")

🚗 Traffic + transport

Waka Kotahi traffic counts, crash data, road policing. Millions of records, streaming-safe.

eolas_get("nzta_tms_2024")

Pick your tool

Same data, three idiomatic interfaces.

📊

R

remotes::install_github(
  "phildonovan/eolas-r"
)
library(eolas)
eolas_key("your_key")

df <- eolas_get_statsnz("nz_cpi",
                       start = "2015-01-01")
eolas_plot(df)

Returns a tibble; eolas_plot() hands back a ggplot you can extend with +.

🐍

Python

pip install eolas-data

from eolas_data import Client
c = Client("your_key")

df = c.statsnz("nz_cpi",
               start="2015-01-01")
df.plot_dataset()

pandas DataFrame subclass. Optional [polars], [geo], [plot] extras.

📈

Excel / CSV

# From your terminal
pip install eolas-data[cli]
eolas auth set-key

eolas get nz_cpi \
  --format csv \
  --out cpi.csv

# Or download from
# eolas.fyi/datasets/nz_cpi

CSV downloads available on every dataset detail page. eolas schedule automates daily fetches.

Common tasks, sorted

"I need NZ CPI for the last 5 years as a CSV"

eolas get nz_cpi --start 2020-01-01 --format csv --out cpi.csv

"I need every SA2 polygon for a choropleth"

library(eolas); library(sf); library(ggplot2)
sa2 <- eolas_get("sa2_2023")
ggplot(sa2) + geom_sf()

"I need it refreshed automatically each Wednesday"

eolas schedule add nz_cpi --cron "0 8 * * 3" --out ~/data/cpi.csv

Installs a cron entry that re-fetches the dataset. Removes cleanly with eolas schedule remove nz_cpi.

"I need to know what's available"

eolas datasets list --search cpi
eolas datasets info nz_cpi
eolas datasets preview nz_cpi

Or browse the catalog at eolas.fyi/datasets.

Free tier is generous for one-off projects

10 requests/month, all 1059+ datasets, no credit card. Upgrade to Starter ($10/mo) if you need more.

Get started