Annual price/rent/yield time-series (Pro+ tier)

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

Annual median sold price, median weekly rent (sparse, only years that carry it), and derived gross yield for one property type, oldest first. Each point is one calendar year. Hobby/Starter callers get 403 plan_upgrade_required; the credits are refunded.

Parameters

Name	In	Required	Description
state	path	yes	Two-letter state code
suburb	path	yes	Suburb name (URL-encoded)
property_type	query	no	houses (default) or units
years	query	no	Trailing years (default 15, max 40). `months` is accepted as a legacy alias and treated as a count of years.
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/price_history?property_type=houses&years=15" \
  -H "X-API-Key: pr_live_..."

Example response

{ "suburb": "Pascoe Vale", "state": "VIC", "property_type": "houses",
  "granularity": "annual", "points": 8,
  "series": [{ "year": 2026, "median_price": 1200000,
               "median_weekly_rent": 630, "gross_yield_pct": 2.7, "sample_count_band": "100-249" }],
  "as_of": 2026 }

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
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
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