Income & Earnings: Household × Income

curl https://api.eolas.nz/v1/datasets/inc_household_income/data ^
  -H "X-API-Key: your_key_here"

curl "https://api.eolas.nz/v1/datasets/inc_household_income/data?start=2020-01-01&end=2024-12-31" ^
  -H "X-API-Key: your_key_here"

curl "https://api.eolas.nz/v1/datasets/inc_household_income/data?format=csv" ^
  -H "X-API-Key: your_key_here" -o inc_household_income.csv

Invoke-RestMethod `
  -Uri "https://api.eolas.nz/v1/datasets/inc_household_income/data" `
  -Headers @{ "X-API-Key" = "your_key_here" } | ConvertTo-Json

pip install eolas-data

from eolas_data import Client

client = Client("your_key_here")
df = client.get("inc_household_income")
print(df.head())

df = client.get("inc_household_income", start="2020-01-01", end="2024-12-31")
print(df.head())

df = client.get("inc_household_income")
df.to_csv("inc_household_income.csv", index=False)

CREATE DATABASE vs_warehouse
  FROM SHARE MRWTYQY-WZ79363.vs_warehouse_share;

SELECT *
FROM vs_warehouse.STATS_NZ.INC_HOUSEHOLD_INCOME
ORDER BY date DESC
LIMIT 100;

SELECT *
FROM vs_warehouse.STATS_NZ.INC_HOUSEHOLD_INCOME
WHERE date >= '2020-01-01'
  AND date <= '2024-12-31'
ORDER BY date;

-- Run the query above, then use
-- Results → Download as CSV in the Snowflake UI

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

library(eolas)
eolas_key("your_key_here")
df <- eolas_get("inc_household_income")
head(df)

df <- eolas_get("inc_household_income", start = "2020-01-01", end = "2024-12-31")
head(df)

df <- eolas_get("inc_household_income")
write.csv(df, "inc_household_income.csv", row.names = FALSE)

let
    apiKey  = "your_key_here",
    url     = "https://api.eolas.nz/v1/datasets/inc_household_income/data",
    source  = Json.Document(Web.Contents(url,
                  [Headers = [#"X-API-Key" = apiKey]])),
    toTable = Table.FromList(source, Splitter.SplitByNothing(), {"Record"}),
    cols    = Record.FieldNames(toTable{0}[Record]),
    result  = Table.ExpandRecordColumn(toTable, "Record", cols)
in
    result

let
    apiKey  = "your_key_here",
    url     = "https://api.eolas.nz/v1/datasets/inc_household_income/data?start=2020-01-01&end=2024-12-31",
    source  = Json.Document(Web.Contents(url,
                  [Headers = [#"X-API-Key" = apiKey]])),
    toTable = Table.FromList(source, Splitter.SplitByNothing(), {"Record"}),
    cols    = Record.FieldNames(toTable{0}[Record]),
    result  = Table.ExpandRecordColumn(toTable, "Record", cols)
in
    result

let
    apiKey  = "your_key_here",
    url     = "https://api.eolas.nz/v1/datasets/inc_household_income/data",
    source  = Json.Document(Web.Contents(url,
                  [Headers = [#"X-API-Key" = apiKey]])),
    toTable = Table.FromList(source, Splitter.SplitByNothing(), {"Record"}),
    cols    = Record.FieldNames(toTable{0}[Record]),
    result  = Table.ExpandRecordColumn(toTable, "Record", cols)
in
    result

let
    apiKey  = "your_key_here",
    url     = "https://api.eolas.nz/v1/datasets/inc_household_income/data?start=2020-01-01&end=2024-12-31",
    source  = Json.Document(Web.Contents(url,
                  [Headers = [#"X-API-Key" = apiKey]])),
    toTable = Table.FromList(source, Splitter.SplitByNothing(), {"Record"}),
    cols    = Record.FieldNames(toTable{0}[Record]),
    result  = Table.ExpandRecordColumn(toTable, "Record", cols)
in
    result

function getVSData() {
  const apiKey = "your_key_here";
  const url    = "https://api.eolas.nz/v1/datasets/inc_household_income/data";

  const res  = UrlFetchApp.fetch(url, { headers: { "X-API-Key": apiKey } });
  const data = JSON.parse(res.getContentText());

  const sheet   = SpreadsheetApp.getActiveSheet();
  const headers = Object.keys(data[0]);
  const rows    = data.map(r => headers.map(h => r[h] ?? ""));

  sheet.clearContents();
  sheet.getRange(1, 1, 1, headers.length).setValues([headers]);
  sheet.getRange(2, 1, rows.length, headers.length).setValues(rows);
}

function getVSData() {
  const apiKey = "your_key_here";
  const url    = "https://api.eolas.nz/v1/datasets/inc_household_income/data?start=2020-01-01&end=2024-12-31";

  const res  = UrlFetchApp.fetch(url, { headers: { "X-API-Key": apiKey } });
  const data = JSON.parse(res.getContentText());

  const sheet   = SpreadsheetApp.getActiveSheet();
  const headers = Object.keys(data[0]);
  const rows    = data.map(r => headers.map(h => r[h] ?? ""));

  sheet.clearContents();
  sheet.getRange(1, 1, 1, headers.length).setValues([headers]);
  sheet.getRange(2, 1, rows.length, headers.length).setValues(rows);
}