# Immobiliare.it Property Search Scraper (`stealth_mode/immobiliare-it-property-search-scraper`) Actor

Collect property listings from Immobiliare.it, one of Italy's largest real estate portals, in structured form. Extract prices, surfaces, rooms, locations, agency details, and photos from any search results page, ready for market analysis, CRM import, or price tracking.

- **URL**: https://apify.com/stealth_mode/immobiliare-it-property-search-scraper.md
- **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community)
- **Categories:** Automation, Developer tools, Real estate
- **Features:** Limited permissions
- **Stats:** 9 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 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.
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

## Immobiliare.it Scraper: Property Listings - Fast Data Export

***

### Why Scrape Immobiliare.it?

Immobiliare.it is one of the most visited property portals in Italy. It lists apartments, houses, and commercial properties for sale and rent across the country's major cities, including Rome, Milan, and Turin. Each listing carries valuable market signals: asking prices, surface areas, neighborhood (macrozone and microzone), and the agency or agent offering the property.

Reviewing these listings one by one is slow, and the data is hard to compare across hundreds of ads. The **Immobiliare.it Property Search Scraper** automates collection from search result pages and returns each listing as a consistent, structured record. This makes it practical to track price movements, compare neighborhoods, or build a local property database.

***

### Overview

The scraper works from **search results URLs**, the paginated lists you see when you filter Immobiliare.it by city, contract type, and category. For each URL, it visits the listings and returns up to a set number of items. It is useful for:

- **Real estate analysts** comparing asking prices and surfaces across districts
- **Investors** monitoring new listings and price ranges in target cities
- **Agencies and developers** building market reports or competitor benchmarks
- **Data teams** feeding property data into dashboards or machine learning models

The output includes more than 50 fields, covering core property attributes, location coordinates, agency information, and media. Field availability may vary between listings, because not every advertiser fills in every detail.

***

### Input Format

The scraper accepts a JSON configuration:

```json
{
  "urls": [
    "https://www.immobiliare.it/vendita-appartamenti/roma/?pag=2"
  ],
  "ignore_url_failures": true,
  "include_raw_data": false,
  "max_items_per_url": 20
}
```

| Field | Description |
|---|---|
| `urls` | List of search results URLs to scrape. Paste them one by one or use bulk edit. |
| `ignore_url_failures` | If `true`, the run continues when some URLs fail. Default: `true`. |
| `include_raw_data` | If `true`, adds the unprocessed website data to each record. Default: `false`. |
| `max_items_per_url` | Maximum number of listings collected per URL. Default: `20`. |

**Input requirements and limits:**

- URLs should point to search result pages on immobiliare.it, such as `/vendita-appartamenti/roma/` for apartments for sale in Rome.
- Fragment identifiers (the part after `#`, such as `#120239840`) are not sent to the server by browsers. They usually have no effect on which results are returned, so the page number in the query string (`?pag=2`) is what matters.
- Setting `max_items_per_url` too high increases run time and cost. Start with a small number to test.
- Use a proxy from Italy (`IT`) when possible, so requests resemble local traffic.

***

### Output Format

Each listing produces one record. The main groups of fields are described below.

**Identification and listing details**

- `id`: Immobiliare.it listing identifier, useful for deduplication across runs.
- `listing_url`: Direct link to the listing page.
- `title`, `caption`, `description`: The advertisement text. Useful for keyword analysis or natural language processing.
- `contract`, `category`, `typology`: The deal type (sale or rent), property category, and property type.
- `is_new`, `is_luxury`: Flags indicating whether the listing is marked as new or luxury.

**Price**

- `price`: Numeric price, ready for calculations.
- `price_text`, `price_range`: The price as displayed, which may include formatting or ranges.
- `price_visible`: Whether the advertiser shows the price publicly.
- `currency`: Usually EUR.

**Property features**

- `surface`, `rooms`, `bedrooms`, `bathrooms`: Size and layout. Price per square meter can be derived from `price` and `surface`.
- `floor`, `floor_number`, `has_elevator`: Floor level and access details.
- `condition`, `heating`: Building state and heating system.
- `views`, `features`, `attributes`: Lists of additional characteristics, such as balcony or garden.

