Fotocasa.es Real Estate Scraper

Property listings from Fotocasa.es — flats, houses, new builds, offices, garages and land, for sale or for rent across Spain, with structured attributes, location, agent details and photos.

Who is this for

Real estate agencies tracking market inventory and pricing, investors running price-per-m² analysis across Spanish cities, PropTech products that need a listings feed, and market researchers building housing datasets.

What you get

• Structured attributes on every listing — price, size (m²), rooms, bathrooms, and amenity flags (parking, elevator, air conditioning, terrace, pool, …).
• Agent details: agency name, agent id, agent profile URL, and the contact phone when the seller published it.
• Full location down to neighborhood, plus map coordinates, the listing description and every photo. (Fotocasa does not publish exact street addresses.)

Sample output

{
  "id": "188518955",
  "adUuid": "601ef743-8656-4b1a-a543-cc91e9f99b1a",
  "url": "https://www.fotocasa.es/es/comprar/vivienda/linares/aire-acondicionado-parking-amueblado/188518955/d",
  "transactionType": "sale",
  "propertyType": "Flat",
  "propertySubtype": "Flat",
  "publishedAt": "2026-01-12",
  "firstPublishedAt": "2026-01-12",
  "ageDays": 241,
  "price": 95000,
  "priceRaw": "95.000 €",
  "priceReduced": 20000,
  "currency": "EUR",
  "sizeSqm": 95,
  "rooms": 4,
  "bathrooms": 2,
  "floorCode": 8,
  "hasParking": true,
  "hasElevator": false,
  "hasAirConditioning": true,
  "hasTerrace": false,
  "hasBalcony": false,
  "hasGarden": false,
  "hasPool": false,
  "hasStorageRoom": false,
  "furnished": true,
  "featureCodes": { "antiquity": 6, "floorCode": 8 },
  "isNewConstruction": false,
  "isAuction": false,
  "isBareOwnership": false,
  "isOccupied": false,
  "isRentedWithTenants": false,
  "isPromoted": true,
  "sellerType": "agency",
  "sellerName": "Gestión Inmobiliaria Ave Fenix",
  "sellerId": "9202767611596",
  "sellerUrl": "https://www.fotocasa.es/es/pro/gestion-inmobiliaria-ave-fenix/",
  "phone": "+34645824208",
  "province": "Jaén",
  "municipality": "Linares",
  "city": "Linares",
  "district": "Zona Hospital",
  "neighborhood": null,
  "zipCode": "23700",
  "region": "Andalucía",
  "latitude": 38.09018132,
  "longitude": -3.63980775,
  "coordinatesApproximate": true,
  "promotionTitle": null,
  "description": "Piso en venta ubicado en la tercera planta de un edificio sin ascensor…",
  "images": [
    "https://static.fotocasa.es/images/ads/66b32c8c-0292-4b27-9ba2-b6f428ae8c13?rule=original"
  ]
}

featuresRaw (the full untouched feature array) is also included on every item.

Input

Field	Description
transaction	comprar (for sale) or alquiler (for rent). Default comprar.
propertyType	viviendas (homes), casas, pisos, obra-nueva (new build), garajes, locales, oficinas, terrenos. Default viviendas.
location	Pick a Spanish province or its capital city from the dropdown (all 50 provinces covered). Default madrid-capital.
maxItems	Stop after this many listings. Default 40, 0 = unlimited.
maxPages	Result pages to scrape, ~30 listings each. Default 1, max 100.

Example runs

• Flats for sale in Valencia city: { "transaction": "comprar", "propertyType": "pisos", "location": "valencia-capital", "maxPages": 10 }
• Rental market across Málaga province: { "transaction": "alquiler", "propertyType": "viviendas", "location": "malaga-provincia", "maxItems": 0, "maxPages": 20 }

Technical notes

• HTTP-only. No browser, low compute cost, fast starts.
• Listings that Fotocasa repeats across pages are deduplicated, so you are never charged twice for the same ad.
• Every attribute is optional on Fotocasa's side; missing values come back as null, never as 0.
• floorCode is Fotocasa's internal floor identifier, not a storey number. A handful of other attributes (antiquity, orientation, heating, conservation) come back as featureCodes — Fotocasa's numeric ids for those values.
• Runs through Apify residential proxy by default — no setup needed, it works out of the box.