For analysts & researchers

Work in Excel, R or Python? Get any of 1,538 NZ datasets as a CSV, a data frame or a tibble with one line of code.

Start 14-day trial

No card. Full Pro API, up to 50,000 rows per request. Ends on its own.

What you can do in one line

📈 Pull a time series

CPI, unemployment, GDP, house prices, fiscal aggregates — the usual NZ economic data.

df <- eolas_get("rbnz_b1_exchange_rates_monthly")

🗺 Pull a boundary

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

sa2 <- eolas_get("nz_statistical_area_2_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 rows, streamed in chunks. Filter by date to pull just what you need.

eolas_get("nzta_tms_daily_traffic")

Pick your tool

Same data in R, Python or Excel.

📊

R

install.packages(
  "eolas",
  repos = c("https://phildonovan.r-universe.dev",
            "https://cloud.r-project.org")
)
library(eolas)
eolas_key("your_key")

df <- eolas_get_rbnz("rbnz_b1_exchange_rates_monthly",
                    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.rbnz("rbnz_b1_exchange_rates_monthly",
            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 rbnz_b1_exchange_rates_monthly \
  --format csv \
  --out fx.csv

# Or download from
# eolas.nz/datasets/rbnz_b1_exchange_rates_monthly

CSV downloads on most dataset detail pages; the largest tables go through bulk download or the API. eolas schedule automates daily fetches.

Common tasks, sorted

"I need RBNZ exchange rates for the last 5 years as a CSV"

eolas get rbnz_b1_exchange_rates_monthly --start 2020-01-01 --format csv --out fx.csv

"I need every SA2 polygon for a choropleth"

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

"I need it refreshed automatically each Wednesday"

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

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

"I need to know what's available"

eolas datasets list --search rbnz
eolas datasets info rbnz_b1_exchange_rates_monthly
eolas datasets preview rbnz_b1_exchange_rates_monthly

Or browse the catalog at eolas.nz/datasets.

Try Pro on a real project for 14 days

14-day Pro trial, no card needed: all 1538+ datasets through the API, up to 50,000 rows per request. Bulk Parquet/CSV downloads aren't included in the trial. Upgrade to Pro (NZD $49/mo) for unlimited rows and bulk downloads.

Start 14-day trial