12-month outlook for house/unit price and rent (Pro+ tier)

GET/v1/suburbs/{state}/{suburb}/forecast2 credits

Costs 2 credits. PropRadar's own 12-month outlook for a suburb: the expected change in median house price, unit price, house rent and unit rent, each as a percentage with a direction (`up`, `down`, or `flat` within +/-1%). Any of the four can be null where a suburb does not have enough recent history to forecast, and the response omits nothing else. A suburb with none of the four returns 404 `no_forecast`. These are model estimates, not guarantees, refreshed as new market data arrives. **Read `state_percentile` alongside `change_pct`.** The model is strongest at ranking suburbs against each other, and an absolute level for a single suburb is less certain, so each figure carries `state_percentile` (0 = weakest outlook in the state, 100 = strongest). `change_pct` is capped at +/-30, with `capped: true` when the cap applied. Plans below Pro get 403 `plan_upgrade_required` and the credit is refunded.

Parameters

Name	In	Required	Description
state	path	yes	State code (VIC, NSW, ...).
suburb	path	yes	Suburb name, case-insensitive.
postcode	query	no	Disambiguate suburbs that span more than one postcode.

Example request

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

Example response

{ "suburb": "PASCOE VALE", "state": "VIC", "postcode": 3044, "horizon_months": 12,
  "houses": { "price": { "change_pct": 4.2, "direction": "up", "state_percentile": 31 },
              "rent":  { "change_pct": 3.1, "direction": "up", "state_percentile": 67 } },
  "units":  { "price": { "change_pct": 0.4, "direction": "flat", "state_percentile": 48 },
              "rent":  { "change_pct": 2.6, "direction": "up", "state_percentile": 78 } },
  "note": "Model estimates of the expected change over the next 12 months, not guarantees. ..." }

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
Suburb statistics GET /v1/suburbs/{state}/{suburb}
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
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