Lifestyle summary — POIs, terrain, landmarks
/v1/suburbs/{suburb_name}/lifestyle/summary10¢ per callPOI category breakdown, terrain scalars, nearest train/shop and beach/hospital flags.
Exact suburb identifier required. Exact ABS Suburb and Locality (SAL) name, 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.
Price: 10¢ per call.
Authorization
Request
The only values you send. Fields under Responses below are what comes back — you never pass those.
Path parameters
suburb_namestringrequiredExact ABS Suburb and Locality (SAL) name, 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
Responses
Successful Response
area_namestringalways returnedSuburb (SAL) name.
area_levelstringalways returnedAlways 'suburb' for these endpoints.
total_poisintegeralways returnedTotal POIs across all categories.
poi_categoriesarray of PoiCategoryBreakdownalways returnedPer-category POI counts, largest first.
terrainobjectmay be nullPre-aggregated terrain scalars across the suburb's properties.
nearest_trainobjectmay be nullNearest train station to the suburb centroid.
nearest_shopobjectmay be nullNearest major shop / shopping centre to the suburb centroid.
has_beachbooleanalways returnedA beach exists within ~50 km.
nearest_beach_kmnumbermay be nullDistance to the nearest beach (km); null when none within ~50 km.
has_hospitalbooleanalways returnedA hospital exists within ~50 km.
nearest_hospital_kmnumbermay be nullDistance to the nearest hospital (km); null when none within ~50 km.
/v1/suburbs/{suburb_name}/lifestyle/summarycurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/lifestyle/summary' \
--header 'Authorization: Bearer test'{
"data": {
"area_level": "suburb",
"area_name": "Belmont North",
"has_beach": true,
"has_hospital": true,
"nearest_beach_km": 1.5,
"nearest_hospital_km": 1.4,
"nearest_shop": {
"category": "Supermarket",
"dist_km": 1.2,
"name": "Coles"
},
"nearest_train": {
"dist_km": 1.4,
"name": "Jewells railway station"
},
"poi_categories": [
{
"category": "Education",
"count": 9,
"top_subtypes": [
{
"count": 5,
"label": "School"
},
{
"count": 3,
"label": "Childcare"
},
{
"count": 1,
"label": "Preschool"
}
]
}
],
"terrain": {
"aspect_compass": "SE",
"avg_aspect_deg": 149,
"median_elevation_m": 26,
"median_slope_deg": 5.6,
"n_flat": 698,
"n_moderate": 830,
"n_properties": 1759,
"n_steep": 231,
"pct_steep": 13
},
"total_pois": 43
}
}