Fotocasa Spain Property Listings Scraper

Search public Fotocasa property listings across Spain by location or by an existing results URL. Get one structured Dataset item per unique property, with price, size, rooms, location, agency, photos, and the original listing URL when available.

What this Actor does

Fotocasa Spain Property Listings Scraper collects public homes, commercial properties, garages, offices, storage rooms, land, and buildings offered for sale, rent, or shared accommodation. You can reproduce precise Fotocasa filters with search URLs or configure a location and filters directly in Apify, then export up to 1,000 unique listings per run.

Use cases

• Compare advertised prices, sizes, and inventory across Spanish locations.
• Build comparable-property datasets for real-estate or investment research.
• Monitor listings that match a budget, property type, and room requirements.
• Enrich internal property catalogs with public agency, photo, and source-link data.

How to use

1. Open the Actor in Apify Console.
2. Enter either one or more Fotocasa search URLs or a Location such as Madrid. Do not use both methods in the same run.
3. Choose the operation, property type, filters, sorting, and maximum number of listings.
4. Click Start and open the Dataset when the run finishes.

Use a Fotocasa search URL when you need exact public filters or a specific district or neighbourhood. Use locationQuery when you want to create the search directly in Apify.

Input

Field	Type	Required	Description
searchUrls	array	Conditional	Public Fotocasa results URLs. Use this instead of locationQuery.
locationQuery	string	Conditional	Location text resolved through Fotocasa suggestions. Use this instead of searchUrls.
locationSlug	string	No	Optional Fotocasa URL location segment. Ignored when searchUrls is provided.
locationLevel	string	No	MUNICIPALITY, PROVINCE, REGION, DISTRICT, or NEIGHBORHOOD; default MUNICIPALITY.
operation	string	No	buy, rent, or share; default buy.
propertyType	string	No	homes, premises, garages, offices, boxRooms, lands, or buildings; default homes.
minPrice / maxPrice	integer	No	Minimum and maximum advertised price.
minSurface / maxSurface	integer	No	Minimum and maximum advertised surface in square metres.
minRooms / maxRooms	integer	No	Room range from 1 to 10.
minBathrooms / maxBathrooms	integer	No	Bathroom range from 1 to 10.
sortBy	string	No	rating, latest, cheapest, mostExpensive, biggest, smallest, or cheapestPerM2; default rating.
additionalQueryParameters	string	No	A JSON object written as text for additional public URL parameters. The structured fields above take priority.
maxItems	integer	Yes	Maximum unique Dataset items, from 30 to 1,000; default 30.

Complete input used for the output example below:

{
  "searchUrls": [
    "https://www.fotocasa.es/es/comprar/viviendas/madrid-capital/todas-las-zonas/l?sortType=publicationDate"
  ],
  "locationSlug": "madrid-capital",
  "locationQuery": "",
  "locationLevel": "MUNICIPALITY",
  "operation": "buy",
  "propertyType": "homes",
  "minPrice": 250000,
  "maxPrice": 500000,
  "minSurface": 60,
  "maxSurface": 200,
  "minRooms": 2,
  "maxRooms": 5,
  "minBathrooms": 1,
  "maxBathrooms": 3,
  "sortBy": "latest",
  "additionalQueryParameters": "{}",
  "maxItems": 30
}

Output

Results are saved to the run's default Dataset. Each item represents one unique public property listing and can be exported as JSON, CSV, Excel, XML, RSS, or HTML. Unavailable source values are returned as null, empty arrays, or omitted nested values rather than being guessed.

The following is one complete Dataset item from the real run using the input above:

