Skip to content

vswarehouse

Official Python and R clients for the vs-warehouse statistical data API.

Access 240+ economic and demographic time series from Stats NZ, the OECD, NZ Treasury, RBNZ, and LINZ — in two lines of code, returning a data frame ready for analysis.

PyPI R API

Choose your language

pip install vswarehouse

from vswarehouse import Client

client = Client("vs_your_key")

# Source-specific helpers
df = client.statsnz("nz_cpi", start="2020-01-01")
df = client.oecd("nz_gdp")

# Or plot it instantly
df.plot_series()

remotes::install_github("phildonovan/vswarehouse-r")

library(vswarehouse)

vs_key("vs_your_key")

# Source-specific helpers
df <- vs_get_statsnz("nz_cpi", start = "2020-01-01")

# One-line chart
vs_plot(df)

What's in the API?

Category Examples
Macroeconomics CPI, GDP growth, unemployment, interest rates
Labour & Earnings Employment, wages, gender pay gap
Business & Enterprise Firm counts, births/deaths, industry breakdowns
Population Resident population by age, sex, ethnicity, region
Justice & Social Charges, convictions, household expenditure
Fiscal Government spending, revenue, debt, NZ Super Fund
Geospatial Land parcels, roads, addresses, territorial authorities

Data is sourced from Stats NZ, the OECD, NZ Treasury, RBNZ, and LINZ, updated weekly.

Get an API key

Free tier (3 requests/day) requires no credit card. Get your key →

Plan Price Requests
Free $0 3/day
Starter $10/month 10/day
Pro $49/month Unlimited

View pricing →