Fotocasa Spain Real Estate Scraper — Agency Leads & Price Monitor (MCP)

Scrape Fotocasa.es, Spain's #1 property portal (471 000+ live listings), for sale or rent, in all 50 provinces — one clean row per property, no browser, no proxies, no account.

Find → Compare → Monitor → Alert. Every row comes with the data buyers, exporters and agencies actually pay for:

What you get	Why it matters
Agency telephone number (phone) on 100 % of listings checked	Lead generation without opening a single detail page
Price-reduction flag (isPriceReduced, reducedAmount)	Fotocasa's own "rebajado" signal — the buying opportunity
Full decoded specs	surface m², rooms, bathrooms, floor, age + every amenity code (pool, terrace, lift, storage, furnished…)
Days on market + original publication date	spot stale listings whose owner will negotiate
Location precision	province, municipality, city, district & barrio, zip, GPS coordinates
Photos & media flags	up to 25 original-size photo URLs, video, floorplans, virtual tour
Special situations	auctions (subasta), bare ownership, occupied, rented with tenants, VPO subsidies, new developments

Hard problems this Actor solves

1. The 10 323-listing cap. Every Fotocasa search silently stops at page 333 (31 listings per page); go deeper and the site just re-serves the last page — no error, no warning. This Actor knows the cap, detects page rotation, and splits the query recursively: price bands → rooms → surface, merging by unique listing id. "All of Madrid province" or "Spain" is the whole market, not a sample. Every split and its result count is written to the run log, so you can audit coverage.
2. Filters that really work. Price, surface and rooms filters are honoured by Fotocasa only as query parameters — and an explicit min*=0 makes the site answer 404. The Actor knows both traps and builds clean queries (we found and fixed this on the live site before shipping).
3. Honest monitoring. State lives in an Apify key-value store, one history per search scope. You get new, price_dropped / price_increased (with oldPrice, delta and %), and closed — the last one only when the scan was complete and error-free, never on a failed request or a truncated scope.

Quick examples

• Agency leads in Barcelona — buy, barcelona-capital, no other filter → every listing with the agency's name and phone number.
• Cheap flats in Madrid — madrid-capital, maxPrice: 150000, minRooms: 2.
• Rentals in Valencia — operation: rent, valencia-capital, maxPrice: 1200.
• A whole province — madrid (province) or espana (whole country) with autoSplit on.
• Daily price-drop watch — mode: monitor on a schedule: only new listings and price cuts come back.
• Auctions & opportunities — look at isAuctioned, isOpportunity, isBareOwnership, isRentedWithTenants flags in the output.

Input tips

• locations: Fotocasa segments — espana, madrid, barcelona, madrid-capital, barcelona-capital, valencia-capital, madrid-capital/chamberi… spaces and accents are fine.
• propertyType: viviendas (homes, default) or a specific segment (pisos, chalets, aticos, locales, garajes, …).
• addedWithinDays: with "newest first" sorting the Actor stops as soon as it reaches older ads — perfect for cheap incremental runs.
• maxResults: global cap on rows returned (and billed); the run stops cleanly when reached.
• stateKey: leave empty; the monitor history key is derived from your search scope.

Automation, MCP & scheduling

• Schedule: run monitor daily (or hourly). Unchanged listings are not returned and not charged — only the deltas land in your dataset.
• Integrations: pipe the dataset to Google Sheets, Airtable, Slack, n8n, Zapier or your own API in one click through the Apify platform.
• MCP-ready for AI agents: exposed through Apify's Model Context Protocol server as amygraphics/fotocasa-spain-scraper, so agents (Claude, Cursor, VS Code, custom agents) can find and run it — and pay autonomously (this Actor is whitelisted for agentic payments, x402 / AGI).

{
  "mcpServers": {
    "apify": { "url": "https://mcp.apify.com?tools=amygraphics/fotocasa-spain-scraper" }
  }
}

Ask it things like:

• "Find flats for sale in Madrid under €200 000 with at least 3 rooms and give me the agencies' phones."
• "Which listings in Barcelona dropped their price? Set it up to run every morning."
• "Get me every chalet for sale in the province of Madrid with a pool."

Pricing

Pay-per-event: $0.001 start + $0.002 per property (property-extracted) — $2 per 1 000 listings, cheaper than every pay-per-event Fotocasa Actor in the Store. Monitor mode only charges for new, changed and closed listings.

Notes & fair use

Publicly available listing data from Fotocasa search pages. Agency names and phone numbers are business contact data the agencies publish on their own adverts — if you use them for outreach, that outreach is your responsibility: follow your local e-mail/phone marketing rules (EU GDPR + ePrivacy for individuals), Fotocasa's terms, and keep request rates polite (the Actor throttles itself and retries 429/5xx with backoff).

---

En español (breve)

Scraper de Fotocasa para toda España: venta y alquiler, cualquier provincia, ciudad o barrio. Cada fila incluye el teléfono de la agencia, si el precio está rebajado (con el importe), superficie, habitaciones, baños, fotos, GPS, días en el mercado y los códigos de características (piscina, terraza, ascensor, amueblado…). Fotocasa corta en silencio cada búsqueda en la página 333 (10 323 anuncios): este Actor lo detecta y divide la búsqueda por precio → habitaciones → superficie para que el mercado completo esté cubierto. Modo monitor: sólo anuncios nuevos, bajadas de precio y retirados. 2 $ por 1 000 anuncios.

Palabras clave

Fotocasa scraper · API alternativa a Fotocasa · pisos Madrid · España inmobiliaria · alquiler España · teléfonos de agencias · price monitor · bajadas de precio · datos inmobiliarios España · agente IA inmobiliario · MCP inmobiliaria.