**Location**

- `address`, `latitude`, `longitude`: Precise location for mapping and geospatial analysis.
- `macrozone`, `microzone`: Neighborhood-level grouping, helpful for comparing areas.
- `city`, `province`, `region`, `country`, `country_code`: Administrative location.

**Agency and agent**

- `agency_id`, `agency_name`, `agency_type`, `agency_label`, `agency_url`, `agency_phones`: Information about the agency offering the property.
- `agent_name`, `agent_type`, `agent_label`, `agent_phones`, `agent_image_url`: Details of the individual agent.
- `is_visit_bookable`, `has_virtual_visit`: Whether viewings can be booked online or held virtually.

**Media**

- `photo_count`, `photos`, `cover_photo_urls`: Image count and links.
- `virtual_tours`, `has_multimedia`: Presence of virtual tours and other media.

**Example output (simplified, with annotations):**

```json
{
  "id": 128073072,
  "listing_url": "https://www.immobiliare.it/annunci/128073072/",
  "title": "Appartamento via Emanuele Filiberto, Esquilino, Roma",
  "caption": "Elegante appartamento a pochi passi da San Giovanni",
  "description": "Residenza esclusiva di ampia metratura\n\nNel cuore del XV Rione della capitale, a pochi passi dalla Basilica di San Giovanni, dal Colosseo e dal Centro Storico, precisamente in Via Emanuele Filiberto, proponiamo in vendita una prestigiosa residenza di ampia metratura.\n\nL’immobile è situato al primo piano nobile di un elegante palazzo umbertino dei primi del ’900, dotato di ascensore e servizio di portineria, e gode di una posizione strategica, sopra la linea Metro A (fermata Manzoni), in una delle vie più richieste della zona.\nL’appartamento, luminoso e silenzioso, si distingue per gli ambienti",
  "contract": "sale",
  "category": "Residenziale",
  "typology": "Appartamento",
  "is_new": false,
  "is_luxury": true,
  "price": 1390000,
  "price_text": "€ 1.390.000",
  "price_range": "oltre 500.000 €",
  "price_visible": true,
  "currency": "EUR",
  "surface": "252 m²",
  "rooms": "5+",
  "bedrooms": "3",
  "bathrooms": "2",
  "floor": "1°, con ascensore",
  "floor_number": "1",
  "has_elevator": true,
  "condition": "Ottimo / Ristrutturato",
  "heating": "Autonomo",
  "views": [
    "centro storico/monumenti"
  ],
  "features": [
    "fibra ottica",
    "porta blindata",
    "armadio a muro",
    "balcone",
    "impianto tv centralizzato",
    "parzialmente arredato",
    "esposizione doppia"
  ],
  "attributes": [
    {
      "label": "rooms",
      "value": "5+ locali"
    },
    {
      "label": "surface",
      "value": "252 m²"
    },
    {
      "label": "bathrooms",
      "value": "2 bagni"
    },
    {
      "label": "floor",
      "value": "Piano 1"
    },
    {
      "label": "luxury",
      "value": "Lusso"
    },
    {
      "label": "elevator",
      "value": "Ascensore"
    },
    {
      "label": "balcony",
      "value": "Balcone"
    },
    {
      "label": "furniture",
      "value": "Parzialmente Arredato"
    }
  ],
  "address": "Via Emanuele Filiberto",
  "latitude": 41.8901,
  "longitude": 12.5069,
  "macrozone": "Termini, Repubblica",
  "microzone": "Esquilino",
  "city": "Roma",
  "province": "Roma",
  "region": "Lazio",
  "country": "Italia",
  "country_code": "IT",
  "agency_id": 200835,
  "agency_name": "Engel & Völkers Roma",
  "agency_type": "agency",
  "agency_label": "agenzia",
  "agency_url": "https://www.immobiliare.it/agenzie-immobiliari/200835/engel-voelkers-roma/",
  "agency_phones": [
    "06 9763 7235"
  ],
  "agency_logo_urls": {
    "small": "https://pic.im-cdn.it/imagenoresize/1335971178.jpg",
    "large": "https://pic.im-cdn.it/imagenoresize/1335971180.jpg"
  },
  "is_visit_bookable": true,
  "has_virtual_visit": false,
  "agent_name": "MC Roma",
  "agent_type": "agent",
  "agent_label": "agente immobiliare",
  "agent_phones": [
    "06 9763 7235"
  ],
  "agent_image_url": "https://pic.im-cdn.it/agenti/208670/1619036199/80.jpg",
  "photo_count": 19,
  "cover_photo_urls": {
    "small": "https://pwm.im-cdn.it/image/1899820572/xxs-c.jpg",
    "medium": "https://pwm.im-cdn.it/image/1899820572/m-c.jpg",
    "large": "https://pwm.im-cdn.it/image/1899820572/xxl.jpg"
  },
  "photos": [
    {
      "id": 1899820572,
      "caption": "Salone",
      "url": "https://pwm.im-cdn.it/image/1899820572/xxs-c.jpg"
    },
    {
      "id": 1899820582,
      "caption": "Salone",
      "url": "https://pwm.im-cdn.it/image/1899820582/xxs-c.jpg"
    },
    {
      "id": 1899820590,
      "caption": "Salone",
      "url": "https://pwm.im-cdn.it/image/1899820590/xxs-c.jpg"
    },
    {
      "id": 1899820602,
      "caption": "Salone",
      "url": "https://pwm.im-cdn.it/image/1899820602/xxs-c.jpg"
    },
    {
      "id": 1899820616,
      "caption": "Studio",
      "url": "https://pwm.im-cdn.it/image/1899820616/xxs-c.jpg"
    },
    {
      "id": 1899820626,
      "caption": "Cucina",
      "url": "https://pwm.im-cdn.it/image/1899820626/xxs-c.jpg"
    },
    {
      "id": 1899820634,
      "caption": "Camera da letto",
      "url": "https://pwm.im-cdn.it/image/1899820634/xxs-c.jpg"
    },
    {
      "id": 1899820644,
      "caption": "Camera da letto",
      "url": "https://pwm.im-cdn.it/image/1899820644/xxs-c.jpg"
    },
    {
      "id": 1899820654,
      "caption": "Camera da letto",
      "url": "https://pwm.im-cdn.it/image/1899820654/xxs-c.jpg"
    },
    {
      "id": 1899820666,
      "caption": "Camera da letto",
      "url": "https://pwm.im-cdn.it/image/1899820666/xxs-c.jpg"
    },
    {
      "id": 1899820682,
      "caption": "Camera da letto",
      "url": "https://pwm.im-cdn.it/image/1899820682/xxs-c.jpg"
    },
    {
      "id": 1899820694,
      "caption": "Studio",
      "url": "https://pwm.im-cdn.it/image/1899820694/xxs-c.jpg"
    },
    {
      "id": 1899820706,
      "caption": "Stanza non arredata",
      "url": "https://pwm.im-cdn.it/image/1899820706/xxs-c.jpg"
    },
    {
      "id": 1899820714,
      "caption": "Interno non residenziale",
      "url": "https://pwm.im-cdn.it/image/1899820714/xxs-c.jpg"
    },
    {
      "id": 1899820724,
      "caption": "Cucina",
      "url": "https://pwm.im-cdn.it/image/1899820724/xxs-c.jpg"
    },
    {
      "id": 1899820730,
      "caption": "Bagno",
      "url": "https://pwm.im-cdn.it/image/1899820730/xxs-c.jpg"
    },
    {
      "id": 1899820740,
      "caption": "Balcone",
      "url": "https://pwm.im-cdn.it/image/1899820740/xxs-c.jpg"
    },
    {
      "id": 1899820752,
      "caption": "Interno palazzo",
      "url": "https://pwm.im-cdn.it/image/1899820752/xxs-c.jpg"
    },
    {
      "id": 1899820766,
      "caption": "Facciata",
      "url": "https://pwm.im-cdn.it/image/1899820766/xxs-c.jpg"
    }
  ],
  "virtual_tours": [],
  "has_multimedia": true,
  "raw_data": null,
  "from_url": "https://www.immobiliare.it/vendita-appartamenti/roma/?pag=2#120239840"
}
```

