Actions2
Buy / Sale
AI-generatedSummary
Scrape Idealista property listings for a given country, location, and filters.
Inputs
- country — Idealista country domain (es, it, pt) – default Spain.
- endpoint — Property category (e.g., listhomes) – default listhomes.
- locationId (required) — Idealista location code for the target area.
- locationName (required) — Human‑readable location name (e.g., Madrid).
- numPages — Number of result pages to scrape (default 1, max 250).
- order — Sort order for results (e.g., mostrecent).
- language — Language for property descriptions (default en).
- priceFilters — Collection of minPrice and maxPrice filters.
- sizeFilters — Collection of minSize and maxSize filters.
- bedroomBathroomFilters — Collection of bedroom/bathroom boolean filters.
- propertyTypeFilters — Collection of property‑type boolean filters.
- conditionFilters — Collection of condition‑related boolean/options filters.
- featureFilters — Collection of amenity boolean filters.
- floorTimeFilters — Collection of floor and publication‑date filters.
- rentalFilters — Rental‑specific filters (only for rent operation).
- advancedFilters — Advanced filters such as agency, GPS coordinates, radius, timeout, maxResults.
Output shape
a list of property records
Each record contains the scraped property details; optional pagination via maxResults.
Examples
Example 1: Search for sale apartments in Barcelona, Spain, up to 3 pages
operation: sale, country: es, endpoint: listhomes, locationId: 0-EU-ES-08-12-001-123, locationName: Barcelona, numPages: 3, priceFilters: {"maxPrice": 500000}
Example 2: Rent studios in Lisbon with a minimum size of 30 m²
operation: rent, country: pt, endpoint: listhomes, locationId: 0-EU-PT-10-01-001-456, locationName: Lisbon, sizeFilters: {"minSize": 30}, bedroomBathroomFilters: {"bedrooms0": true}
Example 3: Get luxury new developments in Rome for sale, limited to 10 results
operation: sale, country: it, endpoint: listnewhomes, locationId: 0-EU-IT-62-05-001-789, locationName: Rome, propertyTypeFilters: {"luxury": true, "newDevelopment": true}, maxResults: 10