Now live: Australia 🇦🇺 and New Zealand 🇳🇿 Try it out

Guides
for everything Geocodio

Guides
Australian Census: Demographics

Australian Census: Demographics

The Australian Bureau of Statistics (ABS) publishes Census statistics for statistical areas, not for individual addresses. Geocodio finds the area that contains each Australian address and returns the ABS figures for that area. Three Census data appends are available:

  • Demographics (au-demographics): population by sex and age group, Aboriginal and/or Torres Strait Islander population, median age, and average household size

  • Housing (au-housing): home ownership and renting, median weekly rent, median monthly mortgage repayment, and persons per bedroom

  • Income and SEIFA (au-income): Census median incomes, Personal Income in Australia from tax data, and the four SEIFA indexes

This guide covers demographics.

Every figure describes an area. Geocodio doesn't return data about individual people or households.

How do I add Australian demographics to my addresses?

Via the API, add au-demographics to the fields parameter, for single addresses or batches. The response key is au_demographics. You can combine it with the other Census appends in one request, such as fields=au-demographics,au-housing,au-income. Each counts as its own lookup.

If you're uploading a spreadsheet, choose the demographics append in the data appends step of the upload process.

This append returns statistics only, not the area codes. To get the SA1, SA2, and other codes too, add au-census to the same request. It counts as its own lookup.

Which demographics does Geocodio return?

Table Rows ABS table
Total persons Total, Male, Female G01
Age groups 0 to 14, 15 to 24, 25 to 44, 45 to 64, and 65 years and over G01
Aboriginal and/or Torres Strait Islander population Total G01
Median age of persons Total G02
Average household size Total G02

Geocodio returns the categories exactly as the ABS publishes them, including the ABS's terms for Aboriginal and Torres Strait Islander peoples.

How is the response structured?

au_demographics starts with a meta object:

  • source: the publisher, "Australian Bureau of Statistics".

  • census_year: the year of the data, 2021.

  • geography: the area the values describe, sa1, sal, or poa.

  • geography_code: the ABS code for that area.

After meta come the tables, each keyed by its name. Every table has its own meta object with the ABS table_id and the universe (who or what the table counts), such as "Persons". The rows that follow are objects with a value and a percentage:

  • value is the count, median, or average the ABS published.

  • percentage is the row's share of the table's universe and appears only on rows that are counts.

  • Medians and averages have a value only, under Total.

The full response schema is in the API docs.

Which area does the data describe?

The statistics describe the area an address is in, not the address itself. Geocodio uses the most detailed area the match supports: the Statistical Area Level 1 (SA1) for street-level matches, or the suburb or postcode when the match is only that precise. The SA1 is the smallest area the ABS uses for detailed Census data. meta.geography names the level, and meta.geography_code gives the ABS code for that area. For street-level matches, it's the same SA1 that au-census returns.

How the address matched Area used meta.geography
Street level or better SA1 (usually 200 to 800 people) sa1
A suburb or locality Suburb and Locality (SAL), such as 20924 for Fitzroy VIC sal
A postcode with no suburb Postal Area (POA), whose code is the postcode, such as 3030 poa
A state Not returned (skipped with a warning)

A bare postcode query, such as 3030, returns one result for each suburb in the postcode. Each of those results reads the Postal Area for the whole postcode, not its own suburb, because the query didn't name a suburb.

An SA1 figure describes a few streets. A postcode figure can describe tens of thousands of people. If your list mixes match levels, group or filter on meta.geography before you compare areas. For more on what each level means, see Australian Census Geographies.

Which year is the data from?

Demographics come from the 2021 Census. au-demographics has no year option and always returns the newest data Geocodio has loaded. au-demographics2021 isn't a valid field: Geocodio skips it and adds a warning. meta.census_year names the year, so check it if your analysis has to stay on one year.

Why don't the rows add up?

The ABS makes small random changes to its counts to protect privacy, so rows can add up to a little more or less than their total, especially in small areas. Here is the au_demographics result for 1 Martin Place, Sydney NSW 2000, cut down to its "Total persons" table:

{
  "results": [
    {
      "formatted_address": "1 Martin Pl, Sydney NSW 2000",
      "accuracy_type": "rooftop",
      "fields": {
        "au_demographics": {
          "meta": {
            "source": "Australian Bureau of Statistics",
            "census_year": 2021,
            "geography": "sa1",
            "geography_code": "11703164412"
          },
          "Total persons": {
            "meta": {
              "table_id": "G01",
              "universe": "Persons"
            },
            "Total": {
              "value": 223
            },
            "Male": {
              "value": 118,
              "percentage": 0.529
            },
            "Female": {
              "value": 109,
              "percentage": 0.489
            }
          },
          ...
        }
      }
    }
  ]
}

Male (118) and Female (109) add up to 227, but the Total is 223. Use the Total row when you need the population, and treat small differences as expected.

Why is a value null?

When the ABS doesn't publish a median or an average, usually because the area has very few people or private dwellings, Geocodio returns null for it, never 0. Treat null as unknown. A 0 is a real count of zero, and the percentage of a 0 or unpublished total is null.

For example, the SA1 for 29-55 College Crescent, Parkville counts 1,765 people but no occupied private dwellings, so its average household size is null.

If the ABS publishes no data at all for an area, au_demographics is left out of the result, and _warnings explains why. You aren't charged for an append that's left out.

Cost

Australian geocoding and coordinate lookups cost 1 credit each. au-demographics adds 1 credit per address, so an Australian address with demographics costs 2 credits in total. If the append has no data for an address, it's left out and isn't billed.

Australia is available on all plans, including Pay-As-You-Go. See Country support.

A delightfully boring cookie banner

1 optional cookie from us
2 embeds blocked by default
0 ad tracking / data brokers

Geocodio would like to set one first-party cookie to remember how you found this site. Accepting also unblocks embedded videos and calendars, which set their own cookies.

Read the privacy policy