Fotocasa Scraper — Spanish property listings for sale and rent, by city, province or search URL, with no login

Scrape Fotocasa listings for any city, province or the whole of Spain: price, price reduction, rooms, bathrooms, surface, floor, features (elevator, terrace, parking, air conditioning, furnished), age and condition, neighbourhood, district, postal code with coordinates, publication date, full description, images and the agency with its phone. Homes for sale and for rent, plus offices, commercial premises, garages, land and storage rooms. No login, no API key, no browser, and no result limit: every page of a search is read (Madrid homes for sale alone is more than 12,000 listings).

Why this Fotocasa scraper

• Every page, not the first few. 31 listings per page, page after page until the end of the search: 2,790 listings for the whole of Spain in under 3 minutes, 300 listings in 25 seconds.
• Type a place, not a URL. Madrid, Barcelona, Getafe, Málaga provincia or España. Or paste any Fotocasa search URL from your browser with its filters.
• Many searches in one run. Several places × buy/rent × property types; duplicates are saved (and charged) once.
• Real filters. Price range, minimum rooms and bathrooms, surface range, sort by newest or price.
• Decoded fields. Floor, building age, condition and orientation come out as readable labels, not Fotocasa's codes. A feature the listing does not mention is null (unknown), never a wrong false.
• Agency contacts. Agency name, profile link and phone for professional listings. Private sellers' names and phones are never saved.
• Cheap and fast. Direct requests, no proxy bill; the scraper switches to a residential proxy by itself only if Fotocasa starts refusing requests. One bad place never stops the run: its status is reported in INPUT_STATUS.

Use cases: Spanish real estate data

• Investors and analysts: price per m², rents and yields by city, district or postal code.
• Agencies and lead generation: which agencies list what, where, with their phone numbers.
• Price monitoring: sortBy: newest on a schedule to catch new listings and price reductions every morning.
• Proptech and valuation models: a clean, geocoded dataset with surface, rooms, age and condition.
• Researchers and journalists: the Spanish housing market, rent levels and supply by region.

Input example

{
  "locations": ["Madrid", "Barcelona"],
  "transactions": ["buy", "rent"],
  "propertyTypes": ["viviendas"],
  "maxPrice": 400000,
  "minRooms": 2,
  "sortBy": "newest",
  "maxResultsPerSearch": 500,
  "maxItems": 2000
}

Field	What it does
locations	One per line: a city (Madrid = the city), a province (Madrid provincia), a town (Getafe) or España
transactions	buy, rent or both
propertyTypes	viviendas (all homes), pisos, apartamentos, chalets, locales, oficinas, garajes, terrenos, trasteros, edificios, naves-industriales (rent: homes, premises, offices, garages)
searchUrls	Optional Fotocasa search pages copied from your browser, filters included
minPrice / maxPrice	Price range in EUR (monthly rent for rentals)
minRooms, minBathrooms	Minimums
minSurface / maxSurface	Surface range in m²
sortBy	relevance, newest (for monitoring) or price
maxResultsPerSearch	Listings per place × transaction × type (0 = all of them)
maxItems	Cap for the whole run (0 = no cap)
maxImages	Image links per listing (imageCount always has the total)
proxyConfiguration	Default: none. A residential proxy is used automatically if Fotocasa refuses requests

Output example

{
  "listingId": 191120484,
  "url": "https://www.fotocasa.es/es/comprar/vivienda/madrid-capital/aire-acondicionado-amueblado/191120484/d",
  "transaction": "buy",
  "buildingType": "Flat",
  "price": 245000,
  "currency": "EUR",
  "priceReduction": null,
  "rooms": 3,
  "bathrooms": 1,
  "surfaceM2": 62,
  "furnished": true,
  "hasAirConditioning": true,
  "hasElevator": null,
  "antiquity": "50 to 70 years",
  "amenities": ["air_conditioner", "furnished"],
  "neighborhood": "Ambroz",
  "district": "Vicálvaro",
  "city": "Madrid",
  "province": "Madrid",
  "postalCode": "28032",
  "latitude": 40.41038779220395,
  "longitude": -3.612049594620763,
  "publishedAt": "2026-10-15T20:21:02Z",
  "description": "Agencia inmobiliaria de MADRID zona VICALVARO - VALDEBERNARDO - VALDERRIBAS …",
  "imageCount": 20,
  "images": ["https://static.fotocasa.es/images/ads/6d6d8912-e945-4e39-abf4-a11102df11b5?rule=original"],
  "isNewConstruction": false,
  "agencyName": "TECNOCASA VICALVARO",
  "agencyType": "professional",
  "agencyUrl": "https://www.fotocasa.es/es/pro/tecnocasa-vicalvaro/",
  "phone": "+34910075021",
  "searchLabel": "madrid-capital / buy / viviendas",
  "source": "Fotocasa",
  "scrapedAt": "2026-10-15T18:21:16Z"
}

