# Pisos.com Scraper - Spain Properties, Prices & Agents (`abotapi/pisos-com-scraper`) Actor

Scrape Pisos.com property listings for sale and rent across Spain by location or URL. Extract prices, price drops, floor areas, rooms, features, photo galleries, GPS coordinates, energy ratings and agency contacts. Supports search results, agency pages and property links.

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

## Pricing

from $1.60 / 1,000 property results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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

## Pisos.com Scraper

Collect property listings from Pisos.com (pisos.com), Spain's property portal: homes, rooms, garages, land, offices and commercial premises for sale and for rent, with prices, price drops, areas, rooms, features, full photo galleries, coordinates, energy data and agency contacts. One clean record per property for any place, results page, agency page or property link.

### Why This Scraper?

- **Three ways in.** Search by place and filters, paste results pages or agency pages, or paste single property links, all in one run if you like.
- **Complete property record.** Price and price drop, areas, bedrooms, bathrooms, floor, age, community fees, condition, orientation, terrace, energy certificate, equipment, finishes and every other listed feature.
- **Full media.** Every photo at its largest size, floor plans, videos and virtual tour links.
- **Location ready.** Latitude and longitude, zone hierarchy ids, neighbourhood, district and city line.
- **Advertiser details.** Agency name, type (agency or private seller), licence, address, phone, email, website and logo, plus the contact phone and WhatsApp number shown on the property.
- **Every property type.** Flats, houses, penthouses, duplex, studios, lofts, rooms, new build, garages, storage rooms, land, offices, buildings, commercial premises and warehouses, for sale or for rent.
- **Change tracking.** Schedule recurring runs and receive only new properties and real changes such as price drops, with one clear item cap and resume support.

### Use Cases

- **Market research:** compare asking prices, areas and features across Spanish cities and districts.
- **Investors and analysts:** track price drops and new listings for a place on a schedule.
- **Agencies and portals:** benchmark competing agencies, their stock and their pricing.
- **Lead and data teams:** build a clean, geocoded property dataset for maps, dashboards and models.

### Data You Get

> Sample shape: values are illustrative placeholders, not from a live record.

| Field | Example |
| --- | --- |
| `nonEncryptedId` | `00000000000,000000` |
| `title` | `Flat for sale in Example Street` |
| `subtitle` | `Example Zone (Example District. Example City)` |
| `operationType` | `Sale` |
| `price` | `300000` |
| `previousPrice` | `320000` |
| `priceDropValue` | `20000` |
| `pricePerSqm` | `3333.33` |
| `currency` | `EUR` |
| `propertyType` | `flat` |
| `areaBuilt` | `90` |
| `rooms` | `3` |
| `bathrooms` | `2` |
| `equipmentAndInstallations` | `Name and value pairs` |
| `city` | `Example City` |
| `province` | `Example Province` |
| `energyClass` | `E` |
| `fullAddress` | `Example Street, Example Zone, Example City` |
| `latitude` | `40.0000000` |
| `longitude` | `-3.0000000` |
| `images` | `Photo URLs` |
| `advertiserName` | `Example Agency` |
| `advertiserPhone` | `000000000` |
| `advertiserEmail` | `agent@example.com` |
| `url` | `pisos.com/comprar/example-property` |

### How to Use

1. Pick a mode: search by place, or paste pisos.com links.
2. Choose sale or rent, the property type and the price, bedroom, bathroom and area limits.
3. Run the actor.
4. Download the dataset as JSON, CSV or Excel, or read it through the API.

**Search by place:**

```json
{ "mode": "search", "locations": ["Madrid Capital"], "operation": "sale", "propertyType": "flats", "minRooms": 2, "maxPrice": 400000, "maxItems": 100 }
```

**Paste links:**

```json
{ "mode": "url", "urls": ["https://www.pisos.com/venta/pisos-madrid_capital_zona_urbana/desde-300000/hasta-500000/", "https://www.pisos.com/alquiler/pisos-madrid_capital_zona_urbana/", "https://www.pisos.com/comprar/piso-carabanchel_san_isidro28019-65077851154_510936/"], "maxItems": 100 }
```

Home pages and editorial pages carry no properties and are skipped with a warning.

**Recurring monitoring:**

```json
{ "mode": "search", "locations": ["Barcelona"], "incrementalMode": true, "changeScope": "priceOnly", "maxItems": 500 }
```

#### Run it from your code

Python:

```python
from apify_client import ApifyClient
client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("<ACTOR_ID>").call(run_input={"mode": "search", "locations": ["Madrid Capital"], "maxItems": 20})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["title"], item["price"])
```

JavaScript:

