Fotocasa Scraper - Spain Listings, Pay Per Result

Why use this scraper

Fotocasa is one of Spain's leading property portals for buying and renting homes, offices, land and commercial space, but like most listing sites it has no public API for bulk access. Anyone building a PropTech product, tracking a local market, or sourcing leads from agency listings needs the data in a structured form, not a page designed for a single visitor scrolling through photos. Manually copying listings is slow and does not scale past a handful of properties, and most teams end up either paying for an expensive data feed they do not fully need or building and maintaining their own scraper against a site that changes its front end without notice. This actor searches Fotocasa by operation, property type and location and returns every matching listing as clean JSON: price, size, rooms, features, agency and images, ready to load into a spreadsheet, CRM or pricing model, without writing or maintaining a single line of scraping code.

Overview

Give the actor an operation (buy, rent, shared room or vacation rental), a property type and a location slug, or a direct Fotocasa search URL, and it returns one record per listing matched, up to your maxItems cap. A search for a city the size of Madrid typically returns the first page of results within seconds; larger pulls scale with maxPages, roughly 30 listings per page. Pricing is pay-per-result: a fee per listing returned, nothing charged for pages that return no matches. Because the actor reads listing fields directly from Fotocasa's own search result pages, the data reflects whatever is published at the moment the run executes, including price changes and new listings added since your previous run.

Supported inputs

• Operation (operation) - comprar (sale), alquiler (rent), alquiler-habitacion (shared room) or alquiler-vacacional (vacation rental).
• Property type (propertyType) - viviendas (homes), oficinas (offices), locales (commercial), naves (warehouses), garajes (garages), trasteros (storage) or terrenos (land).
• Location (location) - a Fotocasa location slug such as madrid-capital, barcelona-capital, valencia-capital or sevilla-capital.
• Custom search URL (startUrl) - an optional direct Fotocasa search URL that overrides operation, property type and location for searches with filters not exposed as separate input fields (price range, specific features, etc, as configured directly on fotocasa.es).
• Max listings (maxItems) - up to 500 per run.
• Max pages (maxPages) - how many search result pages to walk, about 30 listings each.

Use cases

• PropTech and CRM feeds. Pipe Fotocasa listings directly into a property-comparison tool, CRM or client portal, refreshed on a schedule.
• Investment and yield research. Pull every sale listing in a district to calculate average price per square meter and spot under-priced properties relative to the neighborhood.
• Relocation services. Build a shortlist of rental listings matching a client's budget and city before they arrive in Spain.
• Agency and competitor monitoring. Track which agencies are most active in a given city or property type, and at what price points, by reading the agency field across a full search.
• Vacation rental market analysis. Use alquiler-vacacional to compare short-term rental pricing and availability across tourist areas.
• Lead generation for movers, renovators and mortgage brokers. Pull freshly listed properties in a target area and reach out to new sellers or buyers before competitors working from manual searches do.
• Portfolio tracking for landlords and small investors. Re-run the same search periodically to see how a specific set of listings changes price or disappears from the market, without manually revisiting each listing page.

How it works

The actor submits your search filters (or your direct URL) to Fotocasa's search pages the same way a visitor would, then walks the paginated result list up to maxPages or maxItems, reading each listing card directly from the search results. Every field returned (price, area, rooms, images, URL) comes from the listing as published on the page at scrape time.

Input configuration

Homes for sale in Madrid:

{ "operation": "comprar", "propertyType": "viviendas", "location": "madrid-capital", "maxItems": 100 }

Rentals in Barcelona, limited pages:

{
  "operation": "alquiler",
  "propertyType": "viviendas",
  "location": "barcelona-capital",
  "maxItems": 60,
  "maxPages": 2
}

Direct search URL with Fotocasa's own filters applied:

{
  "operation": "comprar",
  "location": "valencia-capital",
  "startUrl": "https://www.fotocasa.es/es/comprar/viviendas/valencia-capital/todas-las-zonas/l",
  "maxItems": 50
}

Output sample

Real listings from a production run (homes for sale, Madrid):

{
  "listingId": "190412393",
  "title": "Piso con 2 baños en Torrejón de Ardoz, Madrid",
  "propertyType": "Vivienda",
  "operation": "comprar",
  "price": 374600,
  "currency": "EUR",
  "area": 105,
  "rooms": 3,
  "bathrooms": 2,
  "location": "Madrid",
  "images": ["https://static.fotocasa.es/images/ads/c56dd5b3-7649-4207-8af8-fd9a148fafc6?rule=original"],
  "url": "https://www.fotocasa.es/es/comprar/vivienda/torrejon-de-ardoz/aire-acondicionado-calefaccion-parking-terraza-ascensor/190412393/d",
  "scrapedAt": "2026-09-30T17:54:31.435Z"
}

