# Pisos.com Scraper: Spain Property for Sale & Rent (`reventadata/pisos-scraper`) Actor

Scrape pisos.com sale and rent listings in Spain: price, rooms, bathrooms, area, floor, location with coordinates, advertiser phone, agency profile link and photo count. Filter by price, rooms, size and terrace. Optional detail pages add the full description. Unofficial.

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

## Pricing

from $2.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

> **Unofficial.** This Actor is not affiliated with, authorised by, endorsed by, or in any
> way officially connected to pisos.com. "pisos.com" is a trademark of its respective owner
> and is used here only to describe what this tool reads. It reads the same public pages a
> browser does.

Pisos.com Scraper reads property listings from [pisos.com](https://www.pisos.com), a Spanish
real-estate portal, for sale or for rent: price, bedrooms, bathrooms, surface, floor, location
with coordinates, the advertiser's public phone, the agency profile link, and optionally each
listing's full description, update date, features, energy certificate and agency name.

### What data can you extract from pisos.com?

The listings pisos.com returns for your search (up to 3,000 per search, and your row and page caps), with the fields the site shows on its
search cards. With `fetchDetails` on, the Actor also opens each listing page for the extra
fields.

### Why scrape pisos.com?

- **Sale and rent** of flats, houses and penthouses, in any place pisos.com has a page for.
- **The site's own filters.** Price range, minimum bedrooms, minimum surface, terrace and
  eight sort orders are sent to pisos.com, so only matching listings are fetched.
- **Contact data the card publishes.** The advertiser's public phone and the agency profile
  link are in the row. A card with no phone (many rental advertisers publish a contact form only)
  has `phone` empty.
- **No proxy required by default.** Direct connection by default; proxy settings are available if
  needed.
- **Honest about the site's limit.** pisos.com serves at most 3,000 listings (100 pages of 30)
  for any one search. When a search has more, the log says how many are out of reach.

### How to scrape pisos.com

1. Pick `operation` (sale or rent), `propertyType` and the place slug in `location`.
2. Optionally set price, bedrooms, surface, terrace and sort order.
3. Run it. Results land in the dataset.

#### Input

| Field | Type | Meaning |
|---|---|---|
| `operation` | string | `sale` | `rent`. Seasonal rentals are not offered. |
| `propertyType` | string | `pisos` (flats) | `casas` (houses) | `aticos` (penthouses). |
| `location` | string | pisos.com place slug, e.g. `madrid`, `barcelona`, `vizcaya_bizkaia`. It is the part of a search URL after the property type: `vizcaya_bizkaia` in `https://www.pisos.com/venta/pisos-vizcaya_bizkaia/`. An unknown slug stops the run with an error. |
| `minPrice`, `maxPrice` | integer | Optional, EUR. For rent, the monthly rent. |
| `minRooms` | integer | Optional, 1 to 6. A minimum: 6 means "6 or more". |
| `minSurfaceM2` | integer | Optional minimum surface. |
| `hasTerrace` | boolean | Only listings the site tags with a terrace. |
| `sortBy` | string | `relevance` | `newest` | `priceAsc` | `priceDesc` | `roomsDesc` | `roomsAsc` | `areaDesc` | `areaAsc`. |
| `maxItems` | integer | Cap on rows. Default 100. |
| `maxPages` | integer | Optional cap on pages of 30 listings, at most 100. |
| `fetchDetails` | boolean | Off by default. One extra request per listing. |
| `proxyConfiguration` | object | Off by default. |

```json
{
    "operation": "sale",
    "propertyType": "pisos",
    "location": "madrid",
    "minPrice": 100000,
    "maxPrice": 200000,
    "minRooms": 2,
    "sortBy": "priceAsc",
    "maxItems": 200
}
```

#### Output

One row, from a platform run on 2026-11-11 with `fetchDetails` off (description and image shortened). The sample leaves out the keys that are `null` unless `fetchDetails` is on: `detailFullDescription`, `detailLastUpdated`, `detailReference`, `detailFeatures`, `detailEnergyClass`, `detailEnergyConsumption`, `detailEnergyEmissions`, `agencyName` and `agencyAddress`:

```json
{
  "id": "65077851154.510936",
  "adId": "65077851154",
  "advertiserId": "510936",
  "url": "https://www.pisos.com/comprar/piso-carabanchel_san_isidro28019-65077851154_510936/",
  "operation": "sale",
  "propertyType": "piso",
  "title": "Piso en calle de San Cándido",
  "locationText": "San Isidro (Distrito Carabanchel. Madrid Capital)",
  "municipality": "Madrid Capital",
  "province": "Madrid",
  "latitude": 40.399459,
  "longitude": -3.7209612,
  "price": 439900,
  "priceText": "439.900 €",
  "currency": "EUR",
  "rooms": 3,
  "bathrooms": 2,
  "areaM2": 90,
  "floor": "1ª planta",
  "otherCharacteristics": null,
  "descriptionSnippet": "Hay zonas de madrid donde se compra una vivienda. Y hay zonas donde se compra calidad de v...",
  "badges": [
    "TOP",
    "Oportunidad"
  ],
  "photoCount": 33,
  "imageUrl": "https://fotos.imghs.net/mm-wp/510936/65077851154.510936/510936_65077851154_74e3db83-c061-4...",
  "isNewDevelopment": false,
  "phone": "919383603",
  "agencyProfileUrl": "https://www.pisos.com/inmobiliaria-redpiso_estudio_pradera_de_san_isidro/",
  "agencySlug": "redpiso_estudio_pradera_de_san_isidro",
  "searchUrl": "https://www.pisos.com/venta/pisos-madrid/",
  "page": 1,
  "scrapedAt": "2026-11-11T06:36:31+00:00"
}
```

### Notes and limits

- **3,000 listings per search.** pisos.com serves 100 pages of 30; page 101 and later redirect
  to page 1. A search with more results (Madrid sale showed 15,495 results on 2026-11-08) returns the first 3,000
  in the chosen sort order and the log reports the rest as unreachable. To cover more, run
  several narrower searches: a smaller place slug (a district or municipality), a property
  type, or price bands with `minPrice` / `maxPrice`.
- **`price` is the monthly rent on rent searches.** `priceText` is the card's own text.
- **Agency name needs `fetchDetails`.** The search card shows only the agency's logo link, and
  some cards have none: `agencyProfileUrl` is empty then. The detail page carries the name
  and address.
- **A search that matches nothing ends with a status message and no rows.** A wrong place
  slug, or a run where pisos.com's pages could not be read, ends as failed with the reason.
- Only flats, houses and penthouses are offered; the site's other property types were not tested.
- Reads the same public pages a browser does. See the disclaimer at the top.

### How much does it cost to scrape pisos.com?

Pay-per-event: you pay per result written to the dataset, with no subscription. The current
price is on the Actor's Pricing tab.

### FAQ

**How do I find a place slug?** Search on pisos.com and copy the part of the URL after the
property type, for example `vizcaya_bizkaia` from `/venta/pisos-vizcaya_bizkaia/`.

**Why is `phone` empty on some rows?** The card only shows a phone when the advertiser
published one. On a rental search for Barcelona on 2026-11-08, 28 of 30 cards had none.

### More marketplace scrapers

| Actor | What it scrapes |
|---|---|
| [Imovirtual Scraper](https://apify.com/reventadata/imovirtual-scraper) | Imovirtual, Portugal: property listings |

# Actor input Schema

## `operation` (type: `string`):

Buy or rent. Sale listings come from /venta/, rentals from /alquiler/. Seasonal rentals are not offered.

## `propertyType` (type: `string`):

Kind of property: flats (pisos), houses (casas) or penthouses (aticos).

## `location` (type: `string`):

The pisos.com place slug: the part of a search URL after the property type. In https://www.pisos.com/venta/pisos-vizcaya_bizkaia/ it is vizcaya_bizkaia; for Madrid province it is madrid. Open pisos.com, search the place you want and copy it from the address bar. A slug the site does not know ends the run with an error.

## `minPrice` (type: `integer`):

Only listings priced at least this much (sale price, or monthly rent for rentals). Leave empty for no minimum. Use price bands to reach past the 3,000-listings-per-search limit.

## `maxPrice` (type: `integer`):

Only listings priced at most this much (sale price, or monthly rent for rentals). Leave empty for no maximum.

## `minRooms` (type: `integer`):

Only listings with at least this many bedrooms (the site labels 6 as '6 or more'). Leave empty for any.

## `minSurfaceM2` (type: `integer`):

Only listings with at least this many square metres. Leave empty for any.

## `hasTerrace` (type: `boolean`):

Only listings that the site tags with a terrace.

## `sortBy` (type: `string`):

Order of the results. Newest first is the best choice when you run the same search again and again.

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

Stop after this many listings have been saved. pisos.com serves at most 3,000 listings (100 pages of 30) for any one search.

## `maxPages` (type: `integer`):

Stop after this many result pages (30 listings each, 100 at most). Leave empty to read every page up to the listing limit.

## `fetchDetails` (type: `boolean`):

Open each listing page to add the full description, last update date, reference, feature list, energy certificate, and the agency name and address. Slower: one extra request per listing.

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

Proxy settings. The default is no proxy.

## Actor input object example

```json
{
  "operation": "sale",
  "propertyType": "pisos",
  "location": "madrid",
  "hasTerrace": false,
  "sortBy": "relevance",
  "maxItems": 10,
  "maxPages": 2,
  "fetchDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `dataset` (type: `string`):

Items scraped from the target website.

# 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 = {
    "maxItems": 10,
    "maxPages": 2
};

// Run the Actor and wait for it to finish
const run = await client.actor("reventadata/pisos-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 = {
    "maxItems": 10,
    "maxPages": 2,
}

# Run the Actor and wait for it to finish
run = client.actor("reventadata/pisos-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 '{
  "maxItems": 10,
  "maxPages": 2
}' |
apify call reventadata/pisos-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,reventadata/pisos-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/H0Yq39KSUHC9WvXkR/builds/owNHzbdzbQfPP0ZZF/openapi.json
