Free sandbox: try any request below on the sample suburbs, no signup. For every suburb, create an API key.

Microburbs Property Data API

Suburb - Amenities

Food and drink places

GET/v1/suburbs/{suburb_name}/amenities/food-and-drink5¢ per call

Cafes, restaurants, takeaway, bakeries, pubs and bars, bottle shops and breweries or wineries: 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/food-and-drink.

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

Bearer tokentest

Sandbox key test works for the allowlisted GNAF + SAL — no signup.

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_takeaway, per_1000_takeaway, nearest_km_takeaway, count_cafes, per_1000_cafes, nearest_km_cafes, count_restaurants, per_1000_restaurants, nearest_km_restaurants, count_bakeries, per_1000_bakeries, nearest_km_bakeries, count_pubs_bars, per_1000_pubs_bars, nearest_km_pubs_bars, count_bottle_shops, per_1000_bottle_shops, nearest_km_bottle_shops, count_breweries_wineries, per_1000_breweries_wineries, nearest_km_breweries_wineries, 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/food-and-drink

cURL

curl --request GET \
  --url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/amenities/food-and-drink' \
  --header 'Authorization: Bearer test'

Example Responses

Show schema

{
  "data": {
    "dataset": "food-and-drink",
    "level": "suburb",
    "area": "Fortitude Valley",
    "period_type": "snapshot",
    "as_of": "2026-10-01",
    "modelled": false,
    "fields": [
      {
        "field": "count_takeaway",
        "name": "Takeaway and fast food: count",
        "unit": "count",
        "values": [
          {
            "period": "2026-10-01",
            "period_start": "2026-10-01",
            "value": 49
          }
        ]
      },
      {
        "field": "per_1000_takeaway",
        "name": "Takeaway and fast food: per 1,000 residents",
        "unit": "per 1,000",
        "values": [
          {
            "period": "2026-10-01",
            "period_start": "2026-10-01",
            "value": 5.054673
          }
        ]
      },
      {
        "field": "nearest_km_takeaway",
        "name": "Takeaway and fast food: nearest",
        "unit": "km",
        "values": [
          {
            "period": "2026-10-01",
            "period_start": "2026-10-01",
            "value": 0.128
          }
        ]
      }
    ]
  }
}

Successful Response200

application/json

About this dataset

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

What it is

Cafes, restaurants, takeaway, bakeries, pubs and bars, bottle shops and breweries or wineries, 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

Hospitality is the clearest sign of a suburb's street life. A strip of cafes and restaurants lifts foot traffic, rents and buyer interest; a suburb with none is a commuter dormitory. Per-resident rates separate a genuinely busy dining precinct from a large suburb that merely has a lot of people.

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

Field	Unit	Description
`count_takeaway` Takeaway and fast food: count	count	Number of takeaway and fast food inside the suburb boundary.
`per_1000_takeaway` Takeaway and fast food: per 1,000 residents	per 1,000	Takeaway and fast food per 1,000 residents. Left blank for suburbs with fewer than 200 residents.
`nearest_km_takeaway` Takeaway and fast food: nearest	km	Straight-line distance from the suburb centre to the nearest of these, in kilometres; blank when none is within 50 km.
`count_cafes` Cafes: count	count	Number of cafes inside the suburb boundary.
`per_1000_cafes` Cafes: per 1,000 residents	per 1,000	Cafes per 1,000 residents. Left blank for suburbs with fewer than 200 residents.
`nearest_km_cafes` Cafes: nearest	km	Straight-line distance from the suburb centre to the nearest of these, in kilometres; blank when none is within 50 km.
`count_restaurants` Restaurants: count	count	Number of restaurants inside the suburb boundary.
`per_1000_restaurants` Restaurants: per 1,000 residents	per 1,000	Restaurants per 1,000 residents. Left blank for suburbs with fewer than 200 residents.
`nearest_km_restaurants` Restaurants: nearest	km	Straight-line distance from the suburb centre to the nearest of these, in kilometres; blank when none is within 50 km.
`count_bakeries` Bakeries: count	count	Number of bakeries inside the suburb boundary.
`per_1000_bakeries` Bakeries: per 1,000 residents	per 1,000	Bakeries per 1,000 residents. Left blank for suburbs with fewer than 200 residents.
`nearest_km_bakeries` Bakeries: nearest	km	Straight-line distance from the suburb centre to the nearest of these, in kilometres; blank when none is within 50 km.
`count_pubs_bars` Pubs and bars: count	count	Number of pubs and bars inside the suburb boundary.
`per_1000_pubs_bars` Pubs and bars: per 1,000 residents	per 1,000	Pubs and bars per 1,000 residents. Left blank for suburbs with fewer than 200 residents.
`nearest_km_pubs_bars` Pubs and bars: nearest	km	Straight-line distance from the suburb centre to the nearest of these, in kilometres; blank when none is within 50 km.
`count_bottle_shops` Bottle shops: count	count	Number of bottle shops inside the suburb boundary.
`per_1000_bottle_shops` Bottle shops: per 1,000 residents	per 1,000	Bottle shops per 1,000 residents. Left blank for suburbs with fewer than 200 residents.
`nearest_km_bottle_shops` Bottle shops: nearest	km	Straight-line distance from the suburb centre to the nearest of these, in kilometres; blank when none is within 50 km.
`count_breweries_wineries` Breweries and wineries: count	count	Number of breweries and wineries inside the suburb boundary.
`per_1000_breweries_wineries` Breweries and wineries: per 1,000 residents	per 1,000	Breweries and wineries per 1,000 residents. Left blank for suburbs with fewer than 200 residents.
`nearest_km_breweries_wineries` Breweries and wineries: nearest	km	Straight-line distance from the suburb centre to the nearest of these, in kilometres; blank when none is within 50 km.
`count_total` All food and drink places: count	count	Total of all categories in this group inside the suburb.
`per_1000_total` All food and drink places: per 1,000 residents	per 1,000	Total per 1,000 residents; blank for suburbs with fewer than 200 residents.
`per_km2_total` All food and drink places: per km2	per km2	Total per square kilometre of suburb area.