list_home_properties
Search homes for sale or rent across Spain, Portugal, and Italy. Filter by location, price, size, bedrooms, and more to find matching properties.
Instructions
List home properties with the requested parameters. Buy/Rent \u003e Homes. Filters are optional parameters, please make sure the request follows the rules in each parameter. Boolean parameters should be true always if you want to use them. To make them false, don't include them in the requests (leave blank).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flat | No | Example value: | |
| good | No | Example value: | |
| order | Yes | Order by one of the followings: relevance|lowestprice|highestprice|mostrecent|leastrecent|highestpricereduction|lowestpricem2|highestpricem2|biggest|smallest|highestfloors|lowestfloors Default is relevance. | |
| renew | No | Example value: | |
| chalet | No | Example value: | |
| duplex | No | Example value: | |
| garage | No | Example value: | |
| garden | No | Example value: | |
| isFree | No | Example value: | |
| locale | Yes | The language of the ads. Pick between: es|it|pt|en|ca|de|fr|nl|nb | |
| luxury | No | Example value: | |
| hasPlan | No | Example value: | |
| maxSize | No | Maximum size to search in m2. | 0 |
| minSize | No | Minimum size to search in m2. | 0 |
| numPage | Yes | Example value: 1 | 1 |
| elevator | No | Example value: | |
| exterior | No | Example value: | |
| location | Yes | One of the following values: es|pt|it | |
| loftType | No | Example value: | |
| maxItems | Yes | Number of items to return. Set 0 to return the item's count, fast response. Max Value is 40, anything above will be ignored. | |
| maxPrice | No | Maximum price to search. | 0 |
| minPrice | No | Minimum price to search. | 0 |
| terrance | No | Example value: | |
| topFloor | No | Example value: | |
| bankOffer | No | Example value: | |
| bathroom3 | No | Example value: | |
| bedrooms0 | No | Example value: | |
| bedrooms1 | No | Example value: | |
| bedrooms2 | No | Example value: | |
| bedrooms3 | No | Example value: | |
| bedrooms4 | No | Example value: | |
| furnished | No | Furnishings parameter. ONLY valid when operation=rent. Pick between. Indifferent: leave blank (default) | Furnished: furnished | Only furnished kitchens: furnishedKitchen | |
| onlyFlats | No | Example value: | |
| operation | Yes | Search sales or rentals. Pick between: sale|rent | |
| penthouse | No | Example value: | |
| shortTerm | No | Example value: | |
| sinceDate | No | Publication Date Parameter. One of the following values. Indifferent: leave blank (by default) | Last 24h: T (Rent operation only) | Last 48h: Y (Buy operation only) | Last week: W | Last month: M | |
| storeRoom | No | Example value: | |
| villaType | No | Example value: | |
| accessible | No | Example value: | |
| bathrooms1 | No | Example value: | |
| bathrooms2 | No | Example value: | |
| isTenanted | No | Example value: | |
| locationId | Yes | Example value: 0-EU-ES-28-07-001-079 | |
| cortijoType | No | Example value: | |
| petsAllowed | No | Example value: | |
| virtualTour | No | Example value: | |
| casaBajaType | No | Example value: | |
| countryHouse | No | Example value: | |
| locationName | Yes | Example value: Madrid | |
| swimmingPool | No | Example value: | |
| terracedHouse | No | Example value: | |
| newDevelopment | No | Example value: | |
| airConditioning | No | Example value: | |
| apartamentoType | No | Example value: | |
| atticStudioType | No | Example value: | |
| isBareOwnership | No | Example value: | |
| builtinWardrobes | No | Example value: | |
| independantHouse | No | Example value: | |
| intermediateFloor | No | Example value: | |
| semidetachedHouse | No | Example value: | |
| micrositeShortName | No | Get ads from a specific real estate. For example if the URL from the real estate is: https://www.idealista.com/pro/cajal-gestion-inmobiliaria/ The parameter micrositeShortName should be cajal-gestion-inmobiliaria | |
| isIllegallyOccupied | No | Example value: | |
| longTermResidential | No | Example value: |