search
Search StoragePrices for Australian suburbs that have self-storage pricing data. Returns a list of matching suburb documents (id, title, url). Use the returned id with the 'fetch' tool to get a full pricing snapshot. When no published suburb page matches, it falls back to facility suburbs that have current prices and returns those as 'place::' ids with result_scope='facilities_only' (e.g. 'place:nsw:bondi-junction') — still fetchable, just without a suburb page behind them. Generic words (storage, prices, cheapest, ...) and state names are stripped first, so 'storage prices sydney' finds the Sydney city scope ('city:nsw:sydney', result_scope='city_scope'); a place with a centre but no data of its own returns its priced neighbours with result_scope='nearby' and distance_km. An empty result always carries suggestions (never empty): the nearest published suburbs with distance_km when the query could be placed, else the capital-city scopes and 'index:national' — all fetchable ids; suggestions_basis says which. Every hit carries suburb, state and match_type (exact, token = a whole word of a longer name, or prefix), exact first. A name that lives in several states is listed in each, with ambiguous=true and ambiguity_note; a catalogue suburb with no page is result_scope='catalogue_unpublished'. result_scope says what kind of place an id names; the same string is still sent as coverage on search hits and fetch documents, deprecated: read result_scope. A place that only contains the query inside a longer word is never a result: it is a suggestion, and other_state_matches names where the exact name exists.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search"
}
}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. | |
| query | Yes | Suburb name or partial text to search for. | |
| state | No | State code, e.g. 'NSW', 'VIC', 'QLD'. |