```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('<ACTOR_ID>').call({ mode: 'search', locations: ['Madrid Capital'], maxItems: 20 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.length);
```

#### Tips

- A place name picks the closest match: use Madrid for the whole province and Madrid Capital for the city.
- Turn off Add property details for the quickest runs when the listing fields are enough. The description and the update date come with the details.
- Price, bedroom, bathroom and area limits are minimums or ranges applied by the site, so every returned row already matches them.
- A page number in a pasted results link is where the walk starts.
- Use Price only in incremental mode for a lean price drop feed.

### Send results into your apps (MCP connectors)

Optionally send a condensed summary of the results into Notion, Linear, Airtable or Apify through Model Context Protocol connectors. Authorize a connector once in your Apify integrations settings, then select it in the input. The full records always stay in the dataset.

### Input Parameters

| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `mode` | string | search | Search by place or paste links. |
| `locations` | array | Madrid Capital | Places, one per line: city, province, district or neighbourhood. |
| `operation` | string | sale | For sale or for rent. |
| `propertyType` | string | homes | Homes, flats, houses, penthouses, duplex, studios, lofts, rooms, new build, garages, storage rooms, land, offices, buildings, commercial, warehouses or all. |
| `minPrice` | integer | empty | Keep properties priced at or above this many euros. |
| `maxPrice` | integer | empty | Keep properties priced at or below this many euros. |
| `minRooms` | integer | empty | Minimum number of bedrooms. |
| `minBathrooms` | integer | empty | Minimum number of bathrooms. |
| `minArea` | integer | empty | Minimum area in square metres. |
| `urls` | array | sample links | Results pages, agency pages or property pages. |
| `fetchDetails` | boolean | true | Adds the full description and the update date from the property record. |
| `maxPages` | integer | empty | Pages per search; does not cap the run on its own. |
| `maxItems` | integer | 20 | Maximum results; 0 means unlimited. |
| `proxy` | object | Apify Proxy | Connection settings. The default Apify Proxy works for this site; Residential is recommended for the most reliable results and is billed by traffic on your account. If the selected connection is refused, the run switches to a backup connection on its own. |
| `resumeFromRunId` | string | empty | Skip properties already collected by an earlier run. |
| `incrementalMode` | boolean | false | Return only new or changed properties. |
| `stateKey` | string | empty | Name a monitoring campaign. |
| `baselineDatasetId` | string | empty | Start incremental tracking from an earlier dataset. |
| `emitExpired` | boolean | false | Also return properties that are no longer found, after a complete scan. |
| `changeScope` | string | all | All compared fields, or price only. |
| `expireAfterMissedScans` | integer | 1 | Complete scans a property must be missing before it expires. |
| `ignoreFieldsForChanges` | array | empty | Extra fields that never mark a property as updated. |
| `mcpConnectors` | array | empty | Connectors to send results to. |
| `notionParentPageUrl` | string | empty | Notion parent page. |
| `maxNotifyListings` | integer | 50 | Items exported per connector. |

### Output Example

> Sample shape: values are illustrative placeholders, not from a live record.

```json
{
  "nonEncryptedId": "00000000000,000000",
  "title": "Flat for sale in Example Street",
  "subtitle": "Example Zone (Example District. Example City)",
  "operationType": "Sale",
  "price": 300000,
  "previousPrice": 320000,
  "currency": "EUR",
  "propertyType": "flat",
  "areaBuilt": 90,
  "areaUsable": 80,
  "rooms": 3,
  "bathrooms": 2,
  "floor": "1",
  "equipmentAndInstallations": [{ "name": "Lift", "value": "Available" }],
  "latitude": 40.0,
  "longitude": -3.0,
  "images": ["https://example.com/photo-1.jpg"],
  "advertiserName": "Example Agency",
  "advertiserEmail": "agent@example.com",
  "isExclusive": true,
  "totalResults": 1000,
  "url": "https://example.com/property/0",
  "scrapedAt": "2026-01-01T00:00:00Z"
}
```

### Plan Requirement

A paid Apify plan is recommended so the standard Apify Proxy connection is included. Apify free plans do not include residential proxies; on a free plan the run continues on a backup connection and some pages may be unavailable. For the most reliable results choose Residential in the Connection section (billed by traffic on your account) or supply your own proxy URLs. Billing follows the pricing shown on the Store page.

### FAQ

#### How much does a run cost?

You pay per run start, per property returned and, when details are on, per property whose full record was read. Set Max items to control the total.

#### Is it legal to scrape Pisos.com?

The actor reads publicly visible listing information. You are responsible for using the data in line with applicable law and the site terms, including data protection rules for contact details.

