for your information

For analysts & researchers

Stop scraping Stats NZ. Browse 1548+ official NZ datasets — download CSV for Excel, or pull tidy tables into R and Python with one line of code.

Browse datasets → Create free account

Free account: 10 downloads/month to sample and test — no credit card. Pro ($49 NZD/mo) for ongoing work.

No code: get a CSV in three steps

You don't need Python, R, or a terminal. Excel and Google Sheets work fine.

1

Browse the catalog

Search for CPI, exchange rates, census tables, or boundaries. Preview the data before you sign up — metadata browsing is free.

2

Create a free account

Needed to download files. Ten requests per month — enough to sample datasets and confirm they fit your project before upgrading.

3

Click Download CSV on the dataset page

Open the file in Excel or Google Sheets. Each download counts as one request. Filter by date range on the dataset page before downloading.

Need automated weekly refreshes? See the CLI option below, or upgrade to Pro for unlimited requests.

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 (small-area census geography), territorial authority, region — Stats NZ polygons, ready for maps.

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 (NZ transport agency) traffic counts, crash data, road policing. Millions of records, streaming-safe.

eolas_get("nzta_tms_2024")

Pick your tool

Same data, three ways in.

📈

Excel / CSV

The simplest path — browse, download, open in Excel. No install required.

Go to eolas.fyi/datasets
Open a dataset (e.g. RBNZ exchange rates)
Log in → click Download CSV

Want scheduled refreshes? eolas schedule via the CLI (optional).

📊

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.

Common tasks, sorted

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

Browse → rbnz_b1_exchange_rates_monthly → set start date → Download CSV. Or via CLI:

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

Requires the CLI. Removes cleanly with eolas schedule remove rbnz_b1_exchange_rates_monthly.

"I need to know what's available"

Start at the dataset catalog — search and filter by source. Power users:

eolas datasets list --search rbnz
eolas datasets preview rbnz_b1_exchange_rates_monthly

Sample it free, upgrade for production

10 requests per month on Free — enough to explore datasets and run a proof of concept. Pro ($49 NZD/mo) removes the cap for ongoing analysis.

Create free account