POIs / amenities in the suburb (pubs, cafes, gyms, schools, …)
/v1/suburbs/{suburb_name}/lifestyle/pois25¢ per callEvery named venue / amenity in the suburb as GeoJSON Point features, plus a per-category count.
Each point carries name, a broad category (Restaurant / Cafe, Shopping,
Health, Entertainment, Sport & Fitness, Education, …) and a finer subtype
(e.g. pub, bar, cafe, restaurant, gym, supermarket, school,
pharmacy). This is the endpoint for "what / how many subtype, and read real venue names from name. The top-level
categories array gives the broad-category counts without walking the list.
Unpaged by default. Big suburbs are big — Sydney is ~3.7 MB of features — so
pass limit/offset (or narrow with category) when you don't need them
all. count and categories always describe the whole suburb, so paging
never hides the totals. Flat price per call regardless of page size.
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: 25¢ 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
limitinteger1–∞optionalFeatures to return (default: all).
offsetinteger0–∞optionalFeature offset — page with `limit`.
categorystringoptionalOnly this display category (e.g. `Shopping`). Case-insensitive.
Responses
Successful Response
area_namestringalways returnedSuburb (SAL) name.
area_levelstringalways returnedAlways 'suburb' for these endpoints.
countintegeralways returnedPOIs available in the suburb (after any `category` filter), counted before `limit`/`offset`.
returnedintegeralways returnedFeatures actually in this response — equals `count` when unpaged.
categoriesarray of PoiCategoryCountalways returnedPer-category counts across the whole suburb, largest first.
poisobjectalways returnedGeoJSON FeatureCollection of POI points.
/v1/suburbs/{suburb_name}/lifestyle/poiscurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/lifestyle/pois' \
--header 'Authorization: Bearer test'{
"data": {
"area_level": "suburb",
"area_name": "Belmont North",
"categories": [
{
"category": "Shopping",
"count": 32
},
{
"category": "Sport & Fitness",
"count": 26
}
],
"count": 177,
"pois": {
"features": [
{
"geometry": {
"coordinates": [
151.66231,
-33.02463
],
"type": "Point"
},
"properties": {
"name": "Ampol Foodary",
"category": "Shopping",
"subtype": "newsagent",
"dim": "convenience"
},
"type": "Feature"
}
],
"type": "FeatureCollection"
}
}
}