#### Can I schedule runs?

Yes. Use Incremental mode on a schedule to receive only new properties and changes, and Price only when price moves are all you care about.

#### Why did a run return nothing?

The place may match nothing, the limits may be too strict, or a pasted link may be a home page or another page without properties. Try a broader place or relax the limits.

#### Why do some fields come back empty?

Each advert lists only what the advertiser filled in, so fields such as energy data, terrace or new development details are empty when the advert has none.

#### Can I use it with AI tools?

Yes, through the Apify MCP server or the connectors above.

### 🔗 More scrapers you might like

Pair this actor with these related scrapers from the same team:

<table>
<tr><td>🏠 <a href="https://apify.com/abotapi/fotocasa-es-scraper"><b>Fotocasa Spain Scraper</b></a><br>Scrape Fotocasa.es property listings for sale and rent across Spain. Extract 140+ fields...</td><td>🏠 <a href="https://apify.com/abotapi/idealista-scraper"><b>Idealista Scraper</b></a><br>Scrape Idealista properties across Spain, Italy, and Portugal. Extract 35+ fields...</td></tr>
<tr><td>🏠 <a href="https://apify.com/abotapi/immoscout24-scraper"><b>ImmobilienScout24.de Scraper</b></a><br>Extract property listings from immobilienscout24.de, Germany's #1 real estate platform...</td><td>🏠 <a href="https://apify.com/abotapi/fundainbusiness-nl-commercial-property-scraper"><b>Funda in Business Scraper</b></a><br>Scrape Funda in Business commercial listings: offices, retail, industrial, catering and...</td></tr>
<tr><td>🏠 <a href="https://apify.com/abotapi/immoweb-scraper"><b>Immoweb.be Scraper</b></a><br>Extract property listings from immoweb.be. Get price, location, coordinates, images, and...</td><td>🏠 <a href="https://apify.com/abotapi/pap-fr-scraper"><b>PAP.fr Scraper</b></a><br>Scrape PAP.fr real estate listings across France. Extract property prices, addresses...</td></tr>
</table>

