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

Introduction

Microburbs Property Data API

v1.0.0

One REST API for demographics, market indicators, risk scores, AVM and ranking — backed by 25+ years of Australian transactions and population data.

>_ Code
curl 'https://api.microburbs.com.au/v1/properties/GANSW704074813/profile' \
  -H 'Authorization: Bearer test'

Why Microburbs

  • Data depth — Demographics, lifestyle, risk, market, AVM and growth forecasts — all keyed to the same national suburb and property graph.
  • National coverage — Every Australian suburb and every residential property. GNAF-backed address resolution; state, SA2, SA3 included on every row.
  • Production reliability — Atomic prepaid reservations, predictable rate limits, request IDs, and 402/429/5xx semantics you can code against without guesswork.

Pricing

Pricing is per endpoint. Every response carries an X-Cost-Cents header matching the exact cents you were billed. Bulk endpoints (e.g. /v1/properties/{id}/risks/all) ship at a flat bundle price.

Response envelope

Every priced endpoint returns the same envelope. Branch on data !== null.

Success — HTTP 200:

>_ Code
{
  "data": { "predicted_price": 1240000, "predicted_price_low": 1180000, "predicted_price_high": 1310000, "prediction_date": "2026-04-19" }
}

No data — HTTP 404, and not billed (X-Cost-Cents: 0): nothing found is free. reason is a stable slug per endpoint; message is human-readable. A 404 with this envelope means the endpoint worked and we hold nothing for that place; list endpoints answer the same way instead of []:

>_ Code
{
  "data": null,
  "available": false,
  "reason": "no_avm_for_GANSW704074813",
  "message": "No AVM for GANSW704074813"
}

One schema per endpoint. data is nullable; available/reason/message are optional fields that only appear on no-data responses.

Response headers

Every metered response carries the exact call cost, cumulative spend and remaining prepaid credit. X-Balance-Cents is retained as an alias of X-Remaining-Cents for clients built during the prepaid-wallet preview.

Header Meaning
X-Cost-Cents Exact cents billed for this call.
X-Spent-Cents Cumulative cents used from this wallet.
X-Remaining-Cents Spendable prepaid credit left after this call. Calls stop at zero.
X-Period-End Start of the next UTC calendar month. Credits do not expire at this timestamp.
X-Balance-Cents Alias of X-Remaining-Cents.
X-Rate-Card-Version Version of pricing in effect for this call.
X-Request-Id UUID for this call — quote it in support tickets.

Try it now

The default Bearer in the playground below is the public sandbox key test. It unlocks one sample suburb and one sample property in every state and territory, so you can sanity-check the data against a place you actually know:

State Suburb (suburb_name) Property (gnaf_id)
NSW Belmont North, Bondi GANSW704074813 — 27 Arlington St, Belmont North
VIC St Kilda (Vic.) GAVIC419929404 — 12A Chaucer St, St Kilda
QLD Fortitude Valley GAQLD162849753 — 305/41 Robertson St, Fortitude Valley
WA Subiaco GAWA_146662014 — 36 Olive St, Subiaco
SA Unley GASA_422266490 — 53 Marion St, Unley
TAS Sandy Bay GATAS702292990 — 85 Lord St, Sandy Bay
ACT Kambah GAACT714845944 — 9 McDowall Pl, Kambah
NT Nightcliff GANT_703835649 — 16 Jacksonia Cct, Nightcliff

Suburb names are canonical suburb (SAL) names — note St Kilda (Vic.), which the official name disambiguates from the South Australian one. Call any route with these path values and you'll get real data, no signup. The same key also reaches the postcode routes for postcode 2026 (Bondi's), and the stamp duty, land tax and first home calculators (/v1/calculators/*) for every state. Anything else returns 403; mint your own key at our developer portal for full access.

Not sure which endpoint? Search them

Ask in plain words — free, no key, typo-tolerant and synonym-aware:

>_ Code
curl 'https://api.microburbs.com.au/v1/endpoints/search?q=how+many+people+rent+in+Bondi'

Ranked endpoints come back with path, price, a ready-to-run example call and the MCP tool name. Over MCP the same search is the search_endpoints tool.

Using an LLM agent? Connect over MCP

Every endpoint in this reference is also exposed as a native tool over the Model Context Protocol, so Claude, Cursor, and other agents can call Microburbs data directly — same API key, same plan, same per-call cents metering.

  • Hosted endpoint: https://api.microburbs.com.au/mcp — Streamable HTTP, the current MCP transport. Mounted in this API, so it is the same host, the same key and the same metering as the REST endpoints below.
  • Auth: Authorization: Bearer mib_live_... (your REST key works as-is). There is no OAuth flow — the key is the whole of it.
  • Claude Code: claude mcp add --transport http microburbs https://api.microburbs.com.au/mcp --header "Authorization: Bearer mib_live_..."

Full setup for every client — claude.ai, ChatGPT, Cursor, VS Code, Windsurf — is on the API docs page.

Getting help