Fotocasa Scraper

Fotocasa Scraper: Spanish property listings by town or search URL

Type a place like "Valencia" or paste a fotocasa.es search page, and get the listings back as rows. Asking price, price per m2, built surface, rooms, bathrooms, floor, neighbourhood, coordinates, the advertiser, the feature list and every photo link.

One thing to know before you start: Fotocasa has no server-side filter for agency versus private seller, so that filter is applied after each page is read. Ask for private sellers only in an agency-heavy town and you will get back fewer rows than you asked for. You are not charged for the ones it drops, and the run says how many there were.

🏠 What Fotocasa Scraper does

Give it a place and it looks the name up against Fotocasa's own index, picks the match with the most live listings, builds the search and pages through it. Or skip the lookup: set your filters on fotocasa.es, copy the address bar, and paste it in. Whatever you picked on the site travels with the URL.

It covers sales and rentals across eight property types: homes, garages, offices, commercial premises, land, rural houses, whole buildings and storage rooms. It also reads rooms in shared homes, rent-to-own homes and business transfers of commercial premises.

Price, surface, room, bathroom and publication-date filters are handed to Fotocasa, so listings outside them never reach you and never cost anything. The advertiser filter is one exception, described above. A search near a point is the other: Fotocasa ignores distance, so the run reads the place's listings and keeps the ones within radiusKm of your point, measured from each listing's own map position. Type the town or district the point is in, because a small circle in a big place comes back with fewer rows than you asked for.

Order matters more than it looks. Newest first is what the run uses because Fotocasa's own relevance order shuffles between requests, and paging deep into a shuffled list hands you the same flat twice.

📥 What you give it

{
  "location": "Valencia",
  "transactionType": "rent",
  "propertyType": "homes",
  "maxItems": 100,
  "minPrice": 800,
  "maxPrice": 2000,
  "minRooms": 2
}

📤 What you get back

A real row from a recent run, with the photo links trimmed and the list cut short:

{
  "id": "190879808",
  "adId": "41be50f4-1bff-49d8-aa31-7c64409b439a",
  "url": "https://www.fotocasa.es/es/alquiler/vivienda/valencia-capital/.../190879808/d",
  "transactionType": "rent",
  "propertyType": "home",
  "propertySubtype": "intermediate floor",
  "price": 1800,
  "priceText": "1.800 €",
  "pricePeriod": "month",
  "previousPrice": null,
  "pricePerM2": 15,
  "surfaceM2": 120,
  "rooms": 4,
  "bathrooms": null,
  "floor": null,
  "condition": null,
  "isNewConstruction": false,
  "address": "Els Orriols",
  "neighbourhood": "Els Orriols",
  "district": "Rascanya",
  "municipality": "Valencia",
  "province": "Valencia",
  "postcode": "46019",
  "latitude": 39.49346496734346,
  "longitude": -0.3712033344287845,
  "advertiserType": "agency",
  "advertiserName": "HOUSINGANYWHERE",
  "advertiserUrl": "https://www.fotocasa.es/es/pro/housinganywhere/",
  "phone": null,
  "features": ["furnished", "washing_machine", "tv", "pets_allowed", "laundry"],
  "images": ["https://static.fotocasa.es/images/ads/1cab486a-...?rule=original"],
  "imageCount": 10,
  "hasFloorPlan": false,
  "hasVirtualTour": false,
  "publishedAt": "2026-09-20T01:02:40.153Z",
  "searchUrl": "https://www.fotocasa.es/es/alquiler/viviendas/espana/...",
  "page": 1,
  "position": 1,
  "scrapedAt": "2026-09-20T02:42:01.740Z"
}

🧾 Reading the output

Three kinds of row can land in your dataset.

Filter on _sample and _diagnostic being absent. Start a run with nothing filled in and you get the sample row and nothing else, so you can see the field shape before spending anything.

One bad URL never stops the others, and a diagnostic row never fails the run.

▶️ How to run it

1. Open Fotocasa Scraper and click Try for free. 2. Type a town into Place, or paste search pages into Fotocasa search URLs. 3. Pick Buy or rent and a Property type. 4. Set Maximum listings. Start around 20 to see the shape of the output. 5. Click Start, then download the dataset as JSON, CSV or Excel, or read it from the Apify API.

💰 How much does it cost?

$0.65 per 1,000 listings. Flat on every Apify plan, no volume tiers.

You pay per listing row delivered. Duplicates found twice across searches, listings dropped by the advertiser filter or the radius, the sample row and diagnostic rows are all free.

💡 What people use it for

• Tracking asking prices in one neighbourhood week by week, with sortType on publicationDate and

id as the dedupe key.

• Pulling everything a single estate agency has listed in a province, using advertiser.
• Building a price-per-m2 picture of a town before buying, since pricePerM2 comes straight off the

listing rather than being worked out afterwards.

• Finding private-seller rentals under a budget, which is the search most people build by hand and

then reload every morning.

🚧 What it does not do

• No contact details beyond what the advertiser published. phone is null on most listings and

there are no email addresses at all.

• A bare province name gives you the province. "Valencia" resolves to whichever match has the

most live ads. Set locationLevel to MUNICIPALITY if you meant the city.

• The advertiser filter runs after the page is read, so it can return fewer rows than maxItems.
• Fields the advertiser left blank come back null. Bathrooms, floor and condition are missing

often enough that you should plan for it.

• Coordinates are Fotocasa's, and on some listings they mark the street, not the building.
• The radius is applied here, not by Fotocasa. The place still decides which listings are read,

and the run stops reading a search where fewer than 1 listing in 50 falls inside the circle. The smallest radius is 1 km.

• Photo links point at Fotocasa's image servers. Fine to fetch now, not an archive.
• Rows are a snapshot. A flat can be sold, relisted or repriced an hour later, and scrapedAt

records when it was read.

• Spain only. Fotocasa does not list anywhere else.

🧭 Which property scraper do you need?

❓ Questions people ask

Do I need a Fotocasa account? No. Nothing to sign up for and no key to manage.

Can I just paste a search I already built on the site? Yes, that is usually the best way. Put the address-bar URL into startUrls and every filter you set comes with it.

Why did I get fewer listings than I asked for? Either the search does not have that many, or the advertiser filter or the radius dropped some. The diagnostic row tells you which.

Can I watch one area over time? Yes. Schedule it, keep sortType on publicationDate, and dedupe on id. New listings arrive at the top.

Does it read rentals as well as sales? Both. Set transactionType, or paste a rental URL.

Is scraping property listings legal? These are public adverts on a public site. Some rows carry an advertiser's name and phone number, which is personal data under GDPR, so have a reason for collecting it. Apify's write-up on scraping and the law is a sensible starting point, and we are not lawyers.

🆘 If something breaks

Open the Issues tab on the actor page. Send the run ID and the place or URL you used. The errorCode on the diagnostic row usually names the problem on its own.