Households and families
/v1/suburbs/{suburb_name}/area-stats/households5¢ per callHousehold and family make-up: lone-person, family and group households, household size, couples with and without children and one-parent families, for every suburb and council area.
Coverage: About 10,600 suburbs and localities and 545 council areas across Australia, in all states and territories (areas with too few residents for reliable figures are left out); one snapshot at 10 August 2021. Current to 2021-08-10. Full description, field list and method: /v1/datasets/households.
Exact suburb identifier required. Exact official suburb name (SAL), e.g. Burwood (NSW) — many suburbs carry a state suffix. If starting from free text or an unverified bare name, first call GET /v1/geocode/suburb?q=<text>, then use the exact data[].area_name it returns. Suburb data endpoints do not guess a state or typo-correct names.
Authorization
Request
The only values you send. Fields under Responses below are what comes back — you never pass those.
Path parameters
suburb_namestringrequiredExact official suburb name (SAL), e.g. `Burwood (NSW)` — many suburbs carry a state suffix. If starting from free text or an unverified bare name, first call `GET /v1/geocode/suburb?q=<text>`, then use the exact `data[].area_name` it returns. Suburb data endpoints do not guess a state or typo-correct names.
Query parameters
fieldsstringoptionalComma-separated subset of: total_households, total_families, family_households_count, family_households_pct, non_family_households_count, non_family_households_pct, lone_person_households_count, lone_person_households_pct, size_1_person_count, size_1_person_pct, size_2_people_count, size_2_people_pct, size_3_people_count, size_3_people_pct, size_4_people_count, size_4_people_pct, size_5_people_count, size_5_people_pct, size_6_plus_people_count, size_6_plus_people_pct, couple_no_children_count, couple_no_children_pct, couple_with_children_count, couple_with_children_pct, one_parent_families_count, one_parent_families_pct, other_families_count, other_families_pct, couple_children_under_15_count, couple_children_under_15_pct, one_parent_children_under_15_count, one_parent_children_under_15_pct, couple_families_count, couple_families_pct. Omit for all.
fromstringoptionalFirst period to include: 2020, 2020-Q3, 2020-07 or 2020-07-01.
tostringoptionalLast period to include, same formats as `from`.
Responses
Successful Response
datasetstringalways returnedDataset slug; describe it with /v1/datasets/{slug}.
levelstringalways returnedsuburb, lga or block.
areastringalways returnedCanonical name (or mesh-block code) of the area answered.
period_typestringalways returnedsnapshot, year, financial_year, quarter or month.
as_ofstring · datealways returnedDate the dataset is current to. Values are never withheld for age; check this instead.
modelledbooleanalways returnedTrue when the figures are estimates from a model rather than counts or measurements.
fieldsarray of DatasetFieldSeriesalways returned/v1/suburbs/{suburb_name}/area-stats/householdscurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/area-stats/households' \
--header 'Authorization: Bearer test'{
"data": {
"dataset": "households",
"level": "suburb",
"area": "Bondi",
"period_type": "snapshot",
"as_of": "2021-08-10",
"modelled": false,
"fields": [
{
"field": "total_households",
"name": "Total households",
"unit": "households",
"values": [
{
"period": "2021-08-10",
"period_start": "2021-08-10",
"value": 4484
}
]
},
{
"field": "total_families",
"name": "Total families",
"unit": "families",
"values": [
{
"period": "2021-08-10",
"period_start": "2021-08-10",
"value": 2408
}
]
},
{
"field": "family_households_count",
"name": "Family households",
"unit": "households",
"values": [
{
"period": "2021-08-10",
"period_start": "2021-08-10",
"value": 2392
}
]
}
]
}
}About this dataset
About 10,600 suburbs and localities and 545 council areas across Australia, in all states and territories (areas with too few residents for reliable figures are left out); one snapshot at 10 August 2021. Current to 2021-08-10; refreshed five-yearly.
What it is
The make-up of households and families on 10 August 2021, for every suburb and council area: how many households are family, lone-person or group households, how many have one to six or more people, and how many families are couples with children, couples without, one-parent or other, with a head-count and a share for each.
What it shows
Households by type and size (base: all households) and families by type (base: all families), each as a count and a share, plus total households and total families.
Why use it
Household mix tells you who a suburb is for: young couples, families with children, retirees living alone, share houses. Use it to match a suburb to a buyer or tenant, to size demand for different dwelling types, to judge school and childcare need, or to add a household profile to a report.
How it is built
Areas with fewer than 50 residents are left out because every small number is randomised. Our 2021 area statistics, matched to our suburb and council-area names. Figures are a snapshot at 10 August 2021 (the latest full count), so they describe who lived there then, not today. To protect privacy the source lightly randomises small numbers, so a count of 0, 3 or 6 can be approximate; shares for tiny suburbs jump around, so check the total residents field before trusting a percentage. Household shares use all occupied private households as the base; family shares use all families as the base. A household can hold more than one family, so families do not equal family households. couple_with_children is all couple families minus couples with no children.
Fields
| Field | Unit | Description |
|---|---|---|
total_householdsTotal households | households | Occupied private households counted in the area on 10 August 2021, the base for household shares. |
total_familiesTotal families | families | Families (couples, one-parent and other) living in private households in the area, the base for family shares. |
family_households_countFamily households | households | Number of households in the area that are: family households (2021 snapshot). Small counts are lightly randomised for privacy. |
family_households_pctFamily households: share of households | % | Family households as a percent of all households in the area. |
non_family_households_countNon-family households | households | Number of households in the area that are: non-family households (2021 snapshot). Small counts are lightly randomised for privacy. |
non_family_households_pctNon-family households: share of households | % | Non-family households as a percent of all households in the area. |
lone_person_households_countLone-person households | households | Number of households in the area that are: lone-person households (2021 snapshot). Small counts are lightly randomised for privacy. |
lone_person_households_pctLone-person households: share of households | % | Lone-person households as a percent of all households in the area. |
size_1_person_countHouseholds of 1 person | households | Number of households in the area that are: households of 1 person (2021 snapshot). Small counts are lightly randomised for privacy. |
size_1_person_pctHouseholds of 1 person: share of households | % | Households of 1 person as a percent of all households in the area. |
size_2_people_countHouseholds of 2 people | households | Number of households in the area that are: households of 2 people (2021 snapshot). Small counts are lightly randomised for privacy. |
size_2_people_pctHouseholds of 2 people: share of households | % | Households of 2 people as a percent of all households in the area. |
size_3_people_countHouseholds of 3 people | households | Number of households in the area that are: households of 3 people (2021 snapshot). Small counts are lightly randomised for privacy. |
size_3_people_pctHouseholds of 3 people: share of households | % | Households of 3 people as a percent of all households in the area. |
size_4_people_countHouseholds of 4 people | households | Number of households in the area that are: households of 4 people (2021 snapshot). Small counts are lightly randomised for privacy. |
size_4_people_pctHouseholds of 4 people: share of households | % | Households of 4 people as a percent of all households in the area. |
size_5_people_countHouseholds of 5 people | households | Number of households in the area that are: households of 5 people (2021 snapshot). Small counts are lightly randomised for privacy. |
size_5_people_pctHouseholds of 5 people: share of households | % | Households of 5 people as a percent of all households in the area. |
size_6_plus_people_countHouseholds of 6 or more people | households | Number of households in the area that are: households of 6 or more people (2021 snapshot). Small counts are lightly randomised for privacy. |
size_6_plus_people_pctHouseholds of 6 or more people: share of households | % | Households of 6 or more people as a percent of all households in the area. |
couple_no_children_countCouple families with no children | families | Number of families in the area that are: couple families with no children (2021 snapshot). Small counts are lightly randomised for privacy. |
couple_no_children_pctCouple families with no children: share of families | % | Couple families with no children as a percent of all families in the area. |
couple_with_children_countCouple families with children | families | Number of families in the area that are: couple families with children (2021 snapshot). Small counts are lightly randomised for privacy. |
couple_with_children_pctCouple families with children: share of families | % | Couple families with children as a percent of all families in the area. |
one_parent_families_countOne-parent families | families | Number of families in the area that are: one-parent families (2021 snapshot). Small counts are lightly randomised for privacy. |
one_parent_families_pctOne-parent families: share of families | % | One-parent families as a percent of all families in the area. |
other_families_countOther families | families | Number of families in the area that are: other families (2021 snapshot). Small counts are lightly randomised for privacy. |
other_families_pctOther families: share of families | % | Other families as a percent of all families in the area. |
couple_children_under_15_countCouple families with children under 15 | families | Number of families in the area that are: couple families with children under 15 (2021 snapshot). Small counts are lightly randomised for privacy. |
couple_children_under_15_pctCouple families with children under 15: share of families | % | Couple families with children under 15 as a percent of all families in the area. |
one_parent_children_under_15_countOne-parent families with children under 15 | families | Number of families in the area that are: one-parent families with children under 15 (2021 snapshot). Small counts are lightly randomised for privacy. |
one_parent_children_under_15_pctOne-parent families with children under 15: share of families | % | One-parent families with children under 15 as a percent of all families in the area. |
couple_families_countCouple families (all) | families | Number of families in the area that are: couple families (all) (2021 snapshot). Small counts are lightly randomised for privacy. |
couple_families_pctCouple families (all): share of families | % | Couple families (all) as a percent of all families in the area. |