Fotocasa Property Scraper

What does Fotocasa.es Property Scraper do?

Fotocasa.es Property Scraper collects structured property listings from public Fotocasa search pages in Spain. Provide a Fotocasa listing URL, set the maximum number of records and pages, and receive a clean Apify dataset containing property ads and new-home promotions.

The output is useful for Spanish real estate market research, asking-price comparisons, property investment analysis, agency research, lead generation, inventory monitoring, and recurring market snapshots. Records include listing URLs, prices, rooms, bathrooms, surface area, locations, coordinates, agency details, publication dates, and available photo URLs.

Why use Fotocasa.es Property Scraper?

• Collect Spanish property data - Gather sale or rental listings for Spain-wide searches, cities, provinces, and local areas supported by Fotocasa.
• Compare asking prices - Analyze prices alongside rooms, bathrooms, surface area, location, and transaction type.
• Track regular ads and developments - Receive standard property ads and new-home promotions in the same run.
• Research agencies and inventory - Use agency names, agency IDs, listing URLs, and property details to study local supply and publishers.
• Create clean datasets - Duplicate listing IDs are skipped, and empty values are removed before records are saved.
• Automate repeat collection - Run on demand or use Apify schedules, webhooks, exports, and integrations for recurring monitoring.

What data can you extract from Fotocasa.es?

The Actor saves one dataset item for each unique property ad or promotion. Fields are included when Fotocasa publishes a usable value.

Field	Type	Description
itemType	String	Record type: ad for a standard listing or promotion for a new-home development.
id	String or Number	Source identifier for the listing or promotion.
propertyId	String or Number	Property identifier for a standard ad, when available.
realEstateAdId	String or Number	Real estate ad identifier, when available.
promotionId	String or Number	New-home promotion identifier for promotion records.
title	String	Listing headline or promotion name.
description	String	Property or promotion description when published.
url	String	Absolute public Fotocasa URL for the record.
price	Number	Asking price for a standard ad.
minPrice	Number	Lowest published price for a promotion.
maxPrice	Number	Highest published price for a promotion.
priceType	String	Transaction label such as sale or rental type.
currency	String	Currency code, normally EUR for Spanish listings.
rooms	Number	Room count for a standard ad.
baths	Number	Bathroom count for a standard ad.
minRooms / maxRooms	Number	Minimum and maximum room counts for a promotion.
minBaths / maxBaths	Number	Minimum and maximum bathroom counts for a promotion.
surface	Number	Built surface area in square meters for a standard ad.
minSurface / maxSurface	Number	Minimum and maximum surface area for a promotion.
location	String	Human-readable location hierarchy.
latitude / longitude	String or Number	Coordinates when published by Fotocasa.
street	String	Street name when available.
number	String or Number	Street number when available.
zipCode	String	Postal code when available.
agencyName	String	Publishing agency name.
agencyId	String or Number	Publishing agency identifier.
hasPhotos	Boolean	Whether a standard ad has photos.
hasVideos	Boolean	Whether a standard ad has videos.
photosCount	Number	Number of photos reported for a standard ad.
photoUrls	Array	Available property or promotion photo URLs.
previewImage	String	First available photo URL for previewing the record.
publicationDate	String	Original publication or promotion creation date.
alterDate	String	Last update timestamp when available.
keyDeliveryDate	String	Expected delivery date for a promotion when published.
adsCount	Number	Number of units or ads represented by a promotion.

Promotion records can also include minPrice, maxPrice, minRooms, maxRooms, minBaths, maxBaths, minSurface, maxSurface, adsCount, and keyDeliveryDate instead of the single-property values used by standard ads.

How to scrape Fotocasa.es data

1. Open Fotocasa and create a public search for the transaction type, property category, and location you need.
2. Copy the complete listing search URL.
3. Open this Actor in Apify and paste the URL into startUrl.
4. Set maxItems and maxPages for the size and depth of the collection.
5. Add proxy settings only when your run requires them.
6. Start the run and review the dataset preview.
7. Download the results or connect the dataset to your property workflow.

The URL determines the search scope. The default URL collects homes for sale across Spain. Use a different Fotocasa search URL to target a supported sale or rental search and a specific area.

Input Parameters

Parameter	Type	Required	Default	Description
startUrl	String	No	https://www.fotocasa.es/en/buy/homes/espana/all-zones/l	Public Fotocasa listing URL. The transaction type, property path, and location are read from the URL when supported.
maxItems	Integer	No	20	Maximum number of unique ads and promotions to save. Minimum value is 1.
maxPages	Integer	No	20	Maximum number of result pages to inspect. Use this as a safety limit for larger searches. Minimum value is 1.
proxyConfiguration	Object	No	{"useApifyProxy": false}	Optional Apify Proxy configuration for larger or repeated runs.

Usage Examples

Basic Spain-wide collection

Collect up to 20 property records from the default Spain-wide home-sale search:

{
  "startUrl": "https://www.fotocasa.es/en/buy/homes/espana/all-zones/l",
  "maxItems": 20,
  "maxPages": 20
}

Focused local search

Use a public Fotocasa search URL for a specific city or area and keep the run small while validating the result scope:

{
  "startUrl": "https://www.fotocasa.es/en/buy/homes/barcelona-provincia/l",
  "maxItems": 50,
  "maxPages": 5
}

Larger run with Apify Proxy

Use optional proxy settings for a larger or recurring collection:

{
  "startUrl": "https://www.fotocasa.es/en/buy/homes/espana/all-zones/l",
  "maxItems": 100,
  "maxPages": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Sample Output

The following example shows a standard Fotocasa property ad. Optional fields are omitted when the source does not provide them.

{
  "itemType": "ad",
  "id": "1_188957600",
  "propertyId": "188957600",
  "realEstateAdId": "188957600",
  "title": "Se vende fantástico piso en pleno centro",
  "description": "Se vende fantástico piso en pleno centro, con buena distribución y acceso a servicios.",
  "url": "https://www.fotocasa.es/en/buy/home/cornella-de-llobregat/centre/188957600/d",
  "price": 225000,
  "priceType": "SALE",
  "currency": "EUR",
  "rooms": 2,
  "baths": 1,
  "surface": 58,
  "location": "Centre, Cornellà de Llobregat, Barcelona, Cataluña, España",
  "latitude": "41.3520855",
  "longitude": "2.0722905",
  "agencyName": "Propiaria Sl",
  "agencyId": "9202773325645",
  "hasPhotos": true,
  "hasVideos": true,
  "photosCount": 25,
  "photoUrls": [
    "https://static.fotocasa.es/images/ads/13b66787-a341-4551-8c96-832e140101bc?rule=original"
  ],
  "previewImage": "https://static.fotocasa.es/images/ads/13b66787-a341-4551-8c96-832e140101bc?rule=original",
  "publicationDate": "2026-07-28T09:15:00.000Z",
  "alterDate": "2026-08-01T11:20:00.000Z"
}

A promotion item uses itemType: "promotion" and can contain price, room, bathroom, and surface ranges rather than single-property values.

Tips for Best Results

• Start with a focused URL - Apply the transaction type, location, and property scope on Fotocasa before copying the search URL.
• Test a small run - Begin with maxItems: 20 and a low maxPages value so you can confirm the search scope and field quality.
• Match the limits - Increase maxPages when the search has more inventory, but keep it aligned with maxItems for predictable runs.
• Compare stable fields - Use id, url, price, surface, location, publicationDate, and alterDate when comparing scheduled datasets.
• Use media fields carefully - photoUrls may contain many URLs. Use previewImage for compact previews and photosCount to measure media coverage.
• Expect optional values - Coordinates, agency details, dates, videos, and some property attributes may be missing when Fotocasa does not publish them.
• Review promotions separately - Filter by itemType when you need only individual ads or only new-home developments.
• Use proxy settings for scale - Optional Apify Proxy configuration can help with larger or repeated runs, but it does not guarantee a complete result set.

Integrations and Export Formats

• Apify API - Retrieve dataset records programmatically for dashboards, property portals, analysis tools, and internal applications.
• Google Sheets - Review prices, locations, and agency inventory in a spreadsheet.
• Airtable - Build a searchable property database with views for areas, agencies, prices, or record types.
• Make or Zapier - Send new dataset items to notifications, CRM workflows, reporting tools, or enrichment steps.
• Webhooks - Trigger downstream processing after an Actor run finishes.
• JSON - Use structured records in applications and data pipelines.
• CSV or Excel - Analyze listings in spreadsheet tools and prepare market reports.
• XML - Support workflows that require XML exports.

Frequently Asked Questions

Can I collect both property ads and new-home promotions?

Yes. The Actor includes standard ads and new-home promotions in the same collection, then identifies each record with itemType.

Can I target a specific city or neighborhood?

Yes. Use a public Fotocasa search URL that already targets the city, province, or local area you need. The URL is used to determine the collection scope.

Can I collect rental listings?

Yes, when you provide a supported public Fotocasa rental search URL. The transaction type is inferred from the URL path when recognized.

How many records will the Actor return?

The Actor attempts to save up to maxItems unique records and stops when it reaches that limit, reaches maxPages, or finds no additional results. The final count can be lower when the source has fewer available listings or repeated records.

Why are some fields missing?

Fotocasa does not publish every attribute for every property. Empty values are removed from each dataset item instead of being returned as null placeholders.

Are listing records duplicated?

No. The Actor skips repeated ad and promotion identifiers within a run. Similar properties with different source identifiers can still be separate listings.

Can I export Fotocasa data to CSV or Excel?

Yes. Apify datasets can be downloaded as JSON, CSV, Excel, XML, and other supported formats, or connected to tools such as Google Sheets, Airtable, Make, and Zapier.

Can I schedule recurring collections?

Yes. Create an Apify schedule to run the same input hourly, daily, weekly, or on a custom interval for property inventory and price monitoring.

Is it legal to collect Fotocasa data?

You are responsible for complying with Fotocasa's terms, applicable laws, privacy requirements, copyright rules, and any restrictions that apply to your intended use. Collect and use public listing data responsibly.

Related Actors

• Zameen.com Scraper - Collect property listings from Pakistan for sale, rent, plots, and commercial research.
• iProperty Scraper - Collect Malaysian property listings, prices, locations, and agent details.
• Zoopla Property Scraper - Collect UK property listings for market research, price monitoring, and investment analysis.

Support

For issues, missing fields, source changes, or feature requests, use the Issues tab on the Actor page. Include the input URL, run ID, and a short example of the unexpected output when possible.

Legal Notice

This Actor is intended for legitimate collection of publicly available Fotocasa property information. Users are responsible for checking source terms, complying with applicable laws and privacy requirements, and using the collected data responsibly.