*Note: Values above are illustrative. Actual field formats may differ from listing to listing.*

***

### How to Use

1. **Collect search URLs.** Apply your filters on Immobiliare.it (city, contract, category) and copy the resulting URL. Use the page parameter to go through multiple pages.
2. **Configure the input.** Paste the URLs into `urls` and set `max_items_per_url` according to how many listings you need.
3. **Enable a proxy.** Use the `RESIDENTIAL` group with country `IT` to reduce the chance of blocks.
4. **Run and monitor.** Start the run and check the log for failed URLs.
5. **Export the data.** Download results as JSON, CSV, or Excel. For CSV, nested fields such as `photos` and `agency_phones` may need flattening.

**Tips and best practices:**

- Run the scraper on a schedule, such as weekly, and compare `id` values to track new and removed listings.
- Keep `include_raw_data` disabled unless you need to debug or audit the original data, since it increases output size.
- Standardize `surface` and `price` values before analysis, because their formats may vary.

**Common issues:**

- **Empty results:** Confirm the URL is a search results page and loads correctly in a browser.
- **Missing fields:** Many advertisers leave out details such as floor or condition. Treat empty values as unknown, not zero.
- **Run stops early:** Keep `ignore_url_failures` enabled so one bad URL does not halt the whole run.

***

### Business Value and Applications

