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

Microburbs Property Data API

Suburb - Area Statistics

Languages spoken at home

GET/v1/suburbs/{suburb_name}/area-stats/languages5¢ per call

Languages spoken at home: English only, 36 other languages from Mandarin to Nepali, and English proficiency, as counts and shares for every suburb and council area.

Coverage: About 11,000 suburbs and localities and 545 council areas across Australia, in all states and territories (areas with too few residents for reliable figures are left out); one snapshot at 10 August 2021. Current to 2021-08-10. Full description, field list and method: /v1/datasets/languages.

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: total_population, english_only_count, english_only_pct, other_language_any_count, other_language_any_pct, english_poor_count, english_poor_pct, not_stated_count, not_stated_pct, chinese_languages_count, chinese_languages_pct, mandarin_count, mandarin_pct, cantonese_count, cantonese_pct, arabic_count, arabic_pct, vietnamese_count, vietnamese_pct, punjabi_count, punjabi_pct, greek_count, greek_pct, italian_count, italian_pct, hindi_count, hindi_pct, spanish_count, spanish_pct, nepali_count, nepali_pct, tagalog_count, tagalog_pct, korean_count, korean_pct, urdu_count, urdu_pct, tamil_count, tamil_pct, filipino_count, filipino_pct, sinhalese_count, sinhalese_pct, gujarati_count, gujarati_pct, malayalam_count, malayalam_pct, australian_indigenous_languages_count, australian_indigenous_languages_pct, indonesian_count, indonesian_pct, persian_count, persian_pct, french_count, french_pct, german_count, german_pct, bengali_count, bengali_pct, portuguese_count, portuguese_pct, thai_count, thai_pct, macedonian_count, macedonian_pct, turkish_count, turkish_pct, japanese_count, japanese_pct, serbian_count, serbian_pct, russian_count, russian_pct, croatian_count, croatian_pct, afrikaans_count, afrikaans_pct, samoan_count, samoan_pct, polish_count, polish_pct, khmer_count, khmer_pct. 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}/area-stats/languages

cURL

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

Example Responses

Show schema

{
  "data": {
    "dataset": "languages",
    "level": "suburb",
    "area": "Bondi",
    "period_type": "snapshot",
    "as_of": "2021-08-10",
    "modelled": false,
    "fields": [
      {
        "field": "total_population",
        "name": "Total residents",
        "unit": "persons",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 10411
          }
        ]
      },
      {
        "field": "english_only_count",
        "name": "English only: residents",
        "unit": "persons",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 7206
          }
        ]
      },
      {
        "field": "english_only_pct",
        "name": "English only: share of residents",
        "unit": "%",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 69.22
          }
        ]
      }
    ]
  }
}

Successful Response200

application/json

About this dataset

About 11,000 suburbs and localities and 545 council areas across Australia, in all states and territories (areas with too few residents for reliable figures are left out); one snapshot at 10 August 2021. Current to 2021-08-10; refreshed five-yearly.

What it is

The language residents use at home on 10 August 2021, for every suburb and council area: English only, any other language, and the 36 most common other languages (Mandarin, Arabic, Vietnamese, Cantonese, Punjabi, Greek, Italian, Hindi and so on), plus how many speak English not well or not at all, each as a head-count and a share.

What it shows

Residents by language used at home (for example mandarin_count, mandarin_pct), English only, any other language, English-not-well, not stated and total residents. Each person reports one main language at home.

Why use it

Language at home drives translation and interpreter needs, signage, advertising language, community services and school support. Use it to find where Mandarin, Arabic, Vietnamese or Nepali speakers are concentrated, to plan multilingual outreach, or to enrich a suburb profile.

How it is built

Areas with fewer than 50 residents are left out because every small number is randomised. Our 2021 area statistics, matched to our suburb and council-area names. Figures are a snapshot at 10 August 2021 (the latest full count), so they describe who lived there then, not today. To protect privacy the source lightly randomises small numbers, so a count of 0, 3 or 6 can be approximate; shares for tiny suburbs jump around, so check the total residents field before trusting a percentage. It is the language spoken at home, not ancestry or birthplace, and a resident reports one language. Languages outside the 36 listed are inside other_language_any but not broken out. english_poor is a share of all residents, not of other-language speakers.

Fields

Field	Unit	Description
`total_population` Total residents	persons	All residents counted in the area on 10 August 2021, the base for every share in this dataset.
`english_only_count` English only: residents	persons	Number of residents for whom 'English only' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`english_only_pct` English only: share of residents	%	Residents in this group as a percent of all residents in the area.
`other_language_any_count` Uses a language other than English (any): residents	persons	Number of residents for whom 'Uses a language other than English (any)' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`other_language_any_pct` Uses a language other than English (any): share of residents	%	Residents in this group as a percent of all residents in the area.
`english_poor_count` Speaks English not well or not at all: residents	persons	Number of residents for whom 'Speaks English not well or not at all' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`english_poor_pct` Speaks English not well or not at all: share of residents	%	Residents in this group as a percent of all residents in the area.
`not_stated_count` Language used at home not stated: residents	persons	Number of residents for whom 'Language used at home not stated' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`not_stated_pct` Language used at home not stated: share of residents	%	Residents in this group as a percent of all residents in the area.
`chinese_languages_count` Chinese languages (all): residents	persons	Number of residents for whom 'Chinese languages (all)' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`chinese_languages_pct` Chinese languages (all): share of residents	%	Residents in this group as a percent of all residents in the area.
`mandarin_count` Mandarin: residents	persons	Number of residents for whom 'Mandarin' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`mandarin_pct` Mandarin: share of residents	%	Residents in this group as a percent of all residents in the area.
`cantonese_count` Cantonese: residents	persons	Number of residents for whom 'Cantonese' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`cantonese_pct` Cantonese: share of residents	%	Residents in this group as a percent of all residents in the area.
`arabic_count` Arabic: residents	persons	Number of residents for whom 'Arabic' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`arabic_pct` Arabic: share of residents	%	Residents in this group as a percent of all residents in the area.
`vietnamese_count` Vietnamese: residents	persons	Number of residents for whom 'Vietnamese' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`vietnamese_pct` Vietnamese: share of residents	%	Residents in this group as a percent of all residents in the area.
`punjabi_count` Punjabi: residents	persons	Number of residents for whom 'Punjabi' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`punjabi_pct` Punjabi: share of residents	%	Residents in this group as a percent of all residents in the area.
`greek_count` Greek: residents	persons	Number of residents for whom 'Greek' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`greek_pct` Greek: share of residents	%	Residents in this group as a percent of all residents in the area.
`italian_count` Italian: residents	persons	Number of residents for whom 'Italian' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`italian_pct` Italian: share of residents	%	Residents in this group as a percent of all residents in the area.
`hindi_count` Hindi: residents	persons	Number of residents for whom 'Hindi' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`hindi_pct` Hindi: share of residents	%	Residents in this group as a percent of all residents in the area.
`spanish_count` Spanish: residents	persons	Number of residents for whom 'Spanish' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`spanish_pct` Spanish: share of residents	%	Residents in this group as a percent of all residents in the area.
`nepali_count` Nepali: residents	persons	Number of residents for whom 'Nepali' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`nepali_pct` Nepali: share of residents	%	Residents in this group as a percent of all residents in the area.
`tagalog_count` Tagalog: residents	persons	Number of residents for whom 'Tagalog' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`tagalog_pct` Tagalog: share of residents	%	Residents in this group as a percent of all residents in the area.
`korean_count` Korean: residents	persons	Number of residents for whom 'Korean' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`korean_pct` Korean: share of residents	%	Residents in this group as a percent of all residents in the area.
`urdu_count` Urdu: residents	persons	Number of residents for whom 'Urdu' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`urdu_pct` Urdu: share of residents	%	Residents in this group as a percent of all residents in the area.
`tamil_count` Tamil: residents	persons	Number of residents for whom 'Tamil' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`tamil_pct` Tamil: share of residents	%	Residents in this group as a percent of all residents in the area.
`filipino_count` Filipino: residents	persons	Number of residents for whom 'Filipino' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`filipino_pct` Filipino: share of residents	%	Residents in this group as a percent of all residents in the area.
`sinhalese_count` Sinhalese: residents	persons	Number of residents for whom 'Sinhalese' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`sinhalese_pct` Sinhalese: share of residents	%	Residents in this group as a percent of all residents in the area.
`gujarati_count` Gujarati: residents	persons	Number of residents for whom 'Gujarati' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`gujarati_pct` Gujarati: share of residents	%	Residents in this group as a percent of all residents in the area.
`malayalam_count` Malayalam: residents	persons	Number of residents for whom 'Malayalam' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`malayalam_pct` Malayalam: share of residents	%	Residents in this group as a percent of all residents in the area.
`australian_indigenous_languages_count` Australian Indigenous languages: residents	persons	Number of residents for whom 'Australian Indigenous languages' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`australian_indigenous_languages_pct` Australian Indigenous languages: share of residents	%	Residents in this group as a percent of all residents in the area.
`indonesian_count` Indonesian: residents	persons	Number of residents for whom 'Indonesian' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`indonesian_pct` Indonesian: share of residents	%	Residents in this group as a percent of all residents in the area.
`persian_count` Persian (excluding Dari): residents	persons	Number of residents for whom 'Persian (excluding Dari)' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`persian_pct` Persian (excluding Dari): share of residents	%	Residents in this group as a percent of all residents in the area.
`french_count` French: residents	persons	Number of residents for whom 'French' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`french_pct` French: share of residents	%	Residents in this group as a percent of all residents in the area.
`german_count` German: residents	persons	Number of residents for whom 'German' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`german_pct` German: share of residents	%	Residents in this group as a percent of all residents in the area.
`bengali_count` Bengali: residents	persons	Number of residents for whom 'Bengali' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`bengali_pct` Bengali: share of residents	%	Residents in this group as a percent of all residents in the area.
`portuguese_count` Portuguese: residents	persons	Number of residents for whom 'Portuguese' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`portuguese_pct` Portuguese: share of residents	%	Residents in this group as a percent of all residents in the area.
`thai_count` Thai: residents	persons	Number of residents for whom 'Thai' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`thai_pct` Thai: share of residents	%	Residents in this group as a percent of all residents in the area.
`macedonian_count` Macedonian: residents	persons	Number of residents for whom 'Macedonian' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`macedonian_pct` Macedonian: share of residents	%	Residents in this group as a percent of all residents in the area.
`turkish_count` Turkish: residents	persons	Number of residents for whom 'Turkish' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`turkish_pct` Turkish: share of residents	%	Residents in this group as a percent of all residents in the area.
`japanese_count` Japanese: residents	persons	Number of residents for whom 'Japanese' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`japanese_pct` Japanese: share of residents	%	Residents in this group as a percent of all residents in the area.
`serbian_count` Serbian: residents	persons	Number of residents for whom 'Serbian' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`serbian_pct` Serbian: share of residents	%	Residents in this group as a percent of all residents in the area.
`russian_count` Russian: residents	persons	Number of residents for whom 'Russian' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`russian_pct` Russian: share of residents	%	Residents in this group as a percent of all residents in the area.
`croatian_count` Croatian: residents	persons	Number of residents for whom 'Croatian' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`croatian_pct` Croatian: share of residents	%	Residents in this group as a percent of all residents in the area.
`afrikaans_count` Afrikaans: residents	persons	Number of residents for whom 'Afrikaans' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`afrikaans_pct` Afrikaans: share of residents	%	Residents in this group as a percent of all residents in the area.
`samoan_count` Samoan: residents	persons	Number of residents for whom 'Samoan' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`samoan_pct` Samoan: share of residents	%	Residents in this group as a percent of all residents in the area.
`polish_count` Polish: residents	persons	Number of residents for whom 'Polish' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`polish_pct` Polish: share of residents	%	Residents in this group as a percent of all residents in the area.
`khmer_count` Khmer: residents	persons	Number of residents for whom 'Khmer' describes the language used at home (2021 snapshot). Each resident reports one main language at home. Small counts are lightly randomised for privacy.
`khmer_pct` Khmer: share of residents	%	Residents in this group as a percent of all residents in the area.