Fotocasa Scraper: Spain Property Listings, Prices, Agents
Pricing
from $0.63 / 1,000 listings
Fotocasa Scraper: Spain Property Listings, Prices, Agents
Scrape Fotocasa and Habitaclia property listings in Spain by place or search link: price, price per m2, size, rooms, bathrooms, address, coordinates, photos, agency name and phone, published date. Buy, rent, share. No login.
Pricing
from $0.63 / 1,000 listings
Rating
0.0
(0)
Developer
The Mine Works
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
7 days ago
Last modified
Categories
Features
Share
Returns Fotocasa property listings in Spain by place name or search link, one row per listing with price, price per m2, size, bedrooms, bathrooms, address, coordinates, photos, published date and the agency with its phone. Habitaclia, Fotocasa's sister site, is in the same actor and adds the agency email and the energy certificate. No login, no cookies, no API key. You pay $0.90 per 1,000 listings on the Free plan and $0.63 per 1,000 on the Gold plan, plus a $0.001 start fee per run.
From The Mine Works, with over 335,000 runs across 330+ public actors.
Updated 12 Nov 2026: first release. Fotocasa and Habitaclia, buy, rent, rooms to share and business transfers, homes, garages, land, premises, offices, storage rooms and buildings, price, size, bedroom and bathroom filters, six sort orders and a "published in the last N days" switch for daily alerts, one flat row per listing. Bookmark this Actor on its Store page so it is one click away next time.
Why choose this actor?
- Type a place, get listings. Write Madrid, Chamberi, Marbella or Costa del Sol the way you would on the site; the actor looks the place up in the site's own location search and reads every results page. Or paste a search link with the filters you already set on Fotocasa or Habitaclia.
- The numbers you compare, in columns.
price,price_per_m2,price_drop,size_m2,rooms,bathroomsandfloorare separate fields, withlatitudeandlongitudeon every row, so a whole city sorts by euros per m2 in a spreadsheet without cleaning text. - The agency next to the listing. Agency name, page on the site and public phone on Fotocasa; on Habitaclia also the email, website and agency reference.
advertiser_typetells agencies from private sellers. In our 1,500 row Fotocasa rental test, 1,068 rows carried an agency phone; on Habitaclia 300 of 300 rows carried phone and email. - Pay per listing, nothing for errors. Places the site does not know, links from other sites, the summary row and listings found twice in one run are never charged.
Part of The Mine Works Real estate family: Zillow Rentals Scraper, Zillow Sold Comps Scraper, India Real Estate MCP, Housing.com Scraper, 99acres Scraper, MagicBricks Scraper.
Try it in one minute
Paste this into the input (JSON view) and press Start. It returns the first 60 homes for sale in Madrid. It took 5 seconds in our test run on Apify:
{"locations": ["Madrid"],"maxItems": 60}
Put several places on separate lines to run several searches at once, or paste Fotocasa and Habitaclia search links into startUrls. A listing that two of your searches find is delivered once.
Apify's free plan includes $5 of credit every month, which covers about 5,500 listings at this actor's price.
Copy to your AI assistant
themineworks/fotocasa-scraper on Apify. Reads Spanish property listings from Fotocasa (and Habitaclia) by place name or search link and returns one flat row per listing, no login. Call ApifyClient("TOKEN").actor("themineworks/fotocasa-scraper").call(run_input={"locations": ["Madrid"], "operation": "rent", "maxItems": 200}), then client.dataset(run["defaultDatasetId"]).list_items().items. Give locations (place names in Spain) or startUrls (fotocasa.es or habitaclia.com search results links) or both; up to 100 searches. Optional: site (fotocasa or habitaclia, default fotocasa, for place names), operation (buy, rent, share, transfer), propertyType (homes, garages, land, premises, offices, storage, buildings, industrial), maxItems (default 100, 1 to 10000, per search), sortBy (relevance, newest, cheapest, most_expensive, largest, smallest), minPrice, maxPrice, minSize, maxSize, minRooms, minBathrooms, publishedWithinDays. Listing rows have no _type field and carry site, listing_id, url, title, operation, property_type, property_subtype, price, currency, price_period, price_per_m2, price_drop, size_m2, rooms, bathrooms, floor, features, address, neighborhood, district, municipality, province, region, zip_code, latitude, longitude, description, image_urls, image_count, has_virtual_tour, is_new_construction, development_name, agency_name, agency_id, agency_url, agency_phone, agency_email, agency_website, advertiser_type, energy_rating, energy_consumption, emissions_rating, reference, published_at, updated_at, is_top, search_input, search_location, page, position, scraped_at. Each run also writes one row with _type "summary", one with _type "info" when listings were delivered, and a row with _type "error" for each input that could not be read; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~fotocasa-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme.
Key features
- Place names or links. A town, city, district, neighbourhood or province name is matched in the site's own location search; the summary row shows which place was matched. A pasted results link keeps its own location and filters, such as
?maxPrice=1500. - Two portals, one row shape. Fotocasa covers all of Spain. Habitaclia, from the same group, is strongest in Catalonia and adds
agency_email,agency_website,reference,energy_rating,energy_consumptionandemissions_rating. Every row says whichsiteit came from. - Buy, rent, share and transfers. Homes (flats, houses, penthouses, duplexes, studios), garages, land, commercial premises, offices, storage rooms, buildings and, on Habitaclia, industrial units.
- Filters and six sort orders. Price, size, bedrooms and bathrooms, sorted by relevance, newest, cheapest, most expensive, largest or smallest.
- New listing alerts.
publishedWithinDays: 1sorts by newest and stops at the first page older than a day, so a daily scheduled run pays only for what is new. - Deep searches. Fotocasa serves 30 listings a page and Habitaclia 20; the actor reads page after page to the end of the results, 12,000 and more for a big city on Fotocasa (Habitaclia stops at 10,000 per search).
- Stops cleanly. A refused call is retried on a new IP; six failed calls in a row end the run; the run stops before its time limit and keeps every row it read. The summary row says why.
How to use it
Basic: homes for sale in one city
{"locations": ["Valencia"],"maxItems": 300}
Rentals with filters in several cities
{"locations": ["Barcelona", "Valencia", "Sevilla"],"operation": "rent","minRooms": 2,"maxPrice": 1800,"maxItems": 500}
Habitaclia agencies with email in Catalonia
{"site": "habitaclia","locations": ["Girona", "Tarragona", "Sabadell"],"maxItems": 200}
Daily alert: new listings since yesterday
{"locations": ["Madrid", "Malaga"],"publishedWithinDays": 1,"maxItems": 1000}
Save it as a task and schedule it every morning.
Your own search link
{"startUrls": ["https://www.fotocasa.es/es/comprar/viviendas/marbella/todas-las-zonas/l?minPrice=500000","https://www.habitaclia.com/comprar/viviendas/barcelona-provincia/barcelona-capital/s"],"maxItems": 150}
Input parameters
| Parameter | Type | Default | What it does |
|---|---|---|---|
locations | list of text | Places in Spain, one per line. Each is one search. | |
site | text | fotocasa | fotocasa or habitaclia, for place names. Links are read on their own site. |
operation | text | buy | buy, rent, share (rooms) or transfer (traspasos, Fotocasa only). |
propertyType | text | homes | homes, garages, land, premises, offices, storage, buildings, industrial. |
startUrls | list of links | Fotocasa or Habitaclia results links. | |
maxItems | number | 100 | Most listings per search, 1 to 10,000. |
sortBy | text | relevance | relevance, newest, cheapest, most_expensive, largest, smallest. |
minPrice, maxPrice | number | Euros; monthly rent for rentals. | |
minSize, maxSize | number | Built area in m2. | |
minRooms, minBathrooms | number | Fewest bedrooms or bathrooms. | |
publishedWithinDays | number | Only listings published in the last N days (sorts by newest). | |
proxyConfiguration | proxy | Apify datacenter | Change only if you have a reason. |
What data do you get?
| Field | What it is |
|---|---|
site, listing_id, url | Portal, listing id and link |
title | Listing title on Habitaclia; type, operation and place on Fotocasa |
operation, property_type, property_subtype | buy or rent; home, garage and so on; flat, penthouse, studio, house_chalet and so on |
price, currency, price_period | Asking price in EUR; month for rentals |
price_per_m2, price_drop | Euros per m2; euros the price was cut by, when the site shows it |
size_m2, rooms, bathrooms, floor | Built area, bedrooms, bathrooms, floor |
features | Amenities such as elevator, parking, terrace, air_conditioner, swimming_pool |
address, neighborhood, district, municipality, province, region, zip_code | Location as the listing shows it |
latitude, longitude | Map position |
description, image_urls, image_count, has_virtual_tour | Full text and photo links |
is_new_construction, development_name | New build flag and development |
agency_name, agency_id, agency_url, agency_phone | Advertiser and its public phone |
agency_email, agency_website, reference | Habitaclia only |
advertiser_type | professional or private |
energy_rating, energy_consumption, emissions_rating | Energy certificate, Habitaclia only |
published_at, updated_at, is_top | Dates and paid top placement |
search_input, search_location, page, position, scraped_at | Where the row came from |
Private sellers' phones are not shown in search results on either site, so agency_phone is empty for them.
Output example
{"site": "fotocasa","listing_id": "191300433","url": "https://www.fotocasa.es/es/alquiler/vivienda/barcelona-capital/aire-acondicionado-calefaccion-ascensor-amueblado-television-se-aceptan-mascotas-internet/191300433/d","title": "apartment for rent in Carrer de París, 127, Eixample","operation": "rent","property_type": "home","property_subtype": "apartment","price": 2750,"currency": "EUR","price_period": "month","price_per_m2": 28.65,"price_drop": 763,"size_m2": 96,"rooms": 3,"bathrooms": 2,"floor": "11","features": ["air_conditioner", "heater", "elevator"],"address": "Carrer de París, 127, Eixample","neighborhood": "L'Antiga Esquerra de l'Eixample","district": "Eixample","municipality": "Barcelona Capital","province": "Barcelona","region": "Cataluña","zip_code": "08036","latitude": 41.390495,"longitude": 2.1487722,"image_count": 16,"agency_name": "Ukio","agency_url": "https://www.fotocasa.es/es/pro/ukio/","agency_phone": "+34623119277","advertiser_type": "professional","published_at": "2026-11-04T10:57:51.47Z","search_input": "Barcelona","page": 1,"position": 10}
A Habitaclia row has the same fields plus, for example, "agency_email": "info@agency.es", "energy_rating": "E", "energy_consumption": 188 and "reference": "5295V".
Pricing
Pay per event: you pay for the listings you receive, plus a flat $0.001 per run, whatever memory you choose.
| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
listing-scraped | Once per listing row stored in your dataset | $0.90 per 1,000 | $0.81 per 1,000 | $0.72 per 1,000 | $0.63 per 1,000 |
run-start | Once per run, after the first results page returned listings | $0.001 | $0.001 | $0.001 | $0.001 |
The price of one listing is the price per 1,000 divided by 1,000.
Never charged:
- places the site does not know, and links that are not Fotocasa or Habitaclia results (each gets an error row);
- a listing that a second search of the same run finds again;
- listings older than
publishedWithinDays, and listings past yourmaxItems; - the summary, info and error rows;
- a run whose searches return no listings: the start fee is charged only once a results page has returned listings;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit, so the run ends SUCCEEDED with a partial result and a status message saying so.
How it compares
| Actor | Price per 1,000 on the Free plan | Start fee | Input | Habitaclia | Agency phone |
|---|---|---|---|---|---|
| This actor | $0.90 | $0.001 per run | Place names or search links | Yes, with email and energy certificate | Yes |
| Fotocasa Scraper by igolaizola | $1.00 | $0.001 per GB of memory | Location name or coordinates and radius | not stated | Yes |
| Fotocasa.es Spain Real Estate Scraper by azzouzana | $1.00; full listing details $1.75 more | $0.005 per GB of memory | Search links | not stated | Yes |
| Fotocasa Property Scraper by memo23 | $0.99; detail page data $0.80 more | $0.00005 per GB of memory | Search links or location | not stated | Yes |
Checked 11 Nov 2026 from the public Store listings.
Run it on a schedule
- Open the actor in Apify Console, set your input and click Save as a new task.
- In the task, open Schedules, click Add schedule and pick how often (every day, every Monday at 08:00 and so on).
- Use
publishedWithinDays: 1for new listings only, or compare runs onlisting_idandpriceto see price cuts and listings that left the market. - Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.
FAQ
What does this actor read?
The same public search results fotocasa.es and habitaclia.com load in your browser when you search a place, as anyone sees them without logging in. It does not log in, contact advertisers or read anything behind an account.
Do I need an account, cookies or an API key?
No account, no cookies and no API key. Nothing to set up; the proxy is included.
How many listings can I get?
Up to 10,000 per place or link and 100 searches per run. Fotocasa shows every result of a search page by page (12,835 for homes for sale in Madrid in our test); Habitaclia stops at 10,000 per search. For more, split a province into towns or add filters.
Which place does a name match?
The best match in the site's own location search, preferring a town whose name is exactly what you typed. The summary row and the search_location field show the match. For a district or neighbourhood, type its name (Chamberi, Eixample); for an exact area, paste a results link instead.
Why do some rows have no price or no phone?
Some advertisers hide the price ("a consultar") and private sellers' phones are not shown in search results; those fields are then empty rather than guessed. In our tests, 3 of 2,392 rows had no price.
What is the difference between Fotocasa and Habitaclia rows?
Same fields and same row shape. Habitaclia also returns the agency email, website and reference and the energy certificate; Fotocasa returns the agency page link. Habitaclia has no rooms to share, transfers, premises or storage rooms filter.
How long does a run take?
In our tests on Apify (12 Nov 2026): 5 seconds for the "Try it" input (60 listings), 90 seconds for 1,500 rentals in Barcelona, Valencia and Sevilla, and 35 seconds for 300 Habitaclia listings in three cities.
Which formats can I download?
JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API. In CSV and Excel, lists such as image_urls and features are flattened into columns.
Can I use it from Claude, ChatGPT or Cursor (MCP)?
Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/fotocasa-scraper
- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code:
claude mcp add -t http fotocasa-scraper "https://mcp.apify.com/?tools=themineworks/fotocasa-scraper"
Is it legal to scrape Fotocasa?
The actor reads only public listings that anyone can see without logging in: properties, prices and agency contacts that advertisers publish to be found. Listings can include personal data, such as a private seller's name, so you are responsible for how you use the data, including the sites' terms and data protection law such as GDPR and Spain's LOPDGDD. This is general information, not legal advice.
Integrations
- Google Sheets: send each run's listings to a sheet with Apify's Google Sheets integration; one row per listing fits a sheet as is.
- Make, Zapier and n8n: start a run and read its dataset with the Apify apps and nodes, for example "new flats under 300,000 EUR in Valencia every morning to Slack".
- Webhooks: have Apify call your URL when a run succeeds, then fetch the dataset.
- API and SDKs: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- MCP clients: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.
If this actor saved you time, a short rating on the Store helps other buyers find it.
More from The Mine Works
Real estate
- Zillow Rentals Scraper
- Zillow Sold Comps Scraper
- India Real Estate MCP
- Housing.com Scraper
- 99acres Scraper
- MagicBricks Scraper
- Zillow Property Scraper
- Zillow Photos Scraper
- Real Estate MCP
- Airbnb Scraper
- Domain.com.au Property Scraper
- realestate.com.au Scraper
Social media and video
Leads and business directories
Marketing, SEO and reviews
Science, health and government data
Jobs and hiring
Company and business data
E-commerce and marketplaces
Food and local services
Developer and AI tools
More tools
Support
Found a place that returns fewer listings than the site, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new source, email dmineworks@gmail.com.
Search Fotocasa and Habitaclia by place or link and get every property back as one row, with price, price per m2, size, rooms, address, coordinates, photos and the agency with its phone, no login.

