Idealista Search Listings Price & Feature Scraper

{
  "properties": {
    "bathrooms": {
      "default": "any",
      "description": "Number of bathrooms.",
      "editor": "select",
      "enum": [
        "any",
        "1",
        "2",
        "3+"
      ],
      "enumTitles": [
        "Any",
        "1",
        "2",
        "3 or more"
      ],
      "prefill": "any",
      "title": "Bathrooms",
      "type": "string"
    },
    "condition": {
      "default": "any",
      "description": "Property condition.",
      "editor": "select",
      "enum": [
        "any",
        "new",
        "good",
        "toRenovate"
      ],
      "enumTitles": [
        "Any",
        "New build",
        "Good condition",
        "To renovate"
      ],
      "prefill": "any",
      "title": "Condition",
      "type": "string"
    },
    "country": {
      "default": "es",
      "description": "Idealista market: Spain, Portugal, or Italy. Auto-detected when you use URLs.",
      "editor": "select",
      "enum": [
        "es",
        "pt",
        "it"
      ],
      "enumTitles": [
        "Spain (idealista.com)",
        "Portugal (idealista.pt)",
        "Italy (idealista.it)"
      ],
      "prefill": "it",
      "title": "Country",
      "type": "string"
    },
    "fetchDetails": {
      "default": false,
      "description": "Visit each listing's page to add bathrooms, energy rating, year built, condition, full description, gallery and agency phone. Slower and uses more requests.",
      "prefill": false,
      "title": "Fetch Details",
      "type": "boolean"
    },
    "hasAirConditioning": {
      "default": false,
      "description": "Only listings with air conditioning.",
      "prefill": false,
      "title": "Has Air Conditioning",
      "type": "boolean"
    },
    "hasBalcony": {
      "default": false,
      "description": "Only listings with a balcony.",
      "prefill": false,
      "title": "Has Balcony",
      "type": "boolean"
    },
    "hasGarage": {
      "default": false,
      "description": "Only listings with a garage or parking space.",
      "prefill": false,
      "title": "Has Garage",
      "type": "boolean"
    },
    "hasGarden": {
      "default": false,
      "description": "Only listings with a garden.",
      "prefill": false,
      "title": "Has Garden",
      "type": "boolean"
    },
    "hasLift": {
      "default": false,
      "description": "Only listings with a lift.",
      "prefill": false,
      "title": "Has Lift",
      "type": "boolean"
    },
    "hasPool": {
      "default": false,
      "description": "Only listings with a swimming pool.",
      "prefill": false,
      "title": "Has Pool",
      "type": "boolean"
    },
    "hasSeaViews": {
      "default": false,
      "description": "Only listings advertised with sea views.",
      "prefill": false,
      "title": "Sea Views",
      "type": "boolean"
    },
    "hasStorageRoom": {
      "default": false,
      "description": "Only listings with a storage room.",
      "prefill": false,
      "title": "Has Storage Room",
      "type": "boolean"
    },
    "hasTerrace": {
      "default": false,
      "description": "Only listings with a terrace.",
      "prefill": false,
      "title": "Has Terrace",
      "type": "boolean"
    },
    "isAccessible": {
      "default": false,
      "description": "Only accessible homes.",
      "prefill": false,
      "title": "Accessible",
      "type": "boolean"
    },
    "isAuction": {
      "default": false,
      "description": "Only auction listings where the source marks them.",
      "prefill": false,
      "title": "Auction",
      "type": "boolean"
    },
    "isBankOwned": {
      "default": false,
      "description": "Only bank-owned listings where the source marks them.",
      "prefill": false,
      "title": "Bank-Owned",
      "type": "boolean"
    },
    "isLuxury": {
      "default": false,
      "description": "Only luxury listings.",
      "prefill": false,
      "title": "Luxury",
      "type": "boolean"
    },
    "isNewDevelopment": {
      "default": false,
      "description": "Only new-development listings.",
      "prefill": false,
      "title": "New Development",
      "type": "boolean"
    },
    "location": {
      "default": "madrid-madrid",
      "description": "City or area slug from an Idealista URL (e.g. madrid-madrid, barcelona-barcelona, lisboa, roma-roma). You can also paste a full Idealista search URL. Used in Search by location mode.",
      "editor": "textfield",
      "prefill": "roma-roma",
      "title": "Location",
      "type": "string"
    },
    "maxDetails": {
      "default": 100,
      "description": "Maximum number of listing pages to enrich when Fetch Details is on.",
      "maximum": 10000,
      "minimum": 1,
      "prefill": 3,
      "title": "Maximum Detail Pages",
      "type": "integer"
    },
    "maxItems": {
      "default": 100,
      "description": "Maximum number of listings to save.",
      "maximum": 10000,
      "minimum": 1,
      "prefill": 3,
      "sectionCaption": "Limits",
      "title": "Maximum Listings",
      "type": "integer"
    },
    "minPriceDropPercent": {
      "description": "Keep only listings reduced by at least this percentage. Implies price-drop filtering.",
      "maximum": 100,
      "minimum": 0,
      "title": "Minimum Price Drop (%)",
      "type": "integer"
    },
    "mode": {
      "description": "What to scrape: a location search, your own search URLs, or individual property URLs/IDs. Inferred from the supplied URLs when omitted.",
      "editor": "select",
      "enum": [
        "search",
        "startUrls",
        "propertyUrls"
      ],
      "enumTitles": [
        "Search by location",
        "Search URLs",
        "Property URLs / IDs"
      ],
      "prefill": "search",
      "sectionCaption": "Mode",
      "title": "Mode",
      "type": "string"
    },
    "onlyPriceDrops": {
      "default": false,
      "description": "Keep only listings whose price was reduced.",
      "prefill": false,
      "title": "Only Price Drops",
      "type": "boolean"
    },
    "onlyPrivateOwners": {
      "default": false,
      "description": "Keep only private-seller listings.",
      "prefill": false,
      "title": "Only Private Owners",
      "type": "boolean"
    },
    "operation": {
      "default": "sale",
      "description": "Properties for sale or for rent.",
      "editor": "select",
      "enum": [
        "sale",
        "rent"
      ],
      "enumTitles": [
        "For sale",
        "For rent"
      ],
      "prefill": "sale",
      "title": "Operation",
      "type": "string"
    },
    "partitionLargeSearches": {
      "default": true,
      "description": "When a search has more than 1,800 results and you ask for more, split it by price buckets so the 1,800-per-search cap is bypassed.",
      "prefill": false,
      "title": "Partition Large Searches",
      "type": "boolean"
    },
    "priceMax": {
      "description": "Drop listings more expensive than this price. Rounded to Idealista's nearest price bucket.",
      "maximum": 100000000,
      "minimum": 0,
      "title": "Maximum Price (EUR)",
      "type": "integer"
    },
    "priceMin": {
      "description": "Drop listings cheaper than this price. Rounded to Idealista's nearest price bucket.",
      "maximum": 100000000,
      "minimum": 0,
      "title": "Minimum Price (EUR)",
      "type": "integer"
    },
    "propertySubtype": {
      "default": "any",
      "description": "Narrow homes to a subtype (flat, penthouse, duplex, villa, etc.).",
      "editor": "select",
      "enum": [
        "any",
        "flat",
        "penthouse",
        "duplex",
        "studio",
        "loft",
        "chalet",
        "independentHouse",
        "semiDetached",
        "terraced",
        "villa",
        "countryHouse",
        "office",
        "premises",
        "garage",
        "land",
        "storageRoom",
        "building",
        "room"
      ],
      "enumTitles": [
        "Any",
        "Flat / apartment",
        "Penthouse",
        "Duplex",
        "Studio",
        "Loft",
        "Chalet",
        "Independent house",
        "Semi-detached house",
        "Terraced house",
        "Villa",
        "Country house",
        "Office",
        "Commercial premises",
        "Garage",
        "Land",
        "Storage room",
        "Building",
        "Room"
      ],
      "prefill": "any",
      "sectionCaption": "Filters",
      "title": "Property Subtype",
      "type": "string"
    },
    "propertyType": {
      "default": "homes",
      "description": "Type of property to search for.",
      "editor": "select",
      "enum": [
        "homes",
        "newDevelopments",
        "offices",
        "premises",
        "garages",
        "lands",
        "storageRooms",
        "buildings",
        "bedrooms"
      ],
      "enumTitles": [
        "Homes",
        "New developments",
        "Offices",
        "Commercial premises",
        "Garages",
        "Land",
        "Storage rooms",
        "Buildings",
        "Rooms"
      ],
      "prefill": "homes",
      "title": "Property Type",
      "type": "string"
    },
    "propertyUrls": {
      "description": "Individual Idealista property URLs or numeric property IDs. Used in Property URLs / IDs mode.",
      "editor": "stringList",
      "title": "Property URLs or IDs",
      "type": "array"
    },
    "rooms": {
      "default": "any",
      "description": "Number of rooms.",
      "editor": "select",
      "enum": [
        "any",
        "1",
        "2",
        "3",
        "4",
        "5+"
      ],
      "enumTitles": [
        "Any",
        "1",
        "2",
        "3",
        "4",
        "5 or more"
      ],
      "prefill": "any",
      "title": "Rooms",
      "type": "string"
    },
    "sizeMax": {
      "description": "Drop listings larger than this size. Rounded to Idealista's nearest size bucket.",
      "maximum": 100000,
      "minimum": 0,
      "title": "Maximum Size (m²)",
      "type": "integer"
    },
    "sizeMin": {
      "description": "Drop listings smaller than this size. Rounded to Idealista's nearest size bucket.",
      "maximum": 100000,
      "minimum": 0,
      "title": "Minimum Size (m²)",
      "type": "integer"
    },
    "sortBy": {
      "default": "relevance",
      "description": "Result order.",
      "editor": "select",
      "enum": [
        "relevance",
        "priceAsc",
        "priceDesc",
        "areaAsc",
        "areaDesc",
        "pricePerSqmAsc",
        "pricePerSqmDesc"
      ],
      "enumTitles": [
        "Relevance",
        "Price: low to high",
        "Price: high to low",
        "Size: small to large",
        "Size: large to small",
        "Price per m²: low to high",
        "Price per m²: high to low"
      ],
      "prefill": "relevance",
      "sectionCaption": "Output",
      "title": "Sort By",
      "type": "string"
    },
    "startUrls": {
      "description": "Idealista search-result URLs to scrape (filters and map-area URLs are kept as-is). Used in Search URLs mode.",
      "editor": "requestListSources",
      "sectionCaption": "URLs",
      "title": "Search URLs",
      "type": "array"
    }
  },
  "required": [],
  "schemaVersion": 1,
  "title": "Idealista Search Listings Input",
  "type": "object"
}

