Search suburbs
/v1/suburbs/finder/search30¢ per callBoolean-AND range filter over suburb metrics, single-column sort,
paginated. Every row carries its rank — position in the ranked result
(1 = top of the sort, out of meta.total). When sorting by a median or a
growth, the actual value is also shown for the first 5 and last 5 rows of
the page; for any other suburb's number, call the per-field endpoint
(market/, forecast/). Flat 30c.
Price: 30¢ per call.
Authorization
Request
The only values you send. Fields under Responses below are what comes back — you never pass those.
Query parameters
filteroptionalrange filters — add one or more; all must matchLeave min or max blank for an open-ended range. Each row is one criterion; all must match.
statesstringoptionalComma-separated states (names or abbreviations), e.g. `VIC`.
regionsstringoptionalComma-separated EXACT SA4 region names — call GET /v1/suburbs/finder/regions for the list. e.g. `Melbourne - Inner`, `Melbourne - West`. A metro name like `Melbourne` alone will NOT match.
property_typestringoptional'house' or 'unit'.
sortoptionalrank the results by a fieldlimitintegeroptionalPage size (clamped to 25).
offsetintegeroptionalRow offset.
Responses
Successful Response
suburbsarray of FinderRowalways returnedMatched suburbs, sorted.
metaobjectalways returnedPagination + total + the value-reveal policy for a search.
/v1/suburbs/finder/searchcurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/finder/search' \
--header 'Authorization: Bearer test'{
"data": {
"meta": {
"limit": 25,
"offset": 0,
"returned": 25,
"total": 126
},
"suburbs": [
{
"lga": "Lake Macquarie",
"rank": 3,
"sa4": "Newcastle and Lake Macquarie",
"state": "NSW",
"suburb": "Windale",
"value": 0.163
}
]
}
}