{
  "property_id": 191047198,
  "transaction_type": "SALE",
  "property_type": null,
  "property_subtype": "Flat",
  "title": null,
  "price": 298000,
  "price_drop": null,
  "surface_m2": 97,
  "rooms": 3,
  "bathrooms": 2,
  "location": {
    "address": " RIOJANOS, Palomeras Sureste"
  },
  "coordinates": {
    "latitude": 40.38688381160384,
    "longitude": -3.6415124902596316,
    "accuracy": 0
  },
  "description": "REMAX Molgar te presenta en exclusiva este espectacular 8º piso de 98 m2 totalmente reformado, donde la luz natural, la amplitud y los acabados modernos son los verdaderos protagonistas.\n8ª Planta con vistas, máxima luminosidad y reforma de diseño en C/ Riojanos. Un piso donde no tienes que invertir ni un solo euro y puedes entrar a vivir cuanto antes.\n\nLO QUE HACE A ESTA VIVIENDA ÚNICA:\n\n•    Suite Principal de ensueño (18 m2): Un auténtico oasis privado. Se ha integrado una de las terrazas para crear un dormitorio principal gigante, con espacio para vestidor o tocador y un baño en suite de diseño con ducha de lluvia y acabados de gran calidad.\n\n•    Luz natural y altura despejada (8ª planta): Olvídate de los pisos oscuros. Aquí disfrutarás de sol, ventilación cruzada y tranquilidad absoluta durante todo el día.\n\n•    Salón de revista con aire acondicionado: Un ambiente acogedor equipado con aire acondicionado, pared decorativa de piedra, iluminación encastrada y salida a una agradable terraza acristalada para disfrutarla tanto en verano como en invierno.\n\nTodo listo para disfrutar:\n\nSuelos de tarima flotante de alta resistencia en tono roble cálido.\nCaldera de gas de alta eficiencia plenamente actualizada (garantiza un excelente rendimiento térmico y un consumo optimizado).\n\n3 habitaciones amplias y 2 baños completos (uno con bañera y el suite con ducha).\n\nCocina independiente perfectamente equipada y optimizada al milímetro.\n\nComodidad total: Finca con ascensor, patio comunitario privado y cerrado (ideal para que los niños jueguen con total seguridad) y plaza de garaje en alquiler traspasable por solo 85 €/mes.\n\nUBICACIÓN TOP: TODO A UN PASO DE TU PUERTA\n\nUbicado en una de las zonas más consolidadas y cómodas de Madrid, tendrás la combinación perfecta entre vida de barrio, zonas verdes y rapidez de desplazamientos:\n\n•    Naturaleza a tu alcance: A pocos minutos del Parque Lineal de Palomeras para hacer deporte o pasear.\n\n•    Servicios VIP: Colegios, institutos, centros de salud, farmacias 24h y supermercados sin necesidad de coger el coche.\n\n•    Conexión impecable: Salida directa a M-30, M-40 y A-3, además de una excelente red de autobuses EMT, Metro y Renfe Cercanías a un paso.\n\nPisos de este nivel en la zona y a esta altura vuelan. No dejes escapar la oportunidad de visitarlo. \n\nY si necesitas financiación, REMAX MOLGAR pone a tu disposición un equipo de financieros que te asesoraran y te guiarán para conseguir la mejor financiación del mercado.",
  "agency": {
    "name": "Remax Molgar",
    "id": 9202777428267,
    "reference": null
  },
  "photos": [
    "https://static.fotocasa.es/images/ads/e8821395-d1ed-4530-9c47-c2ec620a380d?rule=original",
    "https://static.fotocasa.es/images/ads/fc2327d2-265d-454c-bf6a-802008394493?rule=original",
    "https://static.fotocasa.es/images/ads/dd3473c0-1aec-40f9-bacf-8ad8813e132d?rule=original",
    "https://static.fotocasa.es/images/ads/a0be73ca-c1f1-4cf0-a467-20075fcc9267?rule=original",
    "https://static.fotocasa.es/images/ads/2b504c4f-cbbd-445e-a53b-480ab4d60f04?rule=original",
    "https://static.fotocasa.es/images/ads/8bc738f6-f53c-48d3-a96b-8cd04343f2c0?rule=original",
    "https://static.fotocasa.es/images/ads/d060d594-3a02-4cb5-bdab-54a4d69535e3?rule=original",
    "https://static.fotocasa.es/images/ads/8ba5cfc0-f9ea-4c0c-8f3a-b0217ef938a2?rule=original",
    "https://static.fotocasa.es/images/ads/68dde4fe-dc73-4d26-931c-7bca6454d058?rule=original",
    "https://static.fotocasa.es/images/ads/479e093a-fff0-4c88-a358-32641b64fc11?rule=original",
    "https://static.fotocasa.es/images/ads/a4669969-060c-4634-acbf-36fb6e38dec6?rule=original",
    "https://static.fotocasa.es/images/ads/2f0f1d8f-4c69-4ff3-aa96-163b9d4f8a01?rule=original",
    "https://static.fotocasa.es/images/ads/a456530f-a9af-4e04-9854-965e1afca4be?rule=original",
    "https://static.fotocasa.es/images/ads/7ce3798a-c2cb-4553-b929-0998f8cd1abd?rule=original",
    "https://static.fotocasa.es/images/ads/415a4abb-aed5-4186-a828-3e33da4bdf3b?rule=original",
    "https://static.fotocasa.es/images/ads/c7f2f476-10ee-48dd-a3f8-36e2ed20320b?rule=original",
    "https://static.fotocasa.es/images/ads/5a39d2c6-cc27-458f-8711-26503442caca?rule=original",
    "https://static.fotocasa.es/images/ads/e33b8abd-24d1-4db8-a3b2-1dfecb42a1a7?rule=original",
    "https://static.fotocasa.es/images/ads/4c4ac086-8b24-4778-b535-272aeac30efa?rule=original",
    "https://static.fotocasa.es/images/ads/68f70fc6-9475-48dd-9f5c-a9fac5d95206?rule=original",
    "https://static.fotocasa.es/images/ads/c7ac95ae-7d82-4b48-b1f3-f57f27e6b8e8?rule=original",
    "https://static.fotocasa.es/images/ads/8cde4515-8381-4340-a27e-8612f3e4b444?rule=original",
    "https://static.fotocasa.es/images/ads/314b765c-eb50-496f-8094-9aff4118d685?rule=original",
    "https://static.fotocasa.es/images/ads/6fe62f17-a882-4385-9684-0eeef05d212a?rule=original",
    "https://static.fotocasa.es/images/ads/c714053b-ec08-473d-9f7b-5fb3b2e70d26?rule=original"
  ],
  "source_url": "https://www.fotocasa.es/es/comprar/vivienda/madrid-capital/calefaccion-ascensor-amueblado/191047198/d",
  "scraped_from": "https://www.fotocasa.es/es/comprar/viviendas/madrid-capital/todas-las-zonas/l?sortType=publicationDate"
}

