Fotocasa Scraper

Extract property listings from Fotocasa — no browser, no captchas, clean JSON in seconds.

👋 Hola equipo — este scraper es para vosotros, usadlo con cariño.

Questions or issues? Reach us at info@inmocalc.com

---

What it does

Two modes in one actor:

Mode	When to use it
Search	Get all listings in an area — an entire city, page after page
Find location code	Look up the area code you need before searching

Fill in one, leave the other empty. Search is the default — just hit Start and you get Madrid Capital homes for sale out of the box.

---

Why this one?

Fotocasa sits behind Imperva's anti-bot protection, which trips up most scrapers. We call the same private mobile API the Fotocasa Android app uses, so there's no browser overhead and no HTML parsing — just clean, structured data at a price that makes sense.

---

Mode 1 — Search

Get all listings in an area matching your filters.

How to use it

Step 1 — Fill in the fields

Field	What to enter
Location code	The code for the area you want to scrape — see below
Transaction type	Sale, Rent, Transfer, Share, Rent with option to buy or Holiday rental
Property type	Homes for flats and houses, or garages, land, offices, etc.

Everything else has sensible defaults. Leave the filters blank to get everything.

Step 2 — Hit Start

The scraper runs page by page and saves results to the dataset as it goes. You can watch data come in before it finishes.

Step 3 — Download your results

When done, go to Storage → Dataset and export as CSV, JSON or Excel.

How to find a location code

Fotocasa areas are identified by a combinedLocationIds string — a comma-separated code like 724,14,28,173,0,28079,0,0,0.

⚠️ Use the full string, not just the municipal number. A bare code like 28079 returns results for all of Spain, not just Madrid.

Option A — use the built-in lookup (easiest) Fill in the Find location code field (Mode 2 below) with a place name, run the actor, and copy the code you need.

Option B — use a known code

Area	Location code
Madrid Capital	724,14,28,173,0,28079,0,0,0
All of Spain	724

Output fields

Each listing includes:

Field	Description
property_id	Fotocasa listing ID
url_marketplace	Direct link to the listing on Fotocasa
price	Price in €
price_description	Price as shown on the site (e.g. 1.200 €/month)
surface	Area in m²
rooms / bathrooms	Bedrooms and bathrooms
property_type	HOME, GARAGE, LAND, etc.
transaction_type	SALE, RENT, etc.
location_description	Area / neighbourhood text
latitude / longitude	Coordinates for mapping
orientation	Property orientation
is_development	Whether it's a new development
payment_periodicity	For rentals — monthly, etc.
agency_name	Listing agency, if any
has_tour_virtual	Virtual tour available
has_video	Video available
diff_price	Price change vs. a previous value
list_date	Publication date
photo	Main photo URL
comments	Full listing description

Limits

• No hard per-run cap — the scraper paginates through every available page for the area. A full city like Madrid is ~570 pages (~11,000 listings) and takes roughly 20–30 minutes with polite random delays between requests.
• Set Max pages if you only want a sample — leave it at 0 to scrape everything.
• All filters are optional — price, surface, rooms and bathrooms can all be left blank.

---

Mode 2 — Find location code

Not sure what location code to use? Run this mode first.

How to use it: fill in the Find location code field with a place name (e.g. madrid, barcelona, valencia). The Search section is ignored.

Output

Field	Description
text	Human-readable area name (e.g. Madrid Capital, Madrid)
combinedLocationIds	The code to copy into the Search section
subtitle	Extra area detail

---

Advanced — if runs start failing

Fotocasa's Imperva protection requires a token (x-d-token) that ships with the actor. If runs suddenly return 403 ("Pardon Our Interruption"), the token needs refreshing:

• Capture a fresh x-d-token from the Fotocasa Android app with mitmproxy and paste it into the Imperva token field in the Advanced section.
• Runs go through a residential proxy by default. To use your own proxy, set the PROXY_URL environment variable.

---

Tips

• Each run creates a new dataset — results are saved separately per execution, so you can compare runs.
• Leave Items per page at 20 — it's the value the app uses; the API adds a couple of promoted items on top, which the scraper filters out automatically.
• Mode priority: if you fill in both sections, Find location code takes priority over Search.