- **Market analysis:** Compare average asking prices per square meter across macrozones and track changes over time.
- **Investment research:** Identify neighborhoods where listing volume or price levels suggest opportunities.
- **Lead generation:** Use agency and agent data to build outreach lists for service providers, such as renovation firms or mortgage brokers.
- **Automated monitoring:** Alert teams when new listings appear within a chosen price range or area.

Automating collection saves significant manual effort, especially when tracking several cities at once. The structured format allows the data to flow directly into spreadsheets, databases, or BI tools.

***

### Conclusion

The **Immobiliare.it Property Search Scraper** offers a practical way to turn Italian property listings into structured, analysis-ready data. With detailed fields covering pricing, features, location, and agencies, it supports market research, investment screening, and competitive analysis. Start with a small test run, refine your search URLs, and build a reliable dataset for your next decision.

> **Legal note:** Scraped data may include personal information, such as agent names and phone numbers. Review Immobiliare.it's Terms of Service and comply with applicable rules, including the EU General Data Protection Regulation (GDPR), before storing or using this data.

# Actor input Schema

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

Add the URLs of the tour list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## `include_raw_data` (type: `boolean`):

If true, the scraper will include raw data from website before cleaning in the output.

## `max_items_per_url` (type: `integer`):

The maximum number of items to scrape per URL.

## Actor input object example

```json
{
  "urls": [
    "https://www.immobiliare.it/vendita-appartamenti/roma/?pag=2#120239840"
  ],
  "ignore_url_failures": true,
  "include_raw_data": false,
  "max_items_per_url": 20
}
```

# Actor output Schema

## `results` (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 = {
    "urls": [
        "https://www.immobiliare.it/vendita-appartamenti/roma/?pag=2#120239840"
    ],
    "ignore_url_failures": true,
    "include_raw_data": false,
    "max_items_per_url": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("stealth_mode/immobiliare-it-property-search-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 = {
    "urls": ["https://www.immobiliare.it/vendita-appartamenti/roma/?pag=2#120239840"],
    "ignore_url_failures": True,
    "include_raw_data": False,
    "max_items_per_url": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("stealth_mode/immobiliare-it-property-search-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 '{
  "urls": [
    "https://www.immobiliare.it/vendita-appartamenti/roma/?pag=2#120239840"
  ],
  "ignore_url_failures": true,
  "include_raw_data": false,
  "max_items_per_url": 20
}' |
apify call stealth_mode/immobiliare-it-property-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,stealth_mode/immobiliare-it-property-search-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/JmR7GwiyoekLdUsWc/builds/ecwGrVFlzklUQmvih/openapi.json