Pricing

The Actor uses pay-per-event pricing. Your Apify account tier determines the price of each unique property listing saved to the Dataset:

Apify tier	Price per listing	Price per 1,000 listings
FREE	$0.001	$1.00
BRONZE	$0.0009	$0.90
SILVER	$0.0008	$0.80
GOLD	$0.00075	$0.75
PLATINUM	$0.00075	$0.75
DIAMOND	$0.00075	$0.75

The minimum input limit is 30 listings. Duplicate or unsaved listings do not trigger an additional listing-result charge. Apify automatically applies the price for your account tier.

Related Actors

Actor	Best for
Realtor.com US Property Listings Scraper	Searching comparable property inventory across US cities, states, and ZIP codes.
Craigslist Scraper | Listings, Prices & Details	Collecting rental and other classified listings for local market comparisons.

Limits and data quality

The Actor returns at most 1,000 unique listings per run and requires a minimum maxItems value of 30. Available counts depend on Fotocasa's public results and the selected filters. Fields such as title, category, coordinates, price reduction, description, agency reference, and photos can be unavailable for individual listings. Property inventory and advertised values can change after collection, so rerun the Actor when freshness matters.

If collection cannot finish, already saved listings remain available and recoverable interruptions can finish normally with a partial outcome. Check the Dataset and the free RUN_REPORT and SUMMARY records before treating the search as complete. If those reports are unavailable, consult the saved Dataset and run log. A smaller valid inventory can finish below the requested maximum.

For narrow areas, use a public Fotocasa search URL with the exact filters you need. If a search returns fewer records than requested, broaden the area or filters and verify that the same public search currently contains matching listings.

Frequently asked questions

Should I use a search URL or a location?

Use searchUrls for exact public Fotocasa filters, districts, neighbourhoods, or multiple searches. Use locationQuery to configure one location directly in Apify. Provide only one of these search methods per run.

Are duplicate properties charged more than once?

No. A unique listing saved to the Dataset triggers one result charge per run; duplicates are not saved or charged again.

Why are some fields null or empty?

Fotocasa does not publish every value for every listing. The Actor preserves the available public data and does not invent missing values.

Responsible use

Use public property data responsibly. You are responsible for complying with applicable laws, privacy and data-protection requirements, and the source website's terms, and for confirming that your intended use is permitted.

Support

Open an issue in the Actor's Issues tab and include a reproducible input and run ID. Mention the affected location or search URL, expected result, and observed result so the issue can be investigated.