👉 [Browse all abotapi scrapers](https://apify.com/abotapi)

### 💬 Support

- 🐞 **Found a bug or a missing field?** Open a ticket on the [Issues tab](https://apify.com/abotapi/pisos-com-scraper/issues/open). We usually reply within hours.
- 🛠️ **Need another site, extra fields or a private build?** Email <contact@abotapi.com>.
- ⭐ **Enjoying it?** A quick review on the actor page helps other users find it.

# Actor input Schema

## `mode` (type: `string`):

Search runs the places and filters below. URL mode scrapes the pisos.com links you paste (results pages, agency pages or property pages) and ignores the search fields.

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

One place per line: a city, province, district or neighbourhood in Spain (for example Madrid, Barcelona, Madrid Capital, Malaga). The closest matching place is used for each line. Each place is walked page by page, 30 properties per page, until Max items is reached.

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

Properties for sale or for rent.

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

Kind of property to list.

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

Keep only properties priced at least this many euros (monthly rent when Operation is For rent). Empty or 0 keeps all.

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

Keep only properties priced at most this many euros (monthly rent when Operation is For rent). Empty or 0 keeps all.

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

Keep only properties with at least this many bedrooms. Empty or 0 keeps all.

## `minBathrooms` (type: `integer`):

Keep only properties with at least this many bathrooms. Empty or 0 keeps all.

## `minArea` (type: `integer`):

Keep only properties with at least this many square metres. Empty or 0 keeps all.

## `urls` (type: `array`):

pisos.com links, one per line. Accepted: a results page for sale or rent (any city, district or property type, with price filters in the link, the map view or the English version; a page number in the link is where the walk starts), an agency page (its properties are listed) and a property page (/comprar/ or /alquilar/). Tracking and sort parameters are ignored. Other pages carry no properties and are skipped with a warning. Filter fields are ignored in this mode.

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

Open each property to add the full description and the last update date. Off returns the listing fields only. Property links always read the property.

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

Optional. Result pages to walk per place or link. This does not cap the run by default: empty or 0 means no page limit and it defers to Max items, which is the one default cap (20).

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

The single default cap of the run: maximum properties to return across the whole run (default 20). Max pages has no finite default and defers to this field. 0 means no limit. In incremental mode, unchanged properties count toward this number.

## `proxy` (type: `object`):

Proxy settings. The default Apify Proxy works for this site. Residential proxies are recommended for the most reliable results; they are billed by traffic on your account, so they cost more. If the selected connection is refused, the run switches to a backup connection on its own.

## `resumeFromRunId` (type: `string`):

Run ID (or dataset ID) of a previous run of this Actor. Properties already collected there are skipped, so this run returns only the delta. Leave empty for a normal run. For recurring monitoring of the same search, use Incremental mode instead.

## `incrementalMode` (type: `boolean`):

For recurring monitoring. A property is returned as NEW the first time and as UPDATED when a compared field changes: price, previous price, title, description, area, rooms, bathrooms, floor, features, equipment, images, coordinates, advertiser details, premium and exclusive flags and the listing state. Unchanged properties are not returned or billed. Never compared: rank, total results, collection time, the refresh date and the update date. State is kept per tracked search or link set, or per State key when you set one.

## `stateKey` (type: `string`):

Optional name for a monitoring campaign. Runs sharing a key share their incremental state. Leave empty to scope it automatically to the search or links.

## `baselineDatasetId` (type: `string`):

Optional. Pick the dataset of an earlier full run of this Actor so the first incremental run returns only properties that changed since then. Pick it unedited. Only used on the first run for a state key and not combined with Resume.

## `emitExpired` (type: `boolean`):

Off by default. Also returns properties that were tracked before and are no longer found, marked EXPIRED. Only produced after a complete scan, never when Max items, Max pages, a pasted page beyond 1, a property link or Resume limited the run. These synthetic rows are returned and billed, so leave it off unless you need expiry tracking.

## `changeScope` (type: `string`):

All fields (default): any change to a compared field returns an UPDATED row. Price only: only a change of the price, the previous price or the currency returns an UPDATED row; descriptions, images and other details never do.

## `expireAfterMissedScans` (type: `integer`):

Only used with Emit expired properties. A property is marked EXPIRED only after it was missing from this many complete scans in a row (default 1). Raise it so a property that briefly drops out of the results is not reported as gone.

## `ignoreFieldsForChanges` (type: `array`):

Extra field names that must not mark a property as UPDATED in incremental mode. Rank, total results, collection time and the refresh and update dates are already ignored. Use a dotted name such as additionalFeatures.value to ignore one key inside every element of a list.

## `mcpConnectors` (type: `array`):

Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify Settings, Integrations, then select it here. The connector receives a condensed summary per item; the full record stays in the dataset. Leave empty to skip.

## `notionParentPageUrl` (type: `string`):

URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors.

## `maxNotifyListings` (type: `integer`):

Cap on items written to each connector per run. Does not affect the dataset.

## Actor input object example

```json
{
  "mode": "search",
  "locations": [
    "Madrid Capital"
  ],
  "operation": "sale",
  "propertyType": "homes",
  "urls": [
    "https://www.pisos.com/venta/pisos-madrid_capital_zona_urbana/",
    "https://www.pisos.com/venta/pisos-madrid_capital_zona_urbana/2/",
    "https://www.pisos.com/alquiler/pisos-madrid_capital_zona_urbana/",
    "https://www.pisos.com/venta/casas-barcelona/",
    "https://www.pisos.com/venta/locales-madrid/",
    "https://www.pisos.com/venta/pisos-madrid/",
    "https://www.pisos.com/venta/pisos-madrid_capital/",
    "https://www.pisos.com/venta/pisos-madrid_capital_zona_urbana/desde-300000/hasta-500000/",
    "https://www.pisos.com/venta/pisos-madrid_capital_zona_urbana/?utm_source=x&ordenar=precio",
    "https://www.pisos.com/mapa/venta/pisos-madrid_capital_zona_urbana/",
    "https://www.pisos.com/en/venta/pisos-madrid_capital_zona_urbana/",
    "https://www.pisos.com/comprar/piso-carabanchel_san_isidro28019-65077851154_510936/",
    "https://www.pisos.com/alquilar/piso-madrid_capital_zona_urbana-65077851154_510936/",
    "https://www.pisos.com/inmobiliaria-redpiso_estudio_pradera_de_san_isidro/"
  ],
  "fetchDetails": true,
  "maxItems": 20,
  "proxy": {
    "useApifyProxy": true
  },
  "incrementalMode": false,
  "emitExpired": false,
  "changeScope": "all",
  "expireAfterMissedScans": 1,
  "ignoreFieldsForChanges": [],
  "maxNotifyListings": 50
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `advertisers` (type: `string`):

No description

# 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 = {
    "mode": "search",
    "locations": [
        "Madrid Capital"
    ],
    "urls": [
        "https://www.pisos.com/venta/pisos-madrid_capital_zona_urbana/",
        "https://www.pisos.com/venta/pisos-madrid_capital_zona_urbana/2/",
        "https://www.pisos.com/alquiler/pisos-madrid_capital_zona_urbana/",
        "https://www.pisos.com/venta/casas-barcelona/",
        "https://www.pisos.com/venta/locales-madrid/",
        "https://www.pisos.com/venta/pisos-madrid/",
        "https://www.pisos.com/venta/pisos-madrid_capital/",
        "https://www.pisos.com/venta/pisos-madrid_capital_zona_urbana/desde-300000/hasta-500000/",
        "https://www.pisos.com/venta/pisos-madrid_capital_zona_urbana/?utm_source=x&ordenar=precio",
        "https://www.pisos.com/mapa/venta/pisos-madrid_capital_zona_urbana/",
        "https://www.pisos.com/en/venta/pisos-madrid_capital_zona_urbana/",
        "https://www.pisos.com/comprar/piso-carabanchel_san_isidro28019-65077851154_510936/",
        "https://www.pisos.com/alquilar/piso-madrid_capital_zona_urbana-65077851154_510936/",
        "https://www.pisos.com/inmobiliaria-redpiso_estudio_pradera_de_san_isidro/"
    ],
    "proxy": {
        "useApifyProxy": true
    },
    "incrementalMode": false,
    "emitExpired": false,
    "expireAfterMissedScans": 1,
    "ignoreFieldsForChanges": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/pisos-com-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 = {
    "mode": "search",
    "locations": ["Madrid Capital"],
    "urls": [
        "https://www.pisos.com/venta/pisos-madrid_capital_zona_urbana/",
        "https://www.pisos.com/venta/pisos-madrid_capital_zona_urbana/2/",
        "https://www.pisos.com/alquiler/pisos-madrid_capital_zona_urbana/",
        "https://www.pisos.com/venta/casas-barcelona/",
        "https://www.pisos.com/venta/locales-madrid/",
        "https://www.pisos.com/venta/pisos-madrid/",
        "https://www.pisos.com/venta/pisos-madrid_capital/",
        "https://www.pisos.com/venta/pisos-madrid_capital_zona_urbana/desde-300000/hasta-500000/",
        "https://www.pisos.com/venta/pisos-madrid_capital_zona_urbana/?utm_source=x&ordenar=precio",
        "https://www.pisos.com/mapa/venta/pisos-madrid_capital_zona_urbana/",
        "https://www.pisos.com/en/venta/pisos-madrid_capital_zona_urbana/",
        "https://www.pisos.com/comprar/piso-carabanchel_san_isidro28019-65077851154_510936/",
        "https://www.pisos.com/alquilar/piso-madrid_capital_zona_urbana-65077851154_510936/",
        "https://www.pisos.com/inmobiliaria-redpiso_estudio_pradera_de_san_isidro/",
    ],
    "proxy": { "useApifyProxy": True },
    "incrementalMode": False,
    "emitExpired": False,
    "expireAfterMissedScans": 1,
    "ignoreFieldsForChanges": [],
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/pisos-com-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 '{
  "mode": "search",
  "locations": [
    "Madrid Capital"
  ],
  "urls": [
    "https://www.pisos.com/venta/pisos-madrid_capital_zona_urbana/",
    "https://www.pisos.com/venta/pisos-madrid_capital_zona_urbana/2/",
    "https://www.pisos.com/alquiler/pisos-madrid_capital_zona_urbana/",
    "https://www.pisos.com/venta/casas-barcelona/",
    "https://www.pisos.com/venta/locales-madrid/",
    "https://www.pisos.com/venta/pisos-madrid/",
    "https://www.pisos.com/venta/pisos-madrid_capital/",
    "https://www.pisos.com/venta/pisos-madrid_capital_zona_urbana/desde-300000/hasta-500000/",
    "https://www.pisos.com/venta/pisos-madrid_capital_zona_urbana/?utm_source=x&ordenar=precio",
    "https://www.pisos.com/mapa/venta/pisos-madrid_capital_zona_urbana/",
    "https://www.pisos.com/en/venta/pisos-madrid_capital_zona_urbana/",
    "https://www.pisos.com/comprar/piso-carabanchel_san_isidro28019-65077851154_510936/",
    "https://www.pisos.com/alquilar/piso-madrid_capital_zona_urbana-65077851154_510936/",
    "https://www.pisos.com/inmobiliaria-redpiso_estudio_pradera_de_san_isidro/"
  ],
  "proxy": {
    "useApifyProxy": true
  },
  "incrementalMode": false,
  "emitExpired": false,
  "expireAfterMissedScans": 1,
  "ignoreFieldsForChanges": []
}' |
apify call abotapi/pisos-com-scraper --silent --output-dataset

```

## MCP server setup

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