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.
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_namestringrequiredQuery 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
}
}