Search apartments
search_listingsRead-onlyIdempotent
Search Dorit's live apartment listings (rent or sale) in Israeli cities, localities and regional groups, narrowed to neighborhoods or named areas, with structured filters: price, rooms, size, floor, move-in month, property type, roommates and features; tags for attributes Dorit reads from the ads, such as parquet or a rear-facing flat; and keywords matched literally in the listing text for anything else. Returns compact listings with dorit.bot links, newest first by default, and what the place names resolved to. Use get_listing for one listing's full details and photos.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| sort | No | newest | |
| tags | No | Short words, in any language, for an attribute of the flat no other field covers: a material, an orientation, noise, light, a view, a building detail ("parquet", "פרקט", "quiet", "דירה עורפית"). Each word resolves to one of the tags Dorit reads from listings' ad text, and from their photos once Dorit has reviewed them; a listing must carry every resolved tag. A tag is positive evidence only: a listing that has the attribute without its ad saying or showing it is not returned. The output names the tag each word resolved to, and lists a word that resolved to none in unmatched_tags without narrowing the search by it. Places, rooms, prices and the features above have their own fields. | |
| cities | No | Cities, localities or regional groups by name in Hebrew, English or Russian, or by slug ("תל אביב", "Tel Aviv", "tel-aviv", "עמק חפר"). A group covers every settlement in it. Omit when neighborhoods or search_area already say where. | |
| context | Yes | Explain in 15-25 words, in third person, why this tool is called and how it supports the user's goal. For analytics only. You MUST describe only the abstract purpose of the tool call. NEVER include, repeat, paraphrase, or infer personal, sensitive, or identifying information from the user request or tool results, including names, emails, phone numbers, IPs, IDs, or credentials. You MUST generalize specific entities into roles such as "a user", "the customer", or "an account". Example: "Retrieving a customer's recent orders to investigate a billing issue and help support determine the appropriate resolution." | |
| max_sqm | No | ||
| min_sqm | No | ||
| features | No | true requires the feature; false excludes it; omitted does not filter. elevator=true means an elevator or a low floor (see max_floor_without_elevator). | |
| keywords | No | Literal terms for a wish neither tags nor another field covers, or for a word tags returned in unmatched_tags ("תקרה גבוהה", "high ceilings", "נוף לים"). A listing matches when its description contains any of them (case-insensitive substring). Most listings are written in Hebrew, so include the Hebrew term and its spelling variants. Matching is literal: a listing that has the feature but does not mention it is not returned. Places, rooms, prices and the features above have their own fields and do not belong here. | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. "claude-opus-4-8", "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" — never guess. | |
| max_floor | No | ||
| max_price | No | ||
| max_rooms | No | ||
| min_floor | No | ||
| min_price | No | ||
| min_rooms | No | Israeli room count (whole or half rooms; a living room counts). | |
| page_size | No | Defaults to the plan's page size (10 on trial, 25 on premium). | |
| roommates | No | exclusive = only rooms in shared flats; excluded (default) = whole apartments only. | |
| handover_by | No | Sale only: latest handover month, YYYY-MM. | |
| neighborhoods | No | Neighborhoods, named areas of a city ("הצפון הישן", "מערב ראשון לציון"), landmarks or housing projects, by name, slug or the ids coverage and find_neighborhoods_near return. A neighborhood inside a listed city narrows that city to it; one in another city is added to the search. | |
| property_types | No | Asset types: apartment, unit, garden, house, twofamily, penthouse, duplex. Omit for all. | |
| entrance_months | No | Rent only: acceptable move-in months, YYYY-MM. A listing naming no month is treated as available now or within the month. | |
| transaction_type | No | rent (monthly ILS) or sale (total ILS). Sale is open in fewer cities. | rent |
| exclude_neighborhoods | No | ||
| max_floor_without_elevator | No | Highest acceptable floor when the building has no elevator; above it an elevator is required. Same as features.elevator=true with this walk-up limit. |