Crime — suburb vs national benchmark
/v1/suburbs/{suburb_name}/crime/summary10¢ per callSuburb and national total-crime medians (predicted incidents per 100,000 residents per year) with a vs-national verdict.
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.
unitstringalways returnedUnit of suburb_median and national_median — always 'predicted incidents per 100,000 residents per year'.
suburb_mediannumberalways returnedMedian total crime rate across this suburb's mesh blocks — predicted incidents per 100,000 residents per year (model trained on QLD Police 2020-2022 incident averages, predicted for all Australian mesh blocks).
national_mediannumberalways returnedMedian total crime rate across all Australian mesh blocks, same unit as suburb_median.
vs_national_pctintegeralways returnedSuburb median vs national median, as a rounded percentage delta (negative = less crime than the national median).
verdictstringalways returnedPlain-English band for the delta: 'Very low', 'Below average', 'Average', 'Above average' or 'High'.
/v1/suburbs/{suburb_name}/crime/summarycurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/crime/summary' \
--header 'Authorization: Bearer test'{
"data": {
"area_level": "suburb",
"area_name": "Belmont North",
"national_median": 2787.6,
"suburb_median": 2248,
"unit": "predicted incidents per 100,000 residents per year",
"verdict": "Below average",
"vs_national_pct": -19
}
}