storage_near
Unit-level self-storage prices within a kilometre radius of a point or suburb centre — e.g. 'storage within 5km of Fairfield, NSW'. At least one of suburb or lat+lng is required. Returns individual units (not aggregated) with distance: by default the 3 cheapest units of each facility, nearest facility first, so the page spans the radius; group_by_facility=false gives the flat nearest-unit-first list. Use this for true competitor data at the unit level and for radius questions. Every row separates advertised promotional, standard, and reversion pricing and states when ongoing pricing is unknown. 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. 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. 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 |
|---|---|---|---|
| lat | No | Latitude of the search centre (alternative to suburb; pass lng too). Inside Australia. If a suburb is also sent the coordinates win and `place.ignored_args` says so. | |
| lng | No | Longitude of the search centre (alternative to suburb; pass lat too). Inside Australia. | |
| 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. | |
| radius_km | No | Search radius in kilometres (default 5). Must be greater than 0. A value below 0.5 is clamped to 0.5 and a value above 25 is clamped to 25, never rejected: radius_applied_km states the radius that ran and radius_note says when it was clamped. | |
| 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. | |
| group_by_facility | No | Default true: at most per_facility_limit cheapest units per facility, nearest facility first, so the page spans the radius. group_by_facility=false returns the flat list, nearest unit first (a page can then fill up from one facility). facilities_in_radius and truncated report the whole radius either way. | |
| per_facility_limit | No | With group_by_facility=true: cheapest units per facility (default 3). Must be at least 1 (0 or below is rejected); a value above 25 is clamped to 25, and per_facility_limit_requested / _applied echo both. | |
| 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). |