Suburb statistics

GET/v1/suburbs/{state}/{suburb}1 credit

Medians, growth rates, days on market, supply/demand for a suburb. Updated fortnightly. When a suburb name spans multiple postcodes (e.g. MELBOURNE VIC has three), the best-quality row is returned and the other matches are listed in `alternates[]` so you can re-query unambiguously; pass `?postcode=` to pin a specific one. A 404 carries `error.suggestions[]` when the name you sent is a near-miss for real suburbs in that state, each with `suburb`, `state` and `postcode` so you can retry directly. Spelling is the largest single source of wasted credits on this API, so branch on that array rather than retrying the same string.

Parameters

Name	In	Required	Description
state	path	yes	Two-letter state code (VIC, NSW, QLD, ...)
suburb	path	yes	Suburb name (URL-encoded)
postcode	query	no	4-digit postcode. Use to disambiguate when a suburb name spans multiple postcodes.

Example request

curl "https://api.propradar.com.au/v1/suburbs/VIC/Pascoe%20Vale" \
  -H "X-API-Key: pr_live_..."

Example response

{
  "suburb": "PASCOE VALE", "state": "VIC", "postcode": 3044,
  "medians": { "house_price": 1180000, "unit_price": 645000, "house_weekly_rent": 480, "unit_weekly_rent": 395 },
  "growth": { "house": { "qtr_pct": 1.83, "1y_pct": 7.43, "3y_pct": 18.07, "5y_pct": 31.12, "10y_pct": 62.38 }, "unit": { ... } },
  "yields": { "house_gross_pct": 2.11, "unit_gross_pct": 3.18 },
  "market_dynamics": { "house_days_on_market": 33, "unit_days_on_market": 28,
                       "vacancy_rate_pct": 1.43, "house_inventory_months": 2.17,
                       "house_stock_on_market_pct": 0.63, "sold_vs_asking_pct": 2.1,
                       "house_heat_score": 72, "house_sales_12mo": 145, ... },
  "demographics": { ... }, "location": { ... },
  // Starter+ only:
  "livability": { "walk_score": 78, "transit_score": 64,
                  "crime_rate_per_1000": 42.1, "crime_rank": 33,
                  "school_index": 1043, "schools_nearby": 12 },
  // Pro+ only:
  "supply_demand": { "house": { "building_approvals": 53, "avg_hold_period_years": 9.48, "buyer_demand": "high" }, "unit": { ... } },
  "rent_trends": { "house": { "qtr_pct": 0.97, "1y_pct": 4.83, "3y_pct": 13.12, "5y_pct": 19.37, "10y_pct": 31.44 }, "unit": { ... } },
  "auction": { "median_premium_pct": 4.0, "sample_size_band": "100-249", "granularity": "suburb" },
  "data_quality_flags": ["aggregated_wider_geography"],
  "alternates": [],
  "as_of": "2026-05-12T03:00:00Z"
}

Get an API key

Every endpoint takes an X-API-Key header. The free tier needs no credit card.

Get a free API key Full API documentation

Other endpoints

Many suburbs in one call: statistics and recent sales POST /v1/suburbs/batch
List every suburb in the dataset (coverage index) GET /v1/suburbs
Authenticated health probe GET /v1/health
Account usage and credit allowance GET /v1/usage
Resolve an address to a property_id GET /v1/properties/search
Look up a single property GET /v1/properties/{property_id}
Recent sold comparables (Hobby+; lat/lng mode Pro+) GET /v1/comparables
Trust-gated suburb rankings (Pro+ tier) GET /v1/suburbs/rankings
Multi-criteria suburb screener (Pro+ tier) GET /v1/suburbs/screen
Recent sold properties in a suburb GET /v1/suburbs/{state}/{suburb}/sold
Current active listings in a suburb GET /v1/suburbs/{state}/{suburb}/listings
Search current listings across a whole state (Pro+ tier) GET /v1/properties/listings
Property event history GET /v1/properties/{property_id}/history
Most recent sold record (Hobby+ tier) GET /v1/properties/{property_id}/sold_summary
Potential sell price confidence band GET /v1/properties/{property_id}/psp_with_confidence
Similar active listings GET /v1/properties/{property_id}/similar
Nearby active listings GET /v1/properties/{property_id}/nearby
Batch property lookup (Starter+ tier) POST /v1/properties/bulk
Value an off-market address: instant estimate or enhanced valuation (Hobby+ tier) POST /v1/valuations
Poll an off-market valuation job GET /v1/valuations/{id}
Valuation range for a locality, no address needed (Pro+ tier) POST /v1/valuations/estimate
12-month outlook for house/unit price and rent (Pro+ tier) GET /v1/suburbs/{state}/{suburb}/forecast
Development applications near a point (Pro+ tier) GET /v1/developments/nearby
Properties currently advertised for rent in a suburb (Hobby+ tier) GET /v1/suburbs/{state}/{suburb}/rentals
Weekly rent estimate for a locality, no address needed (Pro+ tier) POST /v1/rent/estimate
Recently-modified event feed (Starter+ tier) GET /v1/properties/recently-modified
Investment score + cashflow (Pro+ tier) GET /v1/properties/{property_id}/investment_analysis
Market cycle classification (Pro+ tier) GET /v1/suburbs/{state}/{suburb}/market_cycle
Annual price/rent/yield time-series (Pro+ tier) GET /v1/suburbs/{state}/{suburb}/price_history
Market-heat time-series (Pro+ tier) GET /v1/suburbs/{state}/{suburb}/heat_history
List macro regions (Growth+ tier) GET /v1/regions
Region macro indicators (Growth+ tier) GET /v1/regions/{slug}
Suggest addresses as the user types GET /v1/addresses/suggest
Turn free text into suburbs GET /v1/suburbs/resolve