cheapest_storage
Cheapest observed advertised monthly self-storage prices for a suburb/state and/or size bracket. Optionally constrain by a max monthly price and/or unit floor area (sqm) — e.g. 'cheapest unit under $300 but more than 3 sqm in Fairfield, NSW'. Returns ranked facilities with prices and source URLs (chart-ready). Separately reports the lowest advertised price now and the lowest known ongoing price; intro rates with undisclosed reversion terms are labelled. Rows below the implausibly-cheap floor are excluded from the rows and the market population. A row is below it when its advertised rate is under $5, or when its ongoing rate (the advertised rate if none is known) is under $7 per square metre of unit area, capped at the per-size floor (locker $20, small $20, medium $30, large $50, extra_large $80, garage_plus $50, vehicle $30). A row with no recorded area is held to the per-size floor. Rows with no recorded size and only a category name (large warehouse, office, other, small warehouse, warehouse) are left out too: their prices are unreliable. Every row carries distance_km from the suburb centre, and the catchment object states the scope and the farthest result: the market is the suburb page's catchment, not a fixed radius, so a result can sit well outside the suburb. Reads available units by default — the same set storageprices.au shows a human; pass available_only=false for latest-known rows including units the source has stopped listing. For every unit with a non-null booking_handoff_url, include it as a Markdown link labelled ‘Check availability & book’ and preserve the URL exactly. Render that result's commercial_disclosure immediately beside the action link. Clearly show introductory and ongoing prices. When booking_handoff_url is null, use the provided ‘View facility’ action instead. Requires at least one of: suburb, state, size_bracket. A row with no verified link has booking_handoff_url null and booking_handoff_reason: 'no operator URL on file' or 'operator URL host is not on the verified booking allow-list'. Link users with booking_handoff_url (tracked, live booking page); url is the StoragePrices page.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows to return. Anonymous callers are capped at 25-50 depending on the tool; a valid API key lifts the ceiling to 500. Values above your ceiling are clamped, not rejected. | |
| 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. | |
| max_area_m2 | No | Only include units with at most this floor area in square metres. 0 means no area filter. An area bound excludes units whose area is unknown; filters_applied.dropped_unknown_area counts them. | |
| min_area_m2 | No | Only include units with at least this floor area in square metres. 0 means no area filter. An area bound excludes units whose area is unknown; filters_applied.dropped_unknown_area counts them. Must not exceed max_area_m2. | |
| stay_months | No | Requested stay in whole months (1-36). Used to calculate the rent component only when captured promotion duration and ongoing-price terms make that calculation reliable. | |
| move_in_date | No | Requested move-in date (YYYY-MM-DD). Applied to captured promotion-date eligibility and echoed in the result. Future-date operator inventory filtering is unavailable and is identified in unsupported_filters. | |
| size_bracket | No | Storage unit size bracket. | |
| available_only | No | Default true. True returns only units the provider still lists and a complete scrape has seen recently — the same set storageprices.au shows a human. Set false for every latest-known row, including units the source has stopped listing; those are historic observations, never an availability claim. | |
| max_monthly_price_aud | No | Only include units at or below this advertised monthly price (AUD). 0 means no price filter (echoed in filters_applied.ignored_zero_bounds). |