price_trends
Add provider (for example storage_king) for provider history: ongoing and advertised monthly series, typical matched-facility movement and rising/falling counts, with explicit coverage gates. Provider-only queries are allowed and return separate size panels, never an all-size median. Storage King and National reconstruct products from historical booking links; other providers have descriptive history but no supported matched headline. A failed coverage gate returns insufficient_comparable_history, never a fallback price movement. Provider history defaults to monthly full UTC periods; use facility_id for a single facility. Without provider, returns the existing market trend: median advertised monthly price per week or month over a lookback window, plus the promotional share each period. Use for 'are prices going up?', seasonality, and promo cycles. Returns a chart-ready time series. trend_summary.direction follows the like-for-like matched panel (direction_basis) and keeps the raw change as advertised_change_pct. National and state-level series are cached for ten minutes (cached, cache_age_s). A query that overruns its statement timeout returns error_code='timeout' with retryable=true — narrow lookback_days or add state/suburb. Requires at least one of: suburb, state, size_bracket, provider.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | State code, e.g. 'NSW', 'VIC', 'QLD'. | |
| suburb | No | Australian suburb name, e.g. 'Chatswood'. A trailing state or postcode is peeled ('Sydney 2000'). Capital cities (Sydney, Melbourne, Brisbane, Perth, Adelaide, Canberra, Hobart, Darwin, Gold Coast) resolve to a city-wide radius scope. On price_distribution, an otherwise-empty exact Australian locality can resolve from the packaged ABS SAL snapshot even when StoragePrices has no prices there. Every answer states how the place resolved in `place`. `place.match_type` says how the name matched (exact, token or prefix, ...); when `place.ambiguous` is true the name also matches the places in `place.other_candidates` — confirm with the user or pass state. | |
| provider | No | Provider slug or name, e.g. storage_king / Storage King. Enables provider history. | |
| facility_id | No | Optional exact facility ID, within provider. Requires provider; any geography also intersects this filter. | |
| granularity | No | Time bucket size (default month for provider history, week for market history). | |
| size_bracket | No | Storage unit size bracket. | |
| lookback_days | No | How far back to look, in days (default 180, max 1095). Values outside 7–1095 are clamped; lookback_days_requested / _applied echo both. |