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 1539+ NZ datasets, one line of code.

Get your free API key

10 requests/month free, no credit card. Up to 50,000 rows per request.

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("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("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_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.fyi/datasets/rbnz_b1_exchange_rates_monthly

CSV downloads available on every dataset detail page. 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("sa2_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.fyi/datasets.

Free tier is generous for one-off projects

10 requests/month and up to 50,000 rows per request — all 1539+ datasets, no credit card. Upgrade to Pro ($49/mo) for unlimited rows.

Get started