# Idealista Real Estate Listing Scraper (Italy)

Scrape information (località, prezzo, dettagli, etc.) about properties on Idealista.it using result page URLs

- Template page: [https://www.octoparse.com/template/crawler-lista-immobili-idealista](https://www.octoparse.com/template/crawler-lista-immobili-idealista)
- Categories: Real Estate
- Status: `PUBLISHED`
- Run mode: `CLOUD`

## Pricing

Current price: **$0.04/1,000 lines**. Billing is based on output rows; an Octoparse subscription may be required.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from listing pages.

## Output

The current workflow extracts 13 fields, including `categoria`, `descrizione`, `dettagli_1`, `dettagli_2`, `dettagli_3`, `dettagli_4`, `dettagli_appartamento_url`, `immagine_url`, `località`, `prezzo`, `titolo_appartamento`, `url`, `vendita_o_affitto`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete List Page URL, Number of pages and start the template in cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### List Page URL

Required. the URLs of the search results pages on Idealista.it Constraints: minItems=1; maxItems=2000; items.minLength=1; items.maxLength=10000.

### Number of pages

Optional. Max 60 pages Constraints: minimum=1, maximum=60.

## How to Use

## Idealista Real Estate Listing Scraper (Italy)

Collects property information (località, prezzo, dettagli, etc.) from Idealista.it using result page URLs.

### Input

- **List Page URL** (required): One or more listing page URLs, one per line.
- **Number of pages** (optional): Integer from 1 to 60.

### How to Use

1. Open the template and select **Try it** or **Start**.
2. Fill in the input fields above.
3. Run the task in the cloud.
4. Review the output rows and export or process the structured data.

You can schedule recurring runs, export collected data, and reuse it through Octoparse OpenAPI or the [AgentTools API](https://www.octoparse.com/docs/en/api-reference/agenttools-api/search-templates). Scheduling and API access may require a paid Octoparse plan.

### Limitations

- Collects only the fields displayed on listing pages; does not add data not shown by Idealista.
- Fields such as `dettagli_4`, `descrizione`, and `immagine_url` may be empty if the source record does not provide them.

### Tips

- Start with one or a few inputs and review the returned rows before scaling.
- Use the most specific valid List Page URL to reduce unrelated or duplicate records.
- Use a stable URL or identifier from the output (e.g., `url`, `località`, `titolo_appartamento`) as a deduplication key when available.

## Notes

If the template does not work well, do not hesitate to let us know the parameters you entered at the email address template@octoparse.com

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [Idealista Real Estate Detail Scraper (Italy)](https://www.octoparse.com/template/crawler-dettagli-immobili-idealista)
- [Idealista Real Estate Listing Scraper (Portugal)](https://www.octoparse.com/template/idealista-real-estate-listing-scraper-portugal)
- [Idealista Real Estate Detail Scraper (Portugal)](https://www.octoparse.com/template/idealista-real-estate-detail-scraper-portugal)
- [Immobiliare Real Estate Listing Scraper (Local Only)](https://www.octoparse.com/template/crawler-lista-immobili-immobiliare)
- [Gumtree Scraper (Real Estate Listing)](https://www.octoparse.com/template/gumtree-scraper-real-estate-listing)

## Input Schema

```json
{
  "title": "Idealista Real Estate Listing Scraper (Italy) input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "list_Page_URL": {
      "title": "List Page URL",
      "description": "the URLs of the search results pages on Idealista.it",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 10000
      },
      "minItems": 1,
      "maxItems": 2000,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "number_of_pages": {
      "title": "Number of pages",
      "description": "Max 60 pages",
      "type": "integer",
      "minimum": 1,
      "maximum": 60,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "list_Page_URL"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "list_Page_URL": [
    "https://www.idealista.it/vendita-case/milano-provincia/con-dimensione-max_40/?ordine=pubblicazione-desc",
    "https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_41,dimensione-max_48/?ordine=pubblicazione-desc",
    "https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_49,dimensione-max_52/?ordine=pubblicazione-desc",
    "https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_53,dimensione-max_57/?ordine=pubblicazione-desc",
    "https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_58,dimensione-max_62/?ordine=pubblicazione-desc"
  ],
  "number_of_pages": 60.0
}
```

Example 2

```json
{
  "list_Page_URL": [
    "https://www.idealista.it/vendita-case/milano-provincia/con-dimensione-max_40/?ordine=pubblicazione-desc",
    "https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_41,dimensione-max_48/?ordine=pubblicazione-desc",
    "https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_49,dimensione-max_52/?ordine=pubblicazione-desc",
    "https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_53,dimensione-max_57/?ordine=pubblicazione-desc",
    "https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_58,dimensione-max_62/?ordine=pubblicazione-desc"
  ],
  "number_of_pages": 60
}
```

Example 3

```json
{
  "list_Page_URL": [
    "https://www.idealista.it/affitto-case/milano-provincia/con-dimensione-max_35/?ordine=pubblicazione-desc",
    "https://www.idealista.it/affitto-case/milano-provincia/con-dimensione_36,dimensione-max_43/?ordine=pubblicazione-desc",
    "https://www.idealista.it/affitto-case/milano-provincia/con-dimensione_44,dimensione-max_49/?ordine=pubblicazione-desc",
    "https://www.idealista.it/affitto-case/milano-provincia/con-dimensione_50,dimensione-max_52/?ordine=pubblicazione-desc",
    "https://www.idealista.it/affitto-case/milano-provincia/con-dimensione_53,dimensione-max_59/?ordine=pubblicazione-desc"
  ],
  "number_of_pages": 60
}
```

Example 4

```json
{
  "list_Page_URL": [
    "https://www.idealista.it/affitto-case/milano-provincia/?ordine=pubblicazione-desc",
    "https://www.idealista.it/affitto-case/bergamo-provincia/?ordine=pubblicazione-desc",
    "https://www.idealista.it/affitto-case/brescia-provincia/?ordine=pubblicazione-desc",
    "https://www.idealista.it/affitto-case/lodi-provincia/?ordine=pubblicazione-desc",
    "https://www.idealista.it/affitto-case/pavia-provincia/?ordine=pubblicazione-desc"
  ],
  "number_of_pages": 2
}
```

Example 5

```json
{
  "list_Page_URL": [
    "https://www.idealista.it/vendita-case/milano/certosa/accursio/"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "categoria": {
      "type": "string",
      "description": ""
    },
    "descrizione": {
      "type": "string",
      "description": ""
    },
    "dettagli_1": {
      "type": "string",
      "description": ""
    },
    "dettagli_2": {
      "type": "string",
      "description": ""
    },
    "dettagli_3": {
      "type": "string",
      "description": ""
    },
    "dettagli_4": {
      "type": "string",
      "description": ""
    },
    "dettagli_appartamento_url": {
      "type": "string",
      "description": ""
    },
    "immagine_url": {
      "type": "string",
      "description": ""
    },
    "località": {
      "type": "string",
      "description": ""
    },
    "prezzo": {
      "type": "string",
      "description": ""
    },
    "titolo_appartamento": {
      "type": "string",
      "description": ""
    },
    "url": {
      "type": "string",
      "description": ""
    },
    "vendita_o_affitto": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Idealista Real Estate Listing Scraper (Italy) output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

Example 1

```json
{
  "categoria": "",
  "descrizione": "A pochi passi dalla vivace zona di City Life, si propone in vendita grazioso tre locali di 90mq, sito al secondo piano di uno stabile di nuova costruzione, provvisto di ascensore, in viale Severino Boezio, 20 a Milano.L'appartamento si presenta completamente ristrutturato e rappresenta la soluzione perfetta per un'abi",
  "dettagli_1": "Box compreso ",
  "dettagli_2": "3 locali",
  "dettagli_3": "90 m²",
  "dettagli_4": "2º piano con ascensore",
  "dettagli_appartamento_url": "https://www.idealista.it/immobile/37550938/",
  "immagine_url": "https://img4.idealista.it/blur/480_360_mq/0/id.pro.it.image.master/c8/43/80/860201896.jpg",
  "località": "Viale Severino Boezio, 20, Portello - Tre Torri, Milano",
  "prezzo": "900.000€",
  "titolo_appartamento": "Trilocale in Viale Severino Boezio, 20, Portello - Tre Torri, Milano",
  "url": "https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_86,dimensione-max_90/?ordine=pubblicazione-desc",
  "vendita_o_affitto": "Vendita"
}
```

Example 2

```json
{
  "categoria": "",
  "descrizione": "OTTIMA OCCASIONE - ASTA IMMOBILIAREAppartamento di 64 mq catastali sito in Trezzo sull’Adda (MI), Via Giuseppe Mazzini n. 39, posto al piano primo, composto da ampio locale giorno con angolo cottura e balcone, disimpegno, bagno e camera, oltre piccolo vano cantina al piano interrato di 2 mq catastali. - Via Giuseppe",
  "dettagli_1": "Box compreso ",
  "dettagli_2": "3 locali",
  "dettagli_3": "65 m²",
  "dettagli_4": "1º piano con ascensore",
  "dettagli_appartamento_url": "https://www.idealista.it/immobile/37543598/",
  "immagine_url": "https://img4.idealista.it/blur/480_360_mq/0/id.pro.it.image.master/ae/9f/08/860008113.jpg",
  "località": "Via Giuseppe Mazzini, Trezzo sull'Adda",
  "prezzo": "66.526€",
  "titolo_appartamento": "Trilocale in Via Giuseppe Mazzini, Trezzo sull'Adda",
  "url": "https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_63,dimensione-max_66/?ordine=pubblicazione-desc",
  "vendita_o_affitto": "Vendita"
}
```

Example 3

```json
{
  "categoria": "",
  "descrizione": "Studio Immobiliare Mille - proponiamo in locazione MONOLOCALE NUOVO MAI ABITATO, in stabile di nuova costruzione dotato di servizio di portineria full time e video sorveglianza. \"Art Building\", una nuova costruzione adiacente al famoso \"villaggio dei giornalisti\", nasce in classe A1, è collocato al quinto piano di uno",
  "dettagli_1": "1 locale",
  "dettagli_2": "40 m²",
  "dettagli_3": "5º piano con ascensore",
  "dettagli_4": "",
  "dettagli_appartamento_url": "https://www.idealista.it/immobile/37549763/",
  "immagine_url": "https://img4.idealista.it/blur/480_360_mq/0/id.pro.it.image.master/45/29/f2/860170671.jpg",
  "località": "Via Giampietro Lucini, 19, Maggiolina - Villaggio dei Giornalisti, Milano",
  "prezzo": "900€/mese",
  "titolo_appartamento": "Monolocale in Via Giampietro Lucini, 19, Maggiolina - Villaggio dei Giornalisti, Milano",
  "url": "https://www.idealista.it/affitto-case/milano-provincia/con-dimensione_36,dimensione-max_43/?ordine=pubblicazione-desc",
  "vendita_o_affitto": "Affitto"
}
```

Example 4

```json
{
  "categoria": "",
  "descrizione": "A Bertonico un tranquillo paese in provincia di Lodi, ideale per chi desidera vivere in un contesto riservato e lontano dal caos cittadino, senza rinunciare ai principali servizi di prima necessità, tra cui negozi e scuole.Proponiamo in locazione un quadrilocale di 100 mq, situato al secondo piano in condominio tranq",
  "dettagli_1": "Box compreso ",
  "dettagli_2": "4 locali",
  "dettagli_3": "105 m²",
  "dettagli_4": "2º piano con ascensore",
  "dettagli_appartamento_url": "https://www.idealista.it/immobile/37510058/",
  "immagine_url": "https://img4.idealista.it/blur/480_360_mq/0/id.pro.it.image.master/04/81/53/858998204.jpg",
  "località": "Via Mario Tosi s.n.c, Bertonico",
  "prezzo": "2.400€/mese",
  "titolo_appartamento": "Quadrilocale in Via Mario Tosi s.n.c, Bertonico",
  "url": "https://www.idealista.it/affitto-case/lodi-provincia/?ordine=pubblicazione-desc",
  "vendita_o_affitto": "Affitto"
}
```

Example 5

```json
{
  "categoria": "",
  "descrizione": "Zona Portello – Esclusivo attico con terrazze panoramicheNel cuore del quartiere Portello proponiamo in vendita un luminoso attico con tripla esposizione e splendide terrazze panoramiche, situato all'undicesimo piano di un elegante stabile di recente costruzione, dotato di servizio di portineria e impianto di videoso",
  "dettagli_1": "Box  70.000 € ",
  "dettagli_2": "3 locali",
  "dettagli_3": "165 m²",
  "dettagli_4": "11º piano con ascensore",
  "dettagli_appartamento_url": "https://www.idealista.it/immobile/34127108/",
  "immagine_url": "https://img4.idealista.it/blur/480_360_mq/0/id.pro.it.image.master/92/50/b4/745651378.jpg",
  "località": "Largo Marco Zanuso, Accursio, Milano",
  "prezzo": "1.050.000€",
  "titolo_appartamento": "Attico in Largo Marco Zanuso, Accursio, Milano",
  "url": "https://www.idealista.it/vendita-case/milano/certosa/accursio/",
  "vendita_o_affitto": "Vendita"
}
```

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

```json
{
  "templateName": "crawler-lista-immobili-idealista",
  "taskName": "Idealista Real Estate Listing Scraper (Italy)",
  "parameters": "{\"list_Page_URL\":[\"https://www.idealista.it/vendita-case/milano-provincia/con-dimensione-max_40/?ordine=pubblicazione-desc\",\"https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_41,dimensione-max_48/?ordine=pubblicazione-desc\",\"https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_49,dimensione-max_52/?ordine=pubblicazione-desc\",\"https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_53,dimensione-max_57/?ordine=pubblicazione-desc\",\"https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_58,dimensione-max_62/?ordine=pubblicazione-desc\"],\"number_of_pages\":60.0}"
}
```

## Python Example

```python
import json
import requests

OPENAPI_BASE = "https://openapi.octoparse.com"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"

parameters = json.loads("{\"list_Page_URL\":[\"https://www.idealista.it/vendita-case/milano-provincia/con-dimensione-max_40/?ordine=pubblicazione-desc\",\"https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_41,dimensione-max_48/?ordine=pubblicazione-desc\",\"https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_49,dimensione-max_52/?ordine=pubblicazione-desc\",\"https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_53,dimensione-max_57/?ordine=pubblicazione-desc\",\"https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_58,dimensione-max_62/?ordine=pubblicazione-desc\"],\"number_of_pages\":60.0}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "crawler-lista-immobili-idealista",
        "taskName": "Idealista Real Estate Listing Scraper (Italy)",
        "parameters": json.dumps(parameters, ensure_ascii=False),
    },
    timeout=60,
)
print(response.status_code)
print(response.json())
```

## HTTP/cURL Example

```bash
curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "templateName": "crawler-lista-immobili-idealista",
  "taskName": "Idealista Real Estate Listing Scraper (Italy)",
  "parameters": "{\"list_Page_URL\":[\"https://www.idealista.it/vendita-case/milano-provincia/con-dimensione-max_40/?ordine=pubblicazione-desc\",\"https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_41,dimensione-max_48/?ordine=pubblicazione-desc\",\"https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_49,dimensione-max_52/?ordine=pubblicazione-desc\",\"https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_53,dimensione-max_57/?ordine=pubblicazione-desc\",\"https://www.idealista.it/vendita-case/milano-provincia/con-dimensione_58,dimensione-max_62/?ordine=pubblicazione-desc\"],\"number_of_pages\":60.0}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `crawler-lista-immobili-idealista`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/crawler-lista-immobili-idealista.json)
- [Manifest](https://www.octoparse.com/templates/crawler-lista-immobili-idealista-manifest.json)
