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.

This input was used for the complete real output example below:

{
  "maxItems": 30,
  "propertyType": "homes",
  "maxSurface": 200,
  "minSurface": 60,
  "minPrice": 250000,
  "locationQuery": "Madrid",
  "maxBathrooms": 3,
  "additionalQueryParameters": "{}",
  "operation": "buy",
  "locationLevel": "MUNICIPALITY",
  "sortBy": "latest",
  "minBathrooms": 1,
  "minRooms": 2,
  "maxPrice": 500000,
  "maxRooms": 5
}

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": 190519253,
  "transaction_type": "SALE",
  "property_type": null,
  "property_subtype": "Flat",
  "title": null,
  "price": 318000,
  "price_drop": null,
  "surface_m2": 117,
  "rooms": 2,
  "bathrooms": 2,
  "location": {
    "address": "Ensanche de Vallecas - La Gavia"
  },
  "coordinates": {
    "latitude": 40.363146328667796,
    "longitude": -3.5944497486531706,
    "accuracy": 0
  },
  "description": "Oportunidad de inversión mediante la adquisición de un crédito hipotecario (NPL - Non Performing Loan) con garantía inmobiliaria.\n\nImportante: esta operación NO supone la compra directa del inmueble. El comprador adquiere la posición acreedora del préstamo y los derechos asociados al crédito, pudiendo posteriormente gestionar su recuperación o continuar con las acciones legales que correspondan según la situación del expediente.\n\nEste tipo de inversión ofrece la posibilidad de acceder a activos con importantes descuentos y un elevado potencial de rentabilidad, siendo una alternativa cada vez más demandada por inversores especializados.\n\nPara más información sobre el estado del expediente, documentación disponible y condiciones de la cesión, no dude en contactar.",
  "agency": {
    "name": "Inmobiliaria Transforma 001",
    "id": 9202776550518,
    "reference": null
  },
  "photos": [
    "https://static.fotocasa.es/images/ads/a46d29af-418d-4c6d-90fa-2aedf09823bb?rule=original",
    "https://static.fotocasa.es/images/ads/2ccf21f1-5e03-473b-992d-f7742a1febe1?rule=original"
  ],
  "source_url": "https://www.fotocasa.es/es/comprar/vivienda/madrid-capital/ascensor-piscina/190519253/d",
  "scraped_from": "https://www.fotocasa.es/es/comprar/viviendas/espana/todas-las-zonas/l?minPrice=250000&maxPrice=500000&minSurface=60&maxSurface=200&minRooms=2&maxRooms=5&minBathrooms=1&maxBathrooms=3&sortType=publicationDate&sortOrderDesc=true&combinedLocationIds=724%2C14%2C28%2C173%2C0%2C28079%2C0%2C0%2C0&latitude=40.4096&longitude=-3.68624"
}

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

A minimum maximum charge of $0.03 per run applies, matching the minimum input limit of 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.
Google Maps Business Scraper | $1 per 1,000	Adding nearby businesses, amenities, contact details, ratings, and coordinates to location research.

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.

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.