{
  "actorOutputSchemaVersion": 1,
  "description": "Dataset of Idealista property listings for Spain, Italy and Portugal: price, price history signals, size, rooms, bathrooms, location and coordinates, features, energy certificate, agency contact, images and description.",
  "properties": {
    "listings": {
      "description": "Dataset containing all scraped Idealista property listings.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Property Listings",
      "type": "string"
    }
  },
  "title": "Idealista Search Listings Output",
  "type": "object"
}

{
  "actorSpecification": 1,
  "title": "Idealista Listings",
  "views": {
    "overview": {
      "display": {
        "component": "table",
        "properties": {
          "address": {
            "format": "text",
            "label": "Address"
          },
          "bathrooms": {
            "format": "number",
            "label": "Baths"
          },
          "energyRating": {
            "format": "text",
            "label": "Energy"
          },
          "municipality": {
            "format": "text",
            "label": "City"
          },
          "phone": {
            "format": "text",
            "label": "Phone"
          },
          "price": {
            "format": "number",
            "label": "Price"
          },
          "priceDropPercent": {
            "format": "number",
            "label": "Drop %"
          },
          "propertyCode": {
            "format": "text",
            "label": "ID"
          },
          "propertySubtype": {
            "format": "text",
            "label": "Subtype"
          },
          "propertyType": {
            "format": "text",
            "label": "Type"
          },
          "rooms": {
            "format": "number",
            "label": "Rooms"
          },
          "size": {
            "format": "number",
            "label": "Size (m²)"
          },
          "updatedAt": {
            "format": "text",
            "label": "Updated"
          },
          "url": {
            "format": "link",
            "label": "URL"
          }
        }
      },
      "title": "Overview",
      "transformation": {
        "fields": [
          "propertyCode",
          "price",
          "priceDropPercent",
          "size",
          "rooms",
          "bathrooms",
          "address",
          "municipality",
          "propertyType",
          "propertySubtype",
          "energyRating",
          "phone",
          "updatedAt",
          "url"
        ]
      }
    }
  }
}