🇪🇸 Fotocasa.es Real Estate Scraper

High-speed, HTTP-only reverse-engineered scraper for Fotocasa.es — Spain's #1 leading real estate and property marketplace. Extracts sale and rental properties across Madrid, Barcelona, Valencia, Seville, Malaga, and all Spanish municipalities with zero browser overhead and minimal memory consumption (< 128MB).

---

⚡ Key Features

• Blazing Fast HTTP Extraction: Directly parses embedded high-yield Server-Side Rendered (SSR) state without headless browser emulation. Average execution time < 1 second per 30 listings.
• Rich Property Attributes:
  • Pricing: Raw numeric price in EUR, formatted display price, and historical price reductions.
  • Coordinates & Location: Exact GPS latitude/longitude, neighborhood, district, municipality, province, autonomous region, and postal code.
  • Floor Plan & Dimensions: Living area ($m^2$), bedrooms, bathrooms, floor number, and conservation status.
  • Amenities & Features: Automatic detection of elevator, garage/parking, balcony, terrace, air conditioning, heating, storage room, and swimming pool.
  • Multimedia: Complete high-resolution image galleries (up to 40+ photos per listing) and virtual tour flags.
  • Advertiser Intelligence: Agency/broker name, advertiser type (professional vs particular), phone number, and direct agency profile links.
• Pay-Per-Event (PPE) Ready: Extremely cost-efficient execution with negligible platform usage, perfect for competitive marketplace pricing ($0.0009 - $0.0015 / result).

---

📥 Input Parameters

Parameter	Type	Required	Default	Description
startUrls	Array of Strings	No	["https://www.fotocasa.es/es/comprar/viviendas/madrid-capital/todas-las-zonas/l"]	Direct search or category URLs on Fotocasa.es.
locations	Array of Strings	No	[]	List of Spanish cities or regions (e.g. madrid-capital, barcelona-capital, valencia-capital).
transactionType	String (Select)	No	"comprar"	Transaction type: "comprar" (Buy/Sale), "alquiler" (Rent), or "compartir" (Room share).
propertyType	String (Select)	No	"viviendas"	Property type: "viviendas" (Homes/Flats), "obra-nueva" (New Builds), "locales-o-naves", "oficinas", "garajes", "terrenos".
maxItems	Integer	No	50	Maximum number of property records to extract.
proxyConfiguration	Object	No	{"useApifyProxy": false}	Optional proxy settings. Standard direct HTTP works smoothly, but Apify Residential proxy is supported for large-scale runs.
impersonate	String (Select)	No	"chrome124"	Browser TLS fingerprint profile for curl_cffi HTTP requests.

---

📤 Output Schema Example

Each dataset item pushed to the default Apify Dataset matches the following JSON structure:

{
  "id": "190402460",
  "url": "https://www.fotocasa.es/es/comprar/vivienda/madrid-capital/villa-de-vallecas-santa-eugenia/190402460/d",
  "price": 390000.0,
  "currency": "EUR",
  "priceFormatted": "390.000 €",
  "reducedPrice": null,
  "transactionType": "comprar",
  "surfaceM2": 109.0,
  "rooms": 3,
  "bathrooms": 2,
  "floor": "3",
  "conservationStatus": "good",
  "amenities": {
    "elevator": true,
    "parking": true,
    "balcony": false,
    "terrace": false,
    "airConditioner": false,
    "heating": true,
    "furnished": false,
    "storageRoom": false,
    "swimmingPool": false
  },
  "address": {
    "full": "Santa Eugenia, Villa de Vallecas, Madrid, Madrid",
    "neighborhood": "Santa Eugenia",
    "district": "Villa de Vallecas",
    "municipality": "Madrid",
    "province": "Madrid",
    "region": "Madrid",
    "zipCode": "28031",
    "country": "España"
  },
  "location": {
    "latitude": 40.38243629540415,
    "longitude": -3.6100592732759647
  },
  "advertiser": {
    "name": "VOhome Santa Eugenia",
    "type": "professional",
    "phone": "+34912345678",
    "agencyUrl": "https://www.fotocasa.es/es/pro/vohome-santa-eugenia/"
  },
  "images": [
    "https://static.fotocasa.es/images/ads/0bce7fe0-ddd8-420b-aa08-8b3dc4c3d040?rule=original",
    "https://static.fotocasa.es/images/ads/1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d?rule=original"
  ],
  "photosCount": 24,
  "isNewConstruction": false,
  "isHighlighted": false,
  "publishedDate": "2026-09-01T12:00:00Z",
  "originalDate": "2026-08-15T09:30:00Z",
  "scrapedAt": "2026-09-09T14:15:00.000000+00:00"
}

---

🚀 Use Cases

1. Real Estate Investment & Valuation: Track price-per-square-meter (€/$m^2$) trends across Spanish neighborhoods for automated valuation models (AVM).
2. Rental Yield Analysis: Compare purchase prices vs. long-term rental rates in high-growth hubs (Madrid, Barcelona, Malaga, Valencia).
3. Competitive Broker Intelligence: Monitor new listings from leading agencies (Engel & Völkers, Lucas Fox, Gilmar, Redpiso, Tecnocasa) instantly.
4. Relocation & Travel Housing: Build custom alerts for apartments with specific criteria (balconies, terraces, parking, elevators).