Microburbs Property Data API
One REST API for demographics, market indicators, risk scores, AVM and ranking — backed by 25+ years of Australian transactions and population data.
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:
{
"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 []:
{
"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:
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
- Email support: [email protected]
