Microburbs
Microburbs API
Free sandbox: try any request below on the sample suburbs, no signup. For every suburb, create an API key.
Classic docs
Microburbs Property Data API
Suburb - Amenities

Shopping and retail

GET/v1/suburbs/{suburb_name}/amenities/shopping5¢ per call

Supermarkets, convenience stores, fresh food shops, newsagents, hardware and clothing stores: counts in the suburb, rates per 1,000 residents and distance from the suburb centre to the nearest of each.

Coverage: All Australian suburbs and localities. Current to 2026-10-01. Full description, field list and method: /v1/datasets/shopping.

Exact suburb identifier required. Exact official suburb name (SAL), 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.

Authorization

Request

The only values you send. Fields under Responses below are what comes back — you never pass those.

Path parameters

suburb_namestringrequired

Exact official suburb name (SAL), 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

fieldsstringoptional

Comma-separated subset of: count_supermarkets, per_1000_supermarkets, nearest_km_supermarkets, count_convenience_stores, per_1000_convenience_stores, nearest_km_convenience_stores, count_fresh_food, per_1000_fresh_food, nearest_km_fresh_food, count_newsagents, per_1000_newsagents, nearest_km_newsagents, count_hardware_stores, per_1000_hardware_stores, nearest_km_hardware_stores, count_clothing_stores, per_1000_clothing_stores, nearest_km_clothing_stores, count_total, per_1000_total, per_km2_total. Omit for all.

fromstringoptional

First period to include: 2020, 2020-Q3, 2020-07 or 2020-07-01.

tostringoptional

Last period to include, same formats as `from`.

Responses

Successful Response

application/json
DatasetValuesfields returned to you
datasetstringalways returned

Dataset slug; describe it with /v1/datasets/{slug}.

levelstringalways returned

suburb, lga or block.

areastringalways returned

Canonical name (or mesh-block code) of the area answered.

period_typestringalways returned

snapshot, year, financial_year, quarter or month.

as_ofstring · datealways returned

Date the dataset is current to. Values are never withheld for age; check this instead.

modelledbooleanalways returned

True when the figures are estimates from a model rather than counts or measurements.

fieldsarray of DatasetFieldSeriesalways returned
GET/v1/suburbs/{suburb_name}/amenities/shopping
cURL
curl --request GET \
  --url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/amenities/shopping' \
  --header 'Authorization: Bearer test'
Example Responses
{
  "data": {
    "dataset": "shopping",
    "level": "suburb",
    "area": "Unley",
    "period_type": "snapshot",
    "as_of": "2026-10-01",
    "modelled": false,
    "fields": [
      {
        "field": "count_supermarkets",
        "name": "Supermarkets: count",
        "unit": "count",
        "values": [
          {
            "period": "2026-10-01",
            "period_start": "2026-10-01",
            "value": 2
          }
        ]
      },
      {
        "field": "per_1000_supermarkets",
        "name": "Supermarkets: per 1,000 residents",
        "unit": "per 1,000",
        "values": [
          {
            "period": "2026-10-01",
            "period_start": "2026-10-01",
            "value": 0.5
          }
        ]
      },
      {
        "field": "nearest_km_supermarkets",
        "name": "Supermarkets: nearest",
        "unit": "km",
        "values": [
          {
            "period": "2026-10-01",
            "period_start": "2026-10-01",
            "value": 0.442
          }
        ]
      }
    ]
  }
}
Successful Response200
application/json

About this dataset

All Australian suburbs and localities. Current to 2026-10-01; refreshed quarterly.

What it is

Supermarkets, convenience stores, fresh food shops, newsagents, hardware and clothing stores, summarised for every suburb in one call.

What it shows

For each category: the number inside the suburb boundary, the number per 1,000 residents, and the distance in kilometres from the suburb centre to the nearest one. Plus a total count, a total per 1,000 residents and a total per square kilometre for the whole group.

Why use it

Daily-needs retail drives liveability and is a core buyer question: can I do the weekly shop locally? Distance to the nearest supermarket flags convenience gaps that a suburb count alone hides.

How it is built

We combine open map data with a second places database, drop duplicates, closed and unnamed places, and place each one in its suburb by location. Rates use the suburb's latest resident count and are left blank under 200 residents. Distances are straight-line from the suburb's central point, not walking or driving distance, and are blank beyond 50 km. Counts reflect what is mapped, so very small or remote suburbs can be under-counted.

Fields

FieldUnitDescription
count_supermarkets
Supermarkets: count
countNumber of supermarkets inside the suburb boundary.
per_1000_supermarkets
Supermarkets: per 1,000 residents
per 1,000Supermarkets per 1,000 residents. Left blank for suburbs with fewer than 200 residents.
nearest_km_supermarkets
Supermarkets: nearest
kmStraight-line distance from the suburb centre to the nearest of these, in kilometres; blank when none is within 50 km.
count_convenience_stores
Convenience stores: count
countNumber of convenience stores inside the suburb boundary.
per_1000_convenience_stores
Convenience stores: per 1,000 residents
per 1,000Convenience stores per 1,000 residents. Left blank for suburbs with fewer than 200 residents.
nearest_km_convenience_stores
Convenience stores: nearest
kmStraight-line distance from the suburb centre to the nearest of these, in kilometres; blank when none is within 50 km.
count_fresh_food
Greengrocers, butchers and delis: count
countNumber of greengrocers, butchers and delis inside the suburb boundary.
per_1000_fresh_food
Greengrocers, butchers and delis: per 1,000 residents
per 1,000Greengrocers, butchers and delis per 1,000 residents. Left blank for suburbs with fewer than 200 residents.
nearest_km_fresh_food
Greengrocers, butchers and delis: nearest
kmStraight-line distance from the suburb centre to the nearest of these, in kilometres; blank when none is within 50 km.
count_newsagents
Newsagents: count
countNumber of newsagents inside the suburb boundary.
per_1000_newsagents
Newsagents: per 1,000 residents
per 1,000Newsagents per 1,000 residents. Left blank for suburbs with fewer than 200 residents.
nearest_km_newsagents
Newsagents: nearest
kmStraight-line distance from the suburb centre to the nearest of these, in kilometres; blank when none is within 50 km.
count_hardware_stores
Hardware stores: count
countNumber of hardware stores inside the suburb boundary.
per_1000_hardware_stores
Hardware stores: per 1,000 residents
per 1,000Hardware stores per 1,000 residents. Left blank for suburbs with fewer than 200 residents.
nearest_km_hardware_stores
Hardware stores: nearest
kmStraight-line distance from the suburb centre to the nearest of these, in kilometres; blank when none is within 50 km.
count_clothing_stores
Clothing stores: count
countNumber of clothing stores inside the suburb boundary.
per_1000_clothing_stores
Clothing stores: per 1,000 residents
per 1,000Clothing stores per 1,000 residents. Left blank for suburbs with fewer than 200 residents.
nearest_km_clothing_stores
Clothing stores: nearest
kmStraight-line distance from the suburb centre to the nearest of these, in kilometres; blank when none is within 50 km.
count_total
All shopping and retail: count
countTotal of all categories in this group inside the suburb.
per_1000_total
All shopping and retail: per 1,000 residents
per 1,000Total per 1,000 residents; blank for suburbs with fewer than 200 residents.
per_km2_total
All shopping and retail: per km2
per km2Total per square kilometre of suburb area.