Suburb - Lifestyle

POIs / amenities in the suburb (pubs, cafes, gyms, schools, …)

GET/v1/suburbs/{suburb_name}/lifestyle/pois25¢ per call

Every named venue / amenity in the suburb as GeoJSON Point features, plus a per-category count.

Each point carries name, a broad category (Restaurant / Cafe, Shopping, Health, Entertainment, Sport & Fitness, Education, …) and a finer subtype (e.g. pub, bar, cafe, restaurant, gym, supermarket, school, pharmacy). This is the endpoint for "what / how many are in this suburb" and "name the pubs / cafes / gyms in X" — filter or count the features on subtype, and read real venue names from name. The top-level categories array gives the broad-category counts without walking the list.

Price: 25¢ per call.

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

Query parameters

None — this endpoint accepts no query parameters. Call the path above with your bearer token and nothing else.

Responses

Successful Response

application/json

LifestylePoisfields returned to you

area_namestringalways returned

Suburb (SAL) name.

area_levelstringalways returned

Always 'suburb' for these endpoints.

countintegeralways returned

Total POI features returned.

categoriesarray of PoiCategoryCountalways returned

Per-category counts, largest first.

poisobjectalways returned

GeoJSON FeatureCollection of POI points.

GET/v1/suburbs/{suburb_name}/lifestyle/pois

cURL

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

Example Responses

Show schema

{
  "data": {
    "area_level": "suburb",
    "area_name": "Belmont North",
    "categories": [
      {
        "category": "Shopping",
        "count": 32
      },
      {
        "category": "Sport & Fitness",
        "count": 26
      }
    ],
    "count": 177,
    "pois": {
      "features": [
        {
          "geometry": {
            "coordinates": [
              151.66231,
              -33.02463
            ],
            "type": "Point"
          },
          "properties": {
            "name": "Ampol Foodary",
            "category": "Shopping",
            "subtype": "newsagent",
            "dim": "convenience"
          },
          "type": "Feature"
        }
      ],
      "type": "FeatureCollection"
    }
  }
}

Successful Response200

application/json