Every row also has priceFormatted, pricePeriod, buildingSubtype, floor/floorLabel, hasTerrace, hasParking, hasHeating, condition, orientation, location, region, hasVideo, hasVirtualTour, isPromotion, isTop, isOpportunity and isOccupied. The run's OUTPUT record lists, per search, how many listings were saved and how many pages were read; INPUT_STATUS says whether each place or URL was found, not found or could not be checked.

Run it on a schedule and connect it to your tools

Schedule: in Apify Console open Schedules → Create, pick this actor with sortBy: newest and run it every morning to follow new listings and price drops in your cities. Each run returns the full, current result set as a new dataset.

Integrations (Actor → Integrations tab, no code):

• Google Sheets — append every run's listings to a sheet.
• Make, Zapier, n8n — start the actor from a scenario/zap/workflow and push listings to your CRM.
• Webhook — get a POST to your endpoint when a run succeeds, then download the dataset.
• Slack / email — notify your team when a scheduled run finishes.

AI agents (MCP) — Claude, ChatGPT, Cursor, VS Code or any MCP client can run it as a tool: add the Apify MCP server https://mcp.apify.com?actors=kalilfagundes.w/fotocasa-scraper (sign in with your Apify account) and ask for the data in plain language. The agent fills the input from the input schema and reads the dataset back.

API — call it from your code (pip install apify-client / npm i apify-client):

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("kalilfagundes.w/fotocasa-scraper").call(run_input={
    "locations": ["Barcelona"],
    "transactions": ["rent"],
    "propertyTypes": ["viviendas"],
    "maxResultsPerSearch": 300,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["price"], item["rooms"], item["surfaceM2"], item["district"], item["url"])

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('kalilfagundes.w/fotocasa-scraper').call({
  locations: ['Barcelona'],
  transactions: ['rent'],
  propertyTypes: ['viviendas'],
  maxResultsPerSearch: 300,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Pricing

Pay per result, platform usage included:

Event	Price
Listing saved	$0.75 per 1,000 listings
Run start	$0.002

Example: 10,000 listings ≈ $7.50. Apify subscribers get tier discounts automatically. Set maxItems to cap the cost of a run.

FAQ and limits

• Does it need a Fotocasa login or API key? No. Fotocasa has no public API: this reads the listing data the search pages already contain.
• How many listings can I get? All of a search: pages are read until the last one. Very large searches (all of Spain has 480,000 homes for sale) take time; raise the run timeout or narrow by place, price or type.
• Is a detail page needed for the description or images? No, they come with the search data, which keeps runs fast and cheap.
• Why is a feature null? The listing does not mention it. null means unknown, not "no".
• A place returns "not found"? Use the Fotocasa spelling of the town, or paste the search URL from your browser.
• Contact data: only agencies' public business contacts are saved; private sellers' names and phones never are.
• Fair use: use the data in line with Fotocasa's terms and the GDPR; keep schedules reasonable.

En español

Este actor extrae anuncios de Fotocasa de cualquier ciudad, provincia o de toda España: pisos y casas en venta y en alquiler, oficinas, locales, garajes y terrenos. Precio, rebaja, habitaciones, baños, superficie, planta, ascensor, terraza, garaje, antigüedad, estado, barrio, distrito, código postal con coordenadas, fecha de publicación, descripción, fotos y la inmobiliaria con su teléfono. Sin límite de resultados, sin iniciar sesión y sin clave de API. Filtra por precio, habitaciones y superficie, ordena por los más nuevos y programa la ejecución para seguir el mercado. Exporta a Excel, CSV o JSON.

Related actors

• Zap Imóveis, VivaReal & QuintoAndar Scraper - Imóveis Brasil

Feedback

Found a missing field or a place that returns nothing? Open an issue on the Actor page and it will be looked at.