Search property listings
search_listingsLive sale and rental listings from 24 property portals, every listing in one schema (price, currency, beds, baths, area, address, coordinates, photos, agent). Costs 1 credit per listing returned; a failed portal read costs nothing. Portal keys by country: AE: bayut (rent/sale), propertyfinder (sale/rent); CA: padmapper (rent); DE: immobilienscout24 (rent/sale), kleinanzeigen (rent/sale); ES: idealista (sale/rent), fotocasa (sale/rent); FR: leboncoin (sale/rent); GB: rightmove (sale/rent), zoopla (sale/rent); IE: daft (rent/sale); IT: idealista (sale/rent), immobiliare (sale/rent); NL: funda (sale/rent); PL: otodom (rent/sale); PT: idealista (sale/rent), imovirtual (sale/rent); SE: hemnet (sale); US: zillow (sale), realtor (sale/rent), zillow-rentals (rent), redfin (sale), redfin-rentals (rent), zumper (rent), padmapper (rent), apartments-com (rent), craigslist (rent/sale). Call list_sources first for the location format and the filters each portal takes. Returns at most 50 listings per call; when next_offset is in the answer, call again with it as offset for the next page (only the rows returned are charged). Pass a listing's url to get_listing for its full record.
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": {
"source": "<source>",
"location": "<location>"
},
"name": "search_listings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Rent or sale; default is the portal's first kind. | |
| limit | No | Listings to return (1 credit each). | |
| offset | No | Listings to skip, for paging: use the `next_offset` of the previous answer. offset + limit may not pass 500. | |
| source | Yes | Portal key, e.g. 'zillow', 'rightmove', 'idealista'. | |
| filters | No | Optional; only where the portal accepts them (see list_sources). | |
| location | Yes | Place as the portal expects it (see list_sources), e.g. 'Austin, TX', 'SW11', 'madrid', or a search link from the portal. |