# Fotocasa Listings Scraper (`neuro-scraper/fotocasa-listings-scraper`) Actor

Fotocasa Scraper SD - Fotocasa Scraper is a real estate data tool that extracts public fotocasa.es listings in Spain to buy or rent by location or search URL: price, rooms, bathrooms, m2, amenities, address, coordinates, agency and phone, photos, plus optional details.

- **URL**: https://apify.com/neuro-scraper/fotocasa-listings-scraper.md
- **Developed by:** [Neuro Scraper](https://apify.com/neuro-scraper) (community)
- **Categories:** Real estate, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.19 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### Fotocasa Listings Scraper

The Fotocasa Listings Scraper collects public Fotocasa listings and returns it as a clean dataset you can download as JSON, CSV or Excel, or read through the Apify API. No login, no cookies and no code: give the Fotocasa Listings Scraper your input, start it and get structured Fotocasa data for research, monitoring, analytics or lead generation. You pay only for the results you receive.

> ⭐ **Featured by Neuro Scraper: [Facebook Reels Scraper](https://apify.com/neuro-scraper/facebook-reels-scraper)** - scrape Facebook Reels from any page, profile or reel link with exact views and plays, every reaction type (Like, Love, Care, Haha, Wow, Sad, Angry), comments, shares, captions, music and video links. No login and no cookies. [Try the Facebook Reels Scraper →](https://apify.com/neuro-scraper/facebook-reels-scraper)

### Fotocasa Scraper - Spanish homes for sale and rent from fotocasa.es

The Fotocasa Scraper extracts public fotocasa.es listings in Spain to buy (comprar) or rent (alquiler):
price (with the monthly period for rentals and price reductions), property type, rooms, bathrooms, m2,
amenities, street, neighbourhood, district, city, province, postcode, coordinates, description, publish
date, agency with phone and profile link, and photos. Details add the title, energy and emissions rating,
readable characteristics (heating, floor, orientation, furnished, pets), extras, the agency's own reference
and every photo. No Fotocasa account or login is used.

#### Input

| Field | Type | Default | Meaning |
|---|---|---|---|
| `locations` | list | `madrid-capital` (prefill) | Location slugs from fotocasa.es search URLs: madrid-capital, barcelona-capital, valencia-capital ... |
| `transaction` | select | `comprar` | `comprar` (buy) or `alquiler` (rent) |
| `startUrls` | list | empty | Search URLs from fotocasa.es with your filters (ending in `/l`) or listing URLs (ending in `/<id>/d`) |
| `maxItems` | integer | `50` | Total listings to return |
| `includeDetails` | boolean | `false` | Open each listing page (one extra request per listing) |
| `proxyConfiguration` | proxy | Apify RESIDENTIAL | Proxy used for fotocasa.es |

#### Output (one row per listing)

| Field | Meaning |
|---|---|
| `id`, `url`, `transaction`, `propertyType`, `propertySubtype` | Listing id, link, buy / rent, Flat / House ... |
| `price`, `priceText`, `currency`, `pricePeriod`, `reducedPrice` | Price in EUR, as shown, `month` for rentals, previous price |
| `rooms`, `bathrooms`, `surface`, `amenities` | Rooms, bathrooms, m2, amenity flags (keys on search rows, Spanish labels on listing-URL rows) |
| `street`, `neighborhood`, `district`, `city`, `municipality`, `province`, `zipCode`, `latitude`, `longitude` | Location |
| `description`, `publishedAt`, `isNewConstruction`, `isOpportunity`, `hasVideo`, `isVirtualTour` | Text and flags |
| `agencyName`, `agencyType`, `agencyUrl`, `agencyPhone` | Advertiser (phone when Fotocasa shows it) |
| `photoCount`, `photos` | Photo URLs |
| details: `title`, `energyRating`, `emissionsRating`, `characteristics`, `extraFeatures`, `constructionType`, `agencyReference`, `createdAt`, `isOccupied`, `isRentedWithTenants`, `detailPhotos` | Only with `includeDetails` or listing URLs |
| `searchTotal`, `page`, `source`, `scrapedAt` | Result count, page, input that produced the row, time |

#### Measured limits (2026-10-03, local runs)

- 30 listings per page (+1 promoted); about 10,000 per search (Fotocasa's page cap). Split big cities by
  zone or price with a copied search URL.
- 50 listings in 4 s, 70 in 5 s; with details about 1.5 s more per listing.
- Texts are in Spanish as published.
- Tested without proxy from one residential IP; no bot challenge was met. A challenge is never solved: the
  Actor retries on a new IP, then skips the target with an error in the log.

#### Example

```json
{"locations": ["barcelona-capital", "valencia-capital"], "transaction": "alquiler", "maxItems": 300}
```

### Why use the Fotocasa Listings Scraper

The Fotocasa Listings Scraper is a Fotocasa scraper and Fotocasa data extractor for anyone who needs public Fotocasa listings as clean data. The Fotocasa Listings Scraper handles web scraping, proxy rotation and retries for you, so you get a ready dataset instead of raw pages. Use the Fotocasa Listings Scraper for market research, competitor analysis, lead generation, analytics or monitoring, and export the results to JSON, CSV, Excel or Google Sheets.

- No login and no code: the Fotocasa Listings Scraper runs on Apify with one click or one API call.
- Pay per result: the Fotocasa Listings Scraper charges only for rows delivered - no monthly Fotocasa API fee.
- Complete fields: the Fotocasa Listings Scraper returns every public field, with a stable schema for automation.
- Integrations: connect the Fotocasa Listings Scraper to Zapier, Make, n8n, Google Sheets, a webhook or your CRM.

### Fotocasa Listings Scraper use cases

- Market research: the Fotocasa Listings Scraper collects Fotocasa listings at scale, so you can compare trends across weeks and niches.
- Competitor analysis: run the Fotocasa Listings Scraper on a schedule and export the dataset to Google Sheets or Excel to watch what competitors publish.
- Lead generation and B2B prospecting: the Fotocasa Listings Scraper gives a sales or agency team a clean list to load into a CRM.
- Content and social media monitoring: the Fotocasa Listings Scraper keeps a fresh copy of Fotocasa data through an Apify schedule and a webhook.
- Analytics and dashboards: send the Fotocasa Listings Scraper output as JSON through the Apify API into Python, Node.js or a BI tool.
- Academic and data science projects: the Fotocasa Listings Scraper returns a consistent schema, ready for pandas, R or a notebook.
- Price, product and brand tracking: the Fotocasa Listings Scraper turns public Fotocasa data into a dataset you can diff run by run.
- Automation workflows: connect the Fotocasa Listings Scraper to Zapier, Make or n8n so every new row starts your next step.

### How to run it with the API, Python and Node.js

Start the Fotocasa Listings Scraper from the Apify Console, or call it from code. The Fotocasa Listings Scraper returns its dataset as JSON, CSV or Excel. With the Apify API you can run the Fotocasa Listings Scraper from Python or Node.js, wait for it to finish and read the rows, which makes the Fotocasa Listings Scraper easy to plug into an automation, a data pipeline or a scheduled export.

1. Open the Fotocasa Listings Scraper on Apify and fill in the input (or send the same input as JSON to the API).
2. Start the Fotocasa Listings Scraper. Follow the run log while the Fotocasa Listings Scraper collects public Fotocasa data.
3. Download the dataset as CSV, JSON, Excel or XLSX, or let a webhook send it on.
4. Schedule the Fotocasa Listings Scraper to keep your Fotocasa data fresh for monitoring and analytics.

### Tips for better results

- Start small: run the Fotocasa Listings Scraper with a low maximum first, check the fields, then scale up the same input.
- Split big jobs: several smaller Fotocasa Listings Scraper runs (by keyword, URL list or date) finish faster and are easier to resume.
- Keep a history: name a dataset or use a schedule so each Fotocasa Listings Scraper run adds to your Fotocasa data over time.
- Filter early: use the input filters of the Fotocasa Listings Scraper so you only pay for the Fotocasa listings you really need.
- Automate the hand-off: a webhook or the Zapier and Make integrations can move every Fotocasa Listings Scraper result straight to Google Sheets, a CRM or a database.
- Watch the run log: the Fotocasa Listings Scraper writes what it is doing and why an item was skipped, so a surprising result is easy to explain.

### Fotocasa Listings Scraper FAQ

#### Can it replace the official Fotocasa API?

For public data, yes. The Fotocasa Listings Scraper gives you Fotocasa data through the Apify API without an official Fotocasa API key, quota approval or developer account.

#### Is it legal to scrape Fotocasa?

The Fotocasa Listings Scraper collects only publicly available data. If results contain personal data, process it under GDPR or the rules that apply to you, and only for a legitimate purpose.

#### Which formats can I download?

The Fotocasa Listings Scraper dataset downloads as JSON, CSV, Excel (XLSX), XML, RSS or an HTML table, and the Apify API returns the same Fotocasa Listings Scraper data page by page.

#### Can I run it for many inputs at once?

Yes. Give the Fotocasa Listings Scraper a list of inputs in one run; each row says which input it came from, so one Fotocasa Listings Scraper run can cover a whole list.

#### How fast is it?

The Fotocasa Listings Scraper runs requests in parallel and rotates proxy sessions automatically, so a typical run of a few hundred items finishes in minutes.

#### Can I send the data to my CRM?

Yes. Push Fotocasa Listings Scraper rows to HubSpot, Salesforce, Pipedrive or any CRM through Zapier, Make or a webhook - a common setup for an agency or B2B sales team.

#### Why is a field empty in my results?

The Fotocasa Listings Scraper fills every field Fotocasa publishes for that item. When Fotocasa does not show a value - for example a figure the owner hid - the field stays empty rather than being guessed.

#### Can I schedule it?

Yes. Apify schedules run the Fotocasa Listings Scraper hourly, daily or weekly, and a webhook can notify your system when new Fotocasa data is ready.

#### Does it work with proxies?

Yes. The Fotocasa Listings Scraper uses Apify Proxy by default and you can pick the proxy group or country in the input.

#### Can I use it through the API?

Yes. Start the Fotocasa Listings Scraper and read its dataset through the Apify API from Python, Node.js or any HTTP client, or call it from Zapier, Make and n8n.

#### How much does it cost?

The Fotocasa Listings Scraper is pay per result: you pay only for the rows you receive, with lower prices on higher Apify plans. You can cap the cost of every run with the maximum cost setting.

#### How do I get more results?

Raise the maximum items, add more inputs (keywords, URLs or profiles), or run the Fotocasa Listings Scraper several times on a schedule. Results are de-duplicated.

#### Can I export the results to Excel, CSV or Google Sheets?

Yes. Every Fotocasa Listings Scraper run stores a dataset you can export as CSV, JSON, Excel (XLSX), XML or HTML, or send to Google Sheets with the Apify integration.

#### What does this Fotocasa scraper do?

The Fotocasa Listings Scraper collects public Fotocasa listings and returns it as a structured dataset. It is web scraping without code: you set the input, start the Fotocasa Listings Scraper and download JSON, CSV, Excel or XLSX.

#### What happens if a run is interrupted?

The Fotocasa Listings Scraper saves its progress, so a resurrected or restarted run continues where it stopped instead of paying for the same rows again.

#### Do you offer custom scrapers?

Yes. If you need a field or a filter the Fotocasa Listings Scraper does not have yet, contact Neuro Scraper through the Apify Store page and we can extend the Fotocasa Listings Scraper for you.

#### Do I need a Fotocasa account or login?

No. The Fotocasa Listings Scraper works with no login and no cookies. It reads only public data, the same data any visitor can see.

#### How is this different from other Fotocasa scrapers?

The Fotocasa Listings Scraper combines complete public fields, no login, pay-per-result pricing and a stable output schema, so the Fotocasa Listings Scraper fits both quick one-off exports and long-running automation.

#### What is the best Fotocasa scraper for listings?

The Fotocasa Listings Scraper is built for exactly this job: public Fotocasa listings, complete fields, no login, pay per result and a clean export to JSON, CSV or Excel.

### More scrapers from Neuro Scraper

| Actor | What it extracts |
|---|---|
| ⭐ **[Facebook Reels Scraper](https://apify.com/neuro-scraper/facebook-reels-scraper)** | Facebook Reels with exact views, plays, every reaction type, comments and shares |
| [Snapchat Profile Scraper](https://apify.com/neuro-scraper/snapchat-profile-scraper) | Snapchat profile data with all public fields, exported to JSON, CSV or Excel |
| [Amazon Scraper](https://apify.com/neuro-scraper/amazon-keyword-scraper) | Amazon data with all public fields, exported to JSON, CSV or Excel |
| [Instagram Reels Scraper](https://apify.com/neuro-scraper/instagram-reels-scraper) | Instagram reels with all public fields, exported to JSON, CSV or Excel |
| [Facebook Video Details Scraper](https://apify.com/neuro-scraper/facebook-video-details-scraper) | Facebook video details with all public fields, exported to JSON, CSV or Excel |
| [Facebook Reels Scraper Advanced](https://apify.com/neuro-scraper/facebook-reels-scraper-advanced) | Facebook reels  advanced data with all public fields, exported to JSON, CSV or Excel |
| [Facebook Reels Downloader](https://apify.com/neuro-scraper/facebook-reels-downloader) | Facebook reels with all public fields, exported to JSON, CSV or Excel |
| [Instagram Search Scraper](https://apify.com/neuro-scraper/instagram-video-scraper-advanced) | Instagram search data with all public fields, exported to JSON, CSV or Excel |
| [TikTok Video Details Scraper](https://apify.com/neuro-scraper/tiktok-video-details-scraper) | TikTok video details with all public fields, exported to JSON, CSV or Excel |
| [Instagram Hashtag Scraper](https://apify.com/neuro-scraper/instagram-reeel-scraper) | Instagram hashtag data with all public fields, exported to JSON, CSV or Excel |
| [TikTok Profile Scraper](https://apify.com/neuro-scraper/tiktok-profile-scraper) | TikTok profile data with all public fields, exported to JSON, CSV or Excel |
| [Amazon Best Sellers Scraper](https://apify.com/neuro-scraper/amazon-per-result-scraper) | Amazon best sellers with all public fields, exported to JSON, CSV or Excel |
| [Facebook Photos Scraper](https://apify.com/neuro-scraper/facebook-photo-posts-scraper) | Facebook photos with all public fields, exported to JSON, CSV or Excel |

# Actor input Schema

## `locations` (type: `array`):

One per line: the location part of a fotocasa.es search URL, e.g. madrid-capital, barcelona-capital (from https://www.fotocasa.es/es/comprar/viviendas/madrid-capital/todas-las-zonas/l).

## `transaction` (type: `string`):

Which Fotocasa search to run for the locations above.

## `startUrls` (type: `array`):

Search URLs copied from fotocasa.es with your filters (ending in /l) or listing URLs (ending in /<id>/d).

## `maxItems` (type: `integer`):

Stops after this many listings in total. Fotocasa shows 30 per page and up to ~10,000 per search.

## `includeDetails` (type: `boolean`):

Opens every listing page for the title, energy and emissions rating, readable characteristics (orientation, heating, condition, floor), extras, agency reference and all photos. One extra request per listing.

## `proxyConfiguration` (type: `object`):

Residential proxies (the default) are recommended.

## Actor input object example

```json
{
  "locations": [
    "madrid-capital"
  ],
  "transaction": "comprar",
  "startUrls": [],
  "maxItems": 50,
  "includeDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "locations": [
        "madrid-capital"
    ],
    "startUrls": [],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("neuro-scraper/fotocasa-listings-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "locations": ["madrid-capital"],
    "startUrls": [],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("neuro-scraper/fotocasa-listings-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "locations": [
    "madrid-capital"
  ],
  "startUrls": [],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call neuro-scraper/fotocasa-listings-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,neuro-scraper/fotocasa-listings-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/oNTYkJBKILPci9bAb/builds/l5b0AxbCKfLNlRm37/openapi.json
