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

Microburbs Property Data API

Suburb - Environment

Climate normals

GET/v1/suburbs/{suburb_name}/environment/climate-normals5¢ per call

Average (2004-2020) climate for every suburb: daytime highs and overnight lows (annual, hottest and coldest month, every month), rainfall (annual, seasonal, monthly) and rain days, sunshine energy and afternoon humidity. Modelled estimates.

Coverage: About 15,300 suburbs and localities with a 5 km land grid cell within about 10 km of the suburb point; averaging period 2004-2020 (solar and humidity 2006-2020). Current to 2020-12-31. Full description, field list and method: /v1/datasets/climate-normals.

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: temp_max_annual_c, temp_min_annual_c, temp_mean_annual_c, temp_max_hottest_month_c, temp_min_coldest_month_c, diurnal_range_c, rain_annual_mm, rain_days_annual, rain_wettest_month_mm, rain_driest_month_mm, rain_summer_mm, rain_autumn_mm, rain_winter_mm, rain_spring_mm, solar_exposure_mj_m2_day, solar_exposure_summer_mj_m2_day, solar_exposure_winter_mj_m2_day, humidity_afternoon_pct, humidity_afternoon_summer_pct, humidity_afternoon_winter_pct, temp_max_jan_c, temp_max_feb_c, temp_max_mar_c, temp_max_apr_c, temp_max_may_c, temp_max_jun_c, temp_max_jul_c, temp_max_aug_c, temp_max_sep_c, temp_max_oct_c, temp_max_nov_c, temp_max_dec_c, temp_min_jan_c, temp_min_feb_c, temp_min_mar_c, temp_min_apr_c, temp_min_may_c, temp_min_jun_c, temp_min_jul_c, temp_min_aug_c, temp_min_sep_c, temp_min_oct_c, temp_min_nov_c, temp_min_dec_c, rain_jan_mm, rain_feb_mm, rain_mar_mm, rain_apr_mm, rain_may_mm, rain_jun_mm, rain_jul_mm, rain_aug_mm, rain_sep_mm, rain_oct_mm, rain_nov_mm, rain_dec_mm. 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}/environment/climate-normals

cURL

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

Example Responses

Show schema

{
  "data": {
    "dataset": "climate-normals",
    "level": "suburb",
    "area": "Bondi",
    "period_type": "snapshot",
    "as_of": "2020-12-31",
    "modelled": true,
    "fields": [
      {
        "field": "temp_max_annual_c",
        "name": "Average daytime high",
        "unit": "°C",
        "values": [
          {
            "period": "2020-12-31",
            "period_start": "2020-12-31",
            "value": 22.53359
          }
        ]
      },
      {
        "field": "temp_min_annual_c",
        "name": "Average overnight low",
        "unit": "°C",
        "values": [
          {
            "period": "2020-12-31",
            "period_start": "2020-12-31",
            "value": 14.66583
          }
        ]
      },
      {
        "field": "temp_mean_annual_c",
        "name": "Average temperature",
        "unit": "°C",
        "values": [
          {
            "period": "2020-12-31",
            "period_start": "2020-12-31",
            "value": 18.59971
          }
        ]
      }
    ]
  }
}

Successful Response200

application/json

About this dataset

About 15,300 suburbs and localities with a 5 km land grid cell within about 10 km of the suburb point; averaging period 2004-2020 (solar and humidity 2006-2020). Current to 2020-12-31; refreshed yearly. These figures are modelled estimates.

What it is

A climate profile for each suburb, built from 17 years (2004 to 2020) of daily weather. It tells you what a typical year feels like there: how hot summer days get, how cold winter nights get, how much rain falls and when, how sunny it is and how humid the afternoons are.

What it shows

Average daily high and low temperature for the year, for the hottest and coldest month, and for each of the 12 months; the daily temperature range; annual rainfall, rain days (1 mm or more), the wettest and driest month, rainfall by season and for each month; solar energy per day for the year, summer and winter; and afternoon humidity for the year, summer and winter.

Why use it

Climate is a long-run property of a place that shapes energy bills, solar panel yield, air-conditioning and heating needs, garden and lifestyle choices, and which suburbs feel humid, dry, wet or frosty. Use it to compare suburbs in different cities, to explain a relocation (for example Melbourne to Brisbane), to size a solar or insulation offer, or to add a climate panel to a property report. Monthly fields let an app draw a climate chart.

How it is built

We take the national 5 km grid of daily weather, average each day into monthly values for every year from 2004 to 2020 (temperatures and rainfall) and then across the years. This is a 17-year average, shorter than the 30-year standard period, so a very wet or dry run of years can move rainfall figures by a few percent. Each suburb is given the value of the 5 km grid cell at a point inside its boundary, so neighbouring small suburbs can share a value and hilly or coastal suburbs can differ from the nearest weather station by a degree or more. Where that cell is open water, the nearest land cell within about 10 km is used. Solar energy and humidity average the 15 years 2006 to 2020. Afternoon humidity is the relative humidity at the time of each day's highest temperature. Rain days count days with 1 mm or more. Values are interpolated from weather-station records, not measured at the suburb.

Fields

Field	Unit	Description
`temp_max_annual_c` Average daytime high	°C	Average of the daily highest temperature over the year.
`temp_min_annual_c` Average overnight low	°C	Average of the daily lowest temperature over the year.
`temp_mean_annual_c` Average temperature	°C	Midpoint of the average daytime high and overnight low.
`temp_max_hottest_month_c` Average high in the hottest month	°C	Average daily high in the suburb's hottest month (usually January or February).
`temp_min_coldest_month_c` Average low in the coldest month	°C	Average daily low in the suburb's coldest month (usually July).
`diurnal_range_c` Daily temperature range	°C	Average daytime high minus average overnight low.
`rain_annual_mm` Annual rainfall	mm	Average total rainfall in a year.
`rain_days_annual` Rain days per year	days	Average number of days a year with 1 mm or more of rain.
`rain_wettest_month_mm` Rainfall in the wettest month	mm	Average rainfall in the suburb's wettest calendar month.
`rain_driest_month_mm` Rainfall in the driest month	mm	Average rainfall in the suburb's driest calendar month.
`rain_summer_mm` Summer rainfall	mm	Average rainfall over the three summer months (Dec-Feb).
`rain_autumn_mm` Autumn rainfall	mm	Average rainfall over the three autumn months (Mar-May).
`rain_winter_mm` Winter rainfall	mm	Average rainfall over the three winter months (Jun-Aug).
`rain_spring_mm` Spring rainfall	mm	Average rainfall over the three spring months (Sep-Nov).
`solar_exposure_mj_m2_day` Daily sun energy	MJ/m²/day	Average solar energy reaching the ground per day, a measure of sunniness; useful for solar panel output and heating.
`solar_exposure_summer_mj_m2_day` Daily sun energy in summer	MJ/m²/day	Average daily solar energy over December to February.
`solar_exposure_winter_mj_m2_day` Daily sun energy in winter	MJ/m²/day	Average daily solar energy over June to August.
`humidity_afternoon_pct` Afternoon humidity	%	Average relative humidity at the time of the day's highest temperature (mid-afternoon).
`humidity_afternoon_summer_pct` Afternoon humidity in summer	%	Afternoon relative humidity averaged over December to February.
`humidity_afternoon_winter_pct` Afternoon humidity in winter	%	Afternoon relative humidity averaged over June to August.
`temp_max_jan_c` Average high in January	°C	Average daily highest temperature in January.
`temp_max_feb_c` Average high in February	°C	Average daily highest temperature in February.
`temp_max_mar_c` Average high in March	°C	Average daily highest temperature in March.
`temp_max_apr_c` Average high in April	°C	Average daily highest temperature in April.
`temp_max_may_c` Average high in May	°C	Average daily highest temperature in May.
`temp_max_jun_c` Average high in June	°C	Average daily highest temperature in June.
`temp_max_jul_c` Average high in July	°C	Average daily highest temperature in July.
`temp_max_aug_c` Average high in August	°C	Average daily highest temperature in August.
`temp_max_sep_c` Average high in September	°C	Average daily highest temperature in September.
`temp_max_oct_c` Average high in October	°C	Average daily highest temperature in October.
`temp_max_nov_c` Average high in November	°C	Average daily highest temperature in November.
`temp_max_dec_c` Average high in December	°C	Average daily highest temperature in December.
`temp_min_jan_c` Average low in January	°C	Average daily lowest temperature in January.
`temp_min_feb_c` Average low in February	°C	Average daily lowest temperature in February.
`temp_min_mar_c` Average low in March	°C	Average daily lowest temperature in March.
`temp_min_apr_c` Average low in April	°C	Average daily lowest temperature in April.
`temp_min_may_c` Average low in May	°C	Average daily lowest temperature in May.
`temp_min_jun_c` Average low in June	°C	Average daily lowest temperature in June.
`temp_min_jul_c` Average low in July	°C	Average daily lowest temperature in July.
`temp_min_aug_c` Average low in August	°C	Average daily lowest temperature in August.
`temp_min_sep_c` Average low in September	°C	Average daily lowest temperature in September.
`temp_min_oct_c` Average low in October	°C	Average daily lowest temperature in October.
`temp_min_nov_c` Average low in November	°C	Average daily lowest temperature in November.
`temp_min_dec_c` Average low in December	°C	Average daily lowest temperature in December.
`rain_jan_mm` January rainfall	mm	Average total rainfall in January.
`rain_feb_mm` February rainfall	mm	Average total rainfall in February.
`rain_mar_mm` March rainfall	mm	Average total rainfall in March.
`rain_apr_mm` April rainfall	mm	Average total rainfall in April.
`rain_may_mm` May rainfall	mm	Average total rainfall in May.
`rain_jun_mm` June rainfall	mm	Average total rainfall in June.
`rain_jul_mm` July rainfall	mm	Average total rainfall in July.
`rain_aug_mm` August rainfall	mm	Average total rainfall in August.
`rain_sep_mm` September rainfall	mm	Average total rainfall in September.
`rain_oct_mm` October rainfall	mm	Average total rainfall in October.
`rain_nov_mm` November rainfall	mm	Average total rainfall in November.
`rain_dec_mm` December rainfall	mm	Average total rainfall in December.