🏠 Fotocasa Scraper - Spain Property & Agent Data

Extract real-estate listings from Fotocasa.es, Spain's #2 property portal, in clean structured form. Give it a city or a Fotocasa search URL and get back every listing with price, surface (m²), rooms, bathrooms, floor, full address, GPS coordinates, the listing agency and — when Fotocasa shows it — the advertiser's phone number, plus photos and the direct listing URL. Perfect for property research, market analysis, price tracking and real-estate lead generation across Spain. Export to JSON/CSV/Excel, run on a schedule, call via API, or connect to Make, Zapier or n8n.

🔎 What is the Fotocasa Scraper?

Fotocasa lists hundreds of thousands of homes for sale and to rent across Spain — Madrid, Barcelona, Valencia, Sevilla, Málaga, Bilbao and every province. This Actor reads Fotocasa's own search results and turns each property card into a tidy row you can drop straight into a spreadsheet, database or CRM, with no copy-pasting and no browser babysitting.

You can search two ways:

• By location — pass one or more city / province-capital names (e.g. madrid, barcelona, valencia) and choose for sale or to rent.
• By Search URL — paste a Fotocasa results URL straight from your browser to keep every filter you set on the site (price range, number of rooms, zone, property type, new construction, etc.).

The Actor paginates automatically until it reaches your maxResults.

What data does it extract?

For every listing it returns flat, ready-to-use fields, including:

• Price — clean numeric price plus the original formatted string, currency, and rent period.
• Property details — rooms, bathrooms, surface area in m², floor, property type/subtype, new-construction flag, and a list of amenities (elevator, air conditioning, terrace, parking, pool, storage room…).
• Location — street/area, neighborhood, district, city, municipality, province, postcode, and exact latitude/longitude.
• Agency & contact (lead-gen) — the listing agency name, agency type (professional/private), agency profile URL, and the advertiser phone number whenever Fotocasa exposes it.
• Media — main image URL, image count, and video / virtual-tour flags.
• Meta — listing id, ad id, direct listing URL, how many days ago it was published, and the publish timestamp.

⬇️ Input

Field	Type	Description
location	array	Spanish city / province-capital names to search, e.g. ["madrid","barcelona"]. Each becomes a Fotocasa search.
searchUrls	array	Fotocasa search-results URLs to scrape exactly (keeps all your filters). Used in addition to location.
operation	string	sale (comprar) or rent (alquiler). Applies to location searches.
maxResults	integer	Max listings to return per location or URL (default 50).
useResidentialProxy	boolean	Route through Apify residential (ES) proxies. Off by default; enable only for very large jobs.

Example input

{
  "location": ["madrid", "valencia"],
  "operation": "sale",
  "maxResults": 50
}

Or scrape an exact filtered search:

{
  "searchUrls": [
    "https://www.fotocasa.es/es/comprar/viviendas/barcelona-capital/todas-las-zonas/l"
  ],
  "maxResults": 100
}

⬆️ Output

Each item looks like this (fields shown are the real ones the Actor emits):

{
  "id": 189678845,
  "ad_id": "fa743746-c596-4013-bb8d-6dded76175ad",
  "url": "https://www.fotocasa.es/es/comprar/vivienda/madrid-capital/aire-acondicionado-calefaccion-amueblado/189678845/d",
  "operation": "sale",
  "transaction_type_id": 1,
  "property_type": "Flat",
  "property_subtype": "Flat",
  "is_new_construction": false,
  "price": 269000,
  "price_raw": "269.000 €",
  "currency": "EUR",
  "price_period": null,
  "reduced_price": "9.000 €",
  "rooms": 3,
  "bathrooms": 1,
  "area_sqm": 65,
  "floor": 7,
  "amenities": ["air_conditioner", "armored_door", "equiped_kitchen", "furnished", "heating"],
  "title": "Calle de Berastegui, Pueblo Nuevo",
  "description": "Luminosa vivienda reformada de 65 m²…",
  "address": "Pueblo Nuevo",
  "neighborhood": "Pueblo Nuevo",
  "district": "Ciudad Lineal",
  "city": "Madrid",
  "province": "Madrid",
  "postcode": "28017",
  "country": "España",
  "latitude": 40.4266138,
  "longitude": -3.6400208,
  "agency": "TENGOTUCASA",
  "agency_type": "professional",
  "agency_url": "https://www.fotocasa.es/es/inmobiliaria-tengotucasa/...",
  "phone": "+34913046530",
  "image": "https://static.fotocasa.es/images/ads/5cb8ec6d-...?rule=original",
  "num_images": 38,
  "has_video": false,
  "has_virtual_tour": false,
  "published_days_ago": 46,
  "published_timestamp": 1778760098190,
  "query": "madrid"
}

💡 Use cases

• 🏠 Real-estate lead generation — build prospect lists of agencies and advertisers (name, profile, phone) actively listing in a city or zone.
• 📊 Market & price analysis — track €/m², asking prices and inventory by neighborhood or province over time.
• 🧭 Property sourcing & alerts — monitor new listings that match your buy/rent criteria and feed them into your pipeline.
• 🗺️ Geospatial datasets — every listing ships with latitude/longitude for mapping, heatmaps and proximity analysis.

❓ FAQ

Which locations are supported? Anywhere on Fotocasa — pass a city/province-capital name, or paste any Fotocasa search URL to target an exact area or filter set.

Sale and rent? Yes. Set operation to sale or rent for location searches; for URLs the operation is detected from the link.

How many listings can I get? As many as the search returns — the Actor paginates automatically up to your maxResults. A single Fotocasa search can hold thousands of listings.

Does it return the agent's phone number? When Fotocasa publishes a phone for the listing, yes — it's in the phone field, along with the agency name and profile URL.

Do I need a proxy? The Actor uses Apify residential (ES) proxies by default, because Fotocasa blocks cloud/datacenter IP ranges. This is handled automatically — you don't need to configure anything. It uses only a small amount of residential traffic per run.

What formats can I export? JSON, CSV, Excel, HTML table or XML from the dataset, or pull results via the Apify API and integrations (Make, Zapier, n8n).

Will it break when the site changes? The Actor reads Fotocasa's structured page data and is built defensively; if the layout changes it's updated to keep working.

Is it legal? The Actor collects only publicly available listing information that Fotocasa shows to any visitor. You are responsible for using the data lawfully — in particular, handle any personal data (such as advertiser phone numbers) in line with GDPR and Spanish data-protection law, and respect Fotocasa's terms. Do not use scraped contact details for unsolicited spam.

🔗 You might also like

• Idealista Scraper — Spain's #1 property portal.
• Immobiliare.it Scraper — Italy's leading real-estate site.
• Rightmove Scraper — the UK's #1 property portal.
• Funda Scraper — the Netherlands' top real-estate portal.
• Real Estate Agent Lead Scraper — build agent contact lists across portals.

⚙️ How it works

The Actor requests Fotocasa's search-results pages exactly like a browser (using realistic TLS/headers), reads the structured listing data Fotocasa embeds in each page, normalizes it into the flat fields above, and pushes one record per property to your dataset. It de-duplicates by listing id and walks through result pages until it has collected your requested number of listings.

Keywords: fotocasa scraper, fotocasa api, scrape fotocasa, fotocasa.es, spain real estate scraper, spanish property data, idealista alternative, property listings spain, real estate lead generation spain, piso en venta, alquiler madrid, barcelona property scraper, real estate market data, property price scraper, agency phone scraper, apify real estate, casas en venta, viviendas españa, property dataset, rental listings spain