Microburbs
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
Property - Context

Signals by mesh block — recent price growth and turnover within 1 km (by gnaf_id) (beta)

GET/v1/properties/{gnaf_id}/mesh-blocks/signals20¢ per call

Beta. The figures behind this topic have not been validated against an independent source, so it is not sold at the same confidence as the other mesh-block topics. Every response says beta: true and carries a beta_notice.

Is this block moving? For every mesh block around the property: recent price growth on the block against its suburb, long-run house value growth, and the share of properties recently listed for rent.

One entry per mesh block within 1,000 m of the property under mesh_blocks, nearest first, each with its mb_code, distance_m, population and dwellings. Blocks across suburb lines are included. Values only — the polygons come from /properties/{gnaf_id}/context/mesh-blocks.

Every field carries provenance — measured (at this block), measured_wider_area (measured for the SA1 or postcode and repeated on every block in it), estimate (our model) or not_recorded (not labelled yet) — plus how, one sentence on how the number was arrived at (empty when not_recorded).

About this data ↓

Authorization

Request

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

Path parameters

gnaf_idstringrequired

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
PropertyMbTopicfields returned to you
gnaf_idstringalways returned

The property, as given.

suburbstringmay be null

The property's suburb (SAL). Blocks across suburb lines are included.

statestringmay be null

State / Territory abbreviation of the property.

radius_mintegeralways returned

Radius around the property, in metres (1,000).

topicstringalways returned

Which topic this answers.

questionstringalways returned

The question this topic answers.

betabooleanalways returned

`true` when the figures behind this topic have not been validated against an independent source yet.

beta_noticestringmay be null

What is unvalidated, on beta topics only.

block_countintegeralways returned

How many mesh blocks are in `mesh_blocks`.

mesh_blocksarray of PropertyMbTopicBlockalways returned

One entry per mesh block within `radius_m`, nearest first.

notestringalways returned

How to read `provenance`.

About this data

What this is

Market signals around one address, block by block (beta): recent price growth on each mesh block within 1 km against its suburb, long-run house value growth, and the share of properties recently listed for rent.

What people use it for

  • Investors: spot blocks moving faster or slower than the suburb they sit in.
  • Buyers' agents: a quick read on whether the streets around a home are in demand.
  • Analysts: a block-level input to growth and turnover models.

Coverage

Mesh blocks nationwide (about 368,000). The 1 km radius crosses suburb lines. A field is null where we hold nothing for that block.

Tips

This topic is beta and its fields carry no recorded provenance yet, so treat the numbers as indicative. For suburb-level growth use /v1/suburbs/{suburb_name}/market/price-growth. Check provenance before quoting a field. Whole suburb: /v1/suburbs/{suburb_name}/mesh-blocks/signals. Polygons: /v1/properties/{gnaf_id}/context/mesh-blocks, joined on mb_code.

GET/v1/properties/{gnaf_id}/mesh-blocks/signals
cURL
curl --request GET \
  --url 'https://api.microburbs.com.au/v1/properties/GANSW704074813/mesh-blocks/signals' \
  --header 'Authorization: Bearer test'
Example Responses
{
  "data": {
    "gnaf_id": "GANSW704074813",
    "suburb": "Belmont North",
    "state": "NSW",
    "radius_m": 1000,
    "topic": "signals",
    "question": "Is this block moving?",
    "beta": true,
    "beta_notice": "Beta: this topic has not been validated against an independent source yet. Check each field's provenance before presenting a figure as a measurement.",
    "block_count": 102,
    "mesh_blocks": [
      {
        "mb_code": "10434270000",
        "population": 124,
        "dwellings": 46,
        "fields": {
          "price_growth_1y_pct": {
            "value": 18.29,
            "unit": "%",
            "label": "Price growth over the last year",
            "provenance": "not_recorded",
            "how": ""
          },
          "price_growth_3y_annual_pct": {
            "value": 10.57,
            "unit": "% a year",
            "label": "Price growth a year, averaged over three years",
            "provenance": "not_recorded",
            "how": ""
          },
          "suburb_price_growth_1y_pct": {
            "value": 19.29,
            "unit": "%",
            "label": "The suburb's price growth over the last year, for comparison",
            "provenance": "not_recorded",
            "how": ""
          },
          "house_value_growth_5y_annual_pct": {
            "value": 2.54,
            "unit": "% a year",
            "label": "House value growth a year over five years",
            "provenance": "not_recorded",
            "how": ""
          },
          "house_value_growth_10y_annual_pct": {
            "value": 6.34,
            "unit": "% a year",
            "label": "House value growth a year over ten years",
            "provenance": "not_recorded",
            "how": ""
          },
          "recently_rented_pct": {
            "value": 7.5,
            "unit": "% of properties",
            "label": "Properties on this block listed for rent recently",
            "provenance": "not_recorded",
            "how": ""
          }
        },
        "distance_m": 0
      },
      {
        "mb_code": "10434330000",
        "population": 89,
        "dwellings": 32,
        "fields": {
          "price_growth_1y_pct": {
            "value": 18.61,
            "unit": "%",
            "label": "Price growth over the last year",
            "provenance": "not_recorded",
            "how": ""
          },
          "price_growth_3y_annual_pct": {
            "value": 10.24,
            "unit": "% a year",
            "label": "Price growth a year, averaged over three years",
            "provenance": "not_recorded",
            "how": ""
          },
          "suburb_price_growth_1y_pct": {
            "value": 19.29,
            "unit": "%",
            "label": "The suburb's price growth over the last year, for comparison",
            "provenance": "not_recorded",
            "how": ""
          },
          "house_value_growth_5y_annual_pct": {
            "value": 2.54,
            "unit": "% a year",
            "label": "House value growth a year over five years",
            "provenance": "not_recorded",
            "how": ""
          },
          "house_value_growth_10y_annual_pct": {
            "value": 6.34,
            "unit": "% a year",
            "label": "House value growth a year over ten years",
            "provenance": "not_recorded",
            "how": ""
          },
          "recently_rented_pct": {
            "value": 11.11,
            "unit": "% of properties",
            "label": "Properties on this block listed for rent recently",
            "provenance": "not_recorded",
            "how": ""
          }
        },
        "distance_m": 15
      },
      {
        "mb_code": "10434440000",
        "population": 99,
        "dwellings": 34,
        "fields": {
          "price_growth_1y_pct": {
            "value": 15.43,
            "unit": "%",
            "label": "Price growth over the last year",
            "provenance": "not_recorded",
            "how": ""
          },
          "price_growth_3y_annual_pct": {
            "value": 10.71,
            "unit": "% a year",
            "label": "Price growth a year, averaged over three years",
            "provenance": "not_recorded",
            "how": ""
          },
          "suburb_price_growth_1y_pct": {
            "value": 19.29,
            "unit": "%",
            "label": "The suburb's price growth over the last year, for comparison",
            "provenance": "not_recorded",
            "how": ""
          },
          "house_value_growth_5y_annual_pct": {
            "value": 2.54,
            "unit": "% a year",
            "label": "House value growth a year over five years",
            "provenance": "not_recorded",
            "how": ""
          },
          "house_value_growth_10y_annual_pct": {
            "value": 6.34,
            "unit": "% a year",
            "label": "House value growth a year over ten years",
            "provenance": "not_recorded",
            "how": ""
          },
          "recently_rented_pct": {
            "value": 5.13,
            "unit": "% of properties",
            "label": "Properties on this block listed for rent recently",
            "provenance": "not_recorded",
            "how": ""
          }
        },
        "distance_m": 56
      }
    ],
    "note": "Each field says how its number was arrived at. An estimate is not a measurement, and a figure measured for a wider area is not a measurement of the block."
  }
}
Successful Response200
application/json