{
  "listingId": "190399711",
  "title": "Piso con 1 baño en Madrid, Madrid",
  "propertyType": "Vivienda",
  "operation": "comprar",
  "price": 489000,
  "currency": "EUR",
  "area": 43,
  "rooms": 1,
  "bathrooms": 1,
  "location": "Madrid",
  "url": "https://www.fotocasa.es/es/comprar/vivienda/madrid/calefaccion-ascensor-amueblado/190399711/d",
  "scrapedAt": "2026-09-30T17:54:31.435Z"
}

Key output fields

Field	Type	Description
listingId	string	Fotocasa internal listing ID
title	string	Listing headline as published
propertyType	string	e.g. Vivienda
operation	string	Matches the requested operation (comprar, alquiler, etc)
price	number	Listing price in EUR
pricePerSqm	number	Price per square meter, when Fotocasa publishes it
area	number	Size in square meters
rooms, bathrooms	number	Room counts
location, neighborhood	string	City and area
features	array	Amenities such as terrace, lift, AC, pool, when listed
agency	string	Listing agency name, when the listing is agency-managed
images	array	Listing photo URLs
url	string	Direct Fotocasa listing URL

Pricing

Pay per event:

Event	Price
Listing scraped	$0.005

Minimum charge per run: $0.05.

What makes this richer than the competition

Two other Store listings reach far more Fotocasa users than this actor today, both at a lower price. igolaizola/fotocasa-scraper ("Fotocasa Scraper - Real Estate data for Spain", 71 users/30 days) charges around $0.001 per actor start plus $0.001 per result, and covers sale, rent, shared, rent-to-buy and transfer across homes, offices, commercial, garages, land and buildings. azzouzana/fotocasa-es-search-results-scraper-by-search-url-ppr (39 users/30 days) charges $0.005 actor start plus $0.001 per result. Both are meaningfully cheaper per listing than our $0.005 flat fee. Where this actor holds its own is simplicity for direct-URL searches: a single startUrl input overrides every filter at once, so any search already built on fotocasa.es (including filters with no dedicated input field here) can be scraped without mapping every Fotocasa filter into this actor's schema.

Notes & limitations

• pricePerSqm, neighborhood, agency and description come back null when Fotocasa does not display them on a given listing; the actor never estimates a missing value.
• startUrl overrides operation, propertyType and location entirely; set it only when you need filters not exposed as separate inputs.
• Coverage is mainland Spain and the islands as published on fotocasa.es; the actor does not cover Fotocasa's Italy or other country sites.
• Energy certificate and full description text are not currently captured as structured fields; only what is listed in the Key Output Fields table above is returned.
• This actor is not affiliated with or endorsed by Fotocasa. It extracts publicly available listing data for research and business use.
• Results depend on Fotocasa's own search ranking and pagination; running the same search twice in quick succession can return overlapping but not byte-identical result sets if new listings were published in between.

FAQ

Can I search a neighborhood instead of a whole city? Use a more specific location slug if Fotocasa has one for that area, or build the search directly on fotocasa.es and pass the resulting URL as startUrl.

What happens when a search returns fewer listings than maxItems? The actor returns every matching listing and stops; you are only charged for listings actually returned.

Does this cover rentals as well as sales? Yes, set operation to alquiler for rent, alquiler-habitacion for shared rooms, or alquiler-vacacional for vacation rentals.

Why is agency sometimes empty? Some Fotocasa listings are posted directly by the owner rather than through an agency; in that case the field is null rather than guessed.

Is this affiliated with Fotocasa? No. This is an independent tool for extracting publicly available listing data. Please respect Fotocasa's terms of service when using the data.

For AI Agents & LLM Apps

This actor is available over the Apify MCP server (mcp.apify.com) for any MCP-compatible agent to call as a tool, and can be called synchronously from any backend via run-sync-get-dataset-items:

curl "https://api.apify.com/v2/acts/gio21~fotocasa-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -X POST -H "Content-Type: application/json" \
  -d '{"operation": "comprar", "propertyType": "viviendas", "location": "madrid-capital", "maxItems": 30}'

Disclaimer

Fotocasa is a trademark of its respective owner. This actor is an independent tool, not affiliated with, endorsed by or sponsored by Fotocasa. It extracts publicly available listing data for research and business use; respect Fotocasa's terms of service.

SEO Keywords

Fotocasa scraper, Fotocasa API, Spain real estate scraper, property data Spain, Fotocasa listings scraper.