Fotocasa.es Property Scraper

Collect Fotocasa property listings in a clean, structured format for market research, lead generation, portfolio tracking, and price monitoring.

The actor returns standard property ads and new-home promotions, with duplicate-free results and empty fields automatically removed from the dataset.

Features

• Fast collection — Get listing data quickly with predictable pagination and limits.
• Clean output — Empty fields are removed before saving, so each dataset item stays compact.
• Rich listing details — Capture titles, prices, locations, property sizes, agency details, and photo URLs.
• Promotion support — Collect both regular listings and new-home developments in one run.
• Flexible coverage — Use a single listing URL to target Spain-wide searches or specific areas.

Use Cases

Market Research

Track inventory, pricing, and availability across neighborhoods, cities, or all of Spain. Build repeatable datasets for trend analysis and competitive monitoring.

Lead Generation

Collect listing records with contact-facing property context, agency names, and media assets. Use the data to feed sales pipelines, outreach workflows, or CRM enrichment.

Investment Tracking

Monitor homes and promotions across target regions and compare asking prices, sizes, and availability over time. Spot changes in the market before they become obvious.

Content and Reporting

Produce clean tables and reports for dashboards, newsletters, internal briefings, or client presentations. The structured output is easy to export into spreadsheets and BI tools.

Input Parameters

Parameter	Type	Required	Default	Description
startUrl	String	No	https://www.fotocasa.es/en/buy/homes/espana/all-zones/l	Fotocasa listing URL used to determine the starting scope.
maxItems	Integer	No	20	Maximum number of dataset items to save.
maxPages	Integer	No	20	Safety limit for pagination.
proxyConfiguration	Object	No	useApifyProxy: false	Optional proxy settings for reliable collection.

Output Data

Each dataset item includes only the fields that have values.

Field	Type	Description
itemType	String	ad or promotion.
id	String	Internal listing identifier.
title	String	Listing title or headline.
description	String	Full listing description.
url	String	Public listing URL.
price	Number	Asking price for ads.
minPrice	Number	Minimum promotion price.
maxPrice	Number	Maximum promotion price.
priceType	String	Sale/rental type label.
currency	String	Currency code.
rooms	Number	Number of rooms when available.
baths	Number	Number of bathrooms when available.
surface	Number	Built area in square meters.
location	String	Human-readable location label.
latitude	String	Latitude for the listing.
longitude	String	Longitude for the listing.
agencyName	String	Publishing agency name.
agencyId	String	Publishing agency identifier.
hasPhotos	Boolean	Indicates whether photos are available.
hasVideos	Boolean	Indicates whether videos are available.
photosCount	Number	Number of photos available for the listing.
photoUrls	Array	All available photo URLs for the listing.
previewImage	String	First photo URL for quick preview.
publicationDate	String	Original publication date.
alterDate	String	Last update timestamp.

Promotion items also include:

Field	Type	Description
promotionId	String	Promotion identifier.
minRooms	Number	Minimum bedroom count.
maxRooms	Number	Maximum bedroom count.
minBaths	Number	Minimum bathroom count.
maxBaths	Number	Maximum bathroom count.
minSurface	Number	Minimum surface area.
maxSurface	Number	Maximum surface area.
adsCount	Number	Number of units in the promotion.

Usage Examples

Spain-Wide Search

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

Smaller Test Run

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

Faster Production Crawl

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

Sample Output

{
	"itemType": "ad",
	"id": "1_188957600",
	"title": "Se vende fantástico piso en pleno centro...",
	"description": "Se vende fantástico piso en pleno centro...",
	"url": "https://www.fotocasa.es/en/buy/home/cornella-de-llobregat/.../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"
}

Tips for Best Results

Start Small

• Begin with maxItems: 20 to confirm the scope is correct.
• Increase the limit once you’re happy with the output.

Use a Clear Listing URL

• Start from a search page that matches the market you want.
• Keep the path focused on the exact type of listing you need.

Review Media Fields

• Use photosCount to estimate media depth.
• Use photoUrls to access the full image set.

Keep Runs Predictable

• Raise maxPages only when you need deeper coverage.
• Use a proxy configuration for larger jobs or repeated runs.

Integrations

Connect the output with:

• Google Sheets — Review listings and compare markets quickly.
• Airtable — Build a searchable property database.
• Excel — Share reports with teams and clients.
• Make — Automate follow-up workflows.
• Zapier — Send new listings into connected tools.
• Webhooks — Push results into custom systems.

Export Formats

• JSON — Best for downstream systems and automation.
• CSV — Useful for spreadsheets and quick analysis.
• Excel — Convenient for stakeholder reports.

Frequently Asked Questions

What kind of listings does this actor collect?

It collects standard property ads and new-home promotions.

Does it include photos?

Yes. Each item includes photosCount, photoUrls, and a previewImage when available.

Are empty fields included in the output?

No. Empty and null fields are removed before saving.

Can I focus on a specific area?

Yes. Use a relevant Fotocasa listing URL for the area you want to monitor.

How many items can I collect?

That depends on your chosen maxItems and maxPages values.

Is there support for promotions?

Yes. Promotions are included by default.

Support

For questions, issues, or feature requests, use the Apify Console.

Resources

• Apify Documentation
• Apify API Reference
• Scheduling Runs

Legal Notice

This actor is intended for legitimate data collection and research use. Users are responsible for complying with applicable laws, website terms, and internal policies when using the data.