# Immobiliare Property Search Scraper (`ecomscrape/immobiliare-property-search-scraper`)

Powerful scraper for Italy's #1 property portal Immobiliare.it. Extract comprehensive real estate data including prices, property details, and market insights from over 1.2M listings across Italy for investment analysis and market research.

- **URL**: https://beta-securitybyobscurity.apify.com/ecomscrape/immobiliare-property-search-scraper.md
- **Developed by:** [ecomscrape](https://beta-securitybyobscurity.apify.com/ecomscrape) (community)
- **Categories:** Real estate, Developer tools
- **Stats:** 9 total users, 9 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

$20.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.
You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

# README

## Contact

If you encounter any issues or need to exchange information, please feel free to contact us through the following link:
[My profile](https://apify.com/ecomscrape)

## Immobiliare.it Property Search Scraper - Advanced Real Estate Data Extraction Tool

### Introduction

Immobiliare.it stands as Italy's leading property portal, serving as the primary destination for real estate listings with over 55 million monthly visits and more than 1.2 million active property listings. The platform connects thousands of real estate agencies and private owners, making it an invaluable resource for comprehensive Italian property market data. However, manually collecting this vast amount of data for market analysis, investment research, or competitive intelligence can be extremely time-consuming and inefficient.

The Immobiliare.it Property Search Scraper addresses this challenge by automating the data extraction process, enabling users to efficiently gather large-scale property information from Italy's most comprehensive real estate database. This tool transforms hours of manual research into minutes of automated data collection, providing structured access to critical market intelligence.

### Overview of the Immobiliare.it Scraper

The Immobiliare.it scraper is a sophisticated data extraction tool designed specifically for Italy's premier property portal. This scraper enables users to track price movements and market trends in specific provinces or municipalities, monitor new listings, auctions, and rental opportunities for real-time insights, generate high-quality leads for agents, investors, and developers, and analyze comprehensive market data.

The scraper's key strengths include its ability to handle large-scale data collection while respecting website policies, support for proxy rotation to ensure reliable access, and extraction of comprehensive property details that would be impossible to gather manually at scale. The tool is particularly valuable for real estate professionals, market researchers, property investors, and data analysts who need systematic access to Italian property market information.

Target users include real estate agencies seeking competitive intelligence, property investors conducting market analysis, researchers studying Italian housing trends, and developers identifying market opportunities across different Italian regions.

### Input and Output Details

Example url 1: https://www.immobiliare.it/vendita-appartamenti/roma/#120239840

Example url 2: https://www.immobiliare.it/vendita-appartamenti/roma/olgiata-giustiniana/

Example url 3: https://www.immobiliare.it/vendita-appartamenti/roma/casalotti-casal-selce/

Example Screenshot of property list by query page:

![](https://i.ibb.co/BV8n1MRr/Screenshot-from-2025-08-11-15-31-37.png)

#### Input Format

The scraper accepts a JSON configuration that defines the scraping parameters and target URLs. Here's the detailed input structure:

```json
{
  "max_retries_per_url": 2, // Maximum waiting time when accessing the links you provided.
  "proxy": { // Add a proxy to ensure that during the data collection process, you are not detected as a bot.
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL" 
    ],
    "apifyProxyCountry": "SG" // You should choose an Country that coincides with the Country you want to collect data from
  },
  "max_items_per_url": 20,
  "urls": [ // Links to property list by query pages.
    "https://www.immobiliare.it/vendita-appartamenti/roma/#120239840",
    "https://www.immobiliare.it/vendita-appartamenti/roma/olgiata-giustiniana/",
    "https://www.immobiliare.it/vendita-appartamenti/roma/casalotti-casal-selce/"
  ]
}
```

**Input Parameters Explained:**

- `max_retries_per_url`: Controls reliability by setting retry attempts for failed requests
- `proxy`: Essential for avoiding bot detection during large-scale scraping operations
- `max_items_per_url`: Limits data volume per URL to manage resource usage effectively
- `urls`: Target property listing pages from Immobiliare.it search results

#### Output Format

You get the output from the Immobiliare.it Property Search Scraper stored in a tab. The following is an example of the Information Fields collected after running the Actor.

```json
[ // List of property information
  {
  "visibility": "supervetrina",
  "data_type": "list-real-estate",
  "id": 121667636,
  "uuid": "63835353-353a-5cf7-b0b3-9188fd57ee40",
  "advertiser": {
    "agency": {
      "id": 248928,
      "type": "agency",
      "show_only_agent_phone": false,
      "phones": [
        {
          "type": "vTel1",
          "value": "06 9763 8582"
        }
      ],
      "bookable_visit": {
        "is_visit_bookable": true,
        "virtual_visit_enabled": true
      },
      "is_paid": true,
      "label": "agenzia",
      "display_name": "RE/MAX Gruppo Casa RE Aventino",
      "guaranteed": false,
      "show_agent_phone": false,
      "show_logo": true,
      "image_urls": {
        "small": "https://pic.im-cdn.it/imagenoresize/1471891385.jpg",
        "large": "https://pic.im-cdn.it/imagenoresize/1471891387.jpg"
      },
      "agency_url": "https://www.immobiliare.it/agenzie-immobiliari/248928/remax-iti-casa-re-roma-aventino/",
      "show_external_link": false
    },
    "supervisor": {
      "type": "agent",
      "image_gender": "male",
      "phones": [
        {
          "type": "vTel1",
          "value": "06 9763 8582"
        }
      ],
      "image_type": "agent",
      "display_name": "Gruppo Casa RE",
      "label": "agente immobiliare",
      "image_url": "https://pic.im-cdn.it/agenti/290736/1471897411/80.jpg"
    },
    "has_call_numbers": true
  },
  "contract": "sale",
  "is_new": false,
  "luxury": false,
  "price": {
    "visible": true,
    "value": 259000,
    "formatted_value": "€ 259.000",
    "price_range": "200.001 - 300.000 &euro;"
  },
  "properties": [
    {
      "multimedia": {
        "photos": [
          {
            "id": 1741071270,
            "caption": "Studio",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741071270/xxs-c.jpg"
            }
          },
          {
            "id": 1741071556,
            "caption": "Studio",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741071556/xxs-c.jpg"
            }
          },
          {
            "id": 1741071582,
            "caption": "Salone",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741071582/xxs-c.jpg"
            }
          },
          {
            "id": 1741071606,
            "caption": "Salone",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741071606/xxs-c.jpg"
            }
          },
          {
            "id": 1741071634,
            "caption": "Salone",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741071634/xxs-c.jpg"
            }
          },
          {
            "id": 1741071650,
            "caption": "Cucina",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741071650/xxs-c.jpg"
            }
          },
          {
            "id": 1741071670,
            "caption": "Cucina",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741071670/xxs-c.jpg"
            }
          },
          {
            "id": 1741071698,
            "caption": "Cucina",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741071698/xxs-c.jpg"
            }
          },
          {
            "id": 1741071722,
            "caption": "Terrazzo",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741071722/xxs-c.jpg"
            }
          },
          {
            "id": 1741071750,
            "caption": "Terrazzo",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741071750/xxs-c.jpg"
            }
          },
          {
            "id": 1741071782,
            "caption": "Terrazzo",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741071782/xxs-c.jpg"
            }
          },
          {
            "id": 1741071802,
            "caption": "Terrazzo",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741071802/xxs-c.jpg"
            }
          },
          {
            "id": 1741071834,
            "caption": "Camera da letto",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741071834/xxs-c.jpg"
            }
          },
          {
            "id": 1741071858,
            "caption": "Camera da letto",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741071858/xxs-c.jpg"
            }
          },
          {
            "id": 1741071894,
            "caption": "Camera da letto",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741071894/xxs-c.jpg"
            }
          },
          {
            "id": 1741071922,
            "caption": "Ripostiglio",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741071922/xxs-c.jpg"
            }
          },
          {
            "id": 1741071936,
            "caption": "Bagno",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741071936/xxs-c.jpg"
            }
          },
          {
            "id": 1741071956,
            "caption": "Camera da letto",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741071956/xxs-c.jpg"
            }
          },
          {
            "id": 1741071986,
            "caption": "Camera da letto",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741071986/xxs-c.jpg"
            }
          },
          {
            "id": 1741072016,
            "caption": "Camera da letto",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741072016/xxs-c.jpg"
            }
          },
          {
            "id": 1741072040,
            "caption": "Bagno",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741072040/xxs-c.jpg"
            }
          },
          {
            "id": 1741072064,
            "caption": "Bagno",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741072064/xxs-c.jpg"
            }
          },
          {
            "id": 1741072094,
            "caption": "Bagno",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741072094/xxs-c.jpg"
            }
          },
          {
            "id": 1741072116,
            "caption": "Terrazzo",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741072116/xxs-c.jpg"
            }
          },
          {
            "id": 1741072150,
            "caption": "Terrazzo",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741072150/xxs-c.jpg"
            }
          },
          {
            "id": 1741072186,
            "caption": "Terrazzo",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741072186/xxs-c.jpg"
            }
          },
          {
            "id": 1741072212,
            "caption": "Interno palazzo",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741072212/xxs-c.jpg"
            }
          },
          {
            "id": 1741072234,
            "caption": "Box auto",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741072234/xxs-c.jpg"
            }
          },
          {
            "id": 1741072262,
            "caption": "Box auto",
            "urls": {
              "small": "https://pwm.im-cdn.it/image/1741072262/xxs-c.jpg"
            }
          }
        ],
        "virtual_tours": [
          null
        ],
        "has_multimedia": true
      },
      "bathrooms": "2",
      "floor": {
        "abbreviation": "1",
        "value": "1° piano, con ascensore",
        "floor_only_value": "1 piano",
        "ga4_floor_value": "1 piano"
      },
      "ga4_condition": "Ottimo / Ristrutturato",
      "price": {
        "visible": true,
        "value": 259000,
        "formatted_value": "€ 259.000",
        "price_range": "200.001 - 300.000 &euro;"
      },
      "rooms": "3",
      "elevator": true,
      "surface": "85 m²",
      "typology": {
        "id": 14,
        "name": "Appartamento"
      },
      "typology_g_a4_translation": "Appartamento",
      "ga4features": [
        "cancello elettrico",
        "porta blindata",
        "terrazzo",
        "impianto tv con parabola satellitare",
        "arredato",
        "esposizione doppia"
      ],
      "ga4_heating": "Autonomo",
      "caption": "Morena Trilocale con terrazzo",
      "category": {
        "id": 1,
        "name": "Residenziale"
      },
      "description": "Proponiamo in vendita un appartamento di 85 mq, in ottime condizioni, situato all'interno di un edificio signorile con ascensore, nel cuore di Morena, uno dei quartieri residenziali più tranquilli e ben collegati di Roma.\n\nDistribuzione interna e caratteristiche principali:\n\n-Zona living luminosa e accogliente, ampio soggiorno con grandi porte/finestre che donano luce naturale e permettono l’accesso diretto al terrazzo di circa 70 mq perfetto per essere vissuto tutto l'anno. Il camino aggiunge un tocco di eleganza e calore, rendendo lo spazio ideale per momenti di relax o convivialità.\n\n-Cucin",
      "photo": {
        "id": 1741071270,
        "caption": "Studio",
        "urls": {
          "small": "https://pwm.im-cdn.it/image/1741071270/xxs-c.jpg",
          "medium": "https://pwm.im-cdn.it/image/1741071270/m-c.jpg",
          "large": "https://pwm.im-cdn.it/image/1741071270/xxl.jpg"
        }
      },
      "bed_rooms_number": "2",
      "location": {
        "address": "Via di Torre Morena",
        "latitude": 41.8153,
        "longitude": 12.6072,
        "marker": "marker",
        "region": "Lazio",
        "province": "Roma",
        "macrozone": "Anagnina, Romanina, Tor Vergata",
        "microzone": "Morena",
        "city": "Roma",
        "nation": {
          "id": "IT",
          "name": "Italia"
        }
      },
      "feature_list": [
        {
          "type": "rooms",
          "label": "3 locali",
          "compact_label": "3"
        },
        {
          "type": "surface",
          "label": "85 m²"
        },
        {
          "type": "bathrooms",
          "label": "2 bagni",
          "compact_label": "2"
        },
        {
          "type": "floor",
          "label": "Piano 1",
          "compact_label": "1"
        },
        {
          "type": "elevator",
          "label": "Ascensore",
          "compact_label": "Sì"
        },
        {
          "type": "terrace",
          "label": "Terrazzo"
        },
        {
          "type": "furniture",
          "label": "Arredato"
        }
      ]
    }
  ],
  "title": "Trilocale via di Torre Morena, Morena, Roma",
  "type": "ad",
  "typology": {
    "id": 14,
    "name": "Appartamento"
  },
  "has_main_property": false,
  "is_project_like": false,
  "is_mosaic": true,
  "from_url": "https://www.immobiliare.it/vendita-appartamenti/roma/?pag=2#120239840"
}, // ... Many other property details
] 
```

The scraper returns structured data with the following comprehensive fields:

**Core Identification Fields:**

- **Visibility**: Indicates whether the listing is publicly visible or has restricted access
- **Data Type**: Categorizes the type of property data extracted (sale, rent, commercial)
- **ID**: Unique numerical identifier from Immobiliare.it's database system
- **UUID**: Universal unique identifier for cross-platform data integration

**Property Classification:**

- **Advertiser**: Information about the listing party (agency, private owner, developer)
- **Contract**: Contract type specification (sale, rent, lease arrangements)
- **Type**: Broad property category (residential, commercial, industrial)
- **Typology**: Specific property subtype (apartment, villa, office, warehouse)

**Market Positioning:**

- **Is New**: Boolean indicating new construction or recent development status
- **Luxury**: Classification for high-end properties with premium features
- **Price**: Current asking price in euros, critical for market analysis
- **Has Main Property**: Indicates primary residence classification for tax purposes

**Advanced Categorization:**

- **Properties**: Detailed property characteristics and features array
- **Title**: Property listing headline with key selling points
- **Is Project Like**: Identifies development projects or off-plan properties
- **Is Mosaic**: Special display format used for premium listings

### Usage Guidelines

#### Step-by-Step Implementation

1. **Prepare Target URLs**: Identify specific Immobiliare.it search result pages that match your research criteria
2. **Configure Parameters**: Set appropriate retry limits and proxy settings based on your data volume needs
3. **Execute Extraction**: Run the scraper with your configured parameters
4. **Process Results**: Analyze the structured output data for your specific use case

#### Best Practices

**Proxy Configuration**: Always use residential proxies with Italian IP addresses to ensure reliable access and avoid detection. The recommended Singapore proxy configuration helps maintain consistent performance while respecting geographical restrictions.

**URL Selection**: Focus on specific geographic areas or property types to maximize data relevance. Using targeted search URLs produces more actionable insights than broad, generic queries.

**Rate Limiting**: Respect the max\_items\_per\_url parameter to balance data collection needs with responsible scraping practices. This prevents overwhelming the source website while ensuring comprehensive data extraction.

#### Common Issues and Solutions

**Access Limitations**: If encountering blocked requests, verify proxy configuration and consider reducing concurrent requests. Italian property sites may have geographic access restrictions.

**Data Quality**: Some listings may have incomplete information. Implement data validation checks to identify and handle missing or inconsistent field values in your analysis workflows.

### Benefits and Applications

#### Time and Resource Efficiency

The scraper dramatically reduces manual research time from hours to minutes, enabling real-time market monitoring that would be impossible through manual collection. This efficiency allows for more frequent market analysis and faster response to emerging opportunities.

#### Real-World Applications

**Investment Analysis**: Track property prices across different Italian regions to identify emerging investment opportunities and market trends.

**Market Research**: Generate comprehensive reports on housing availability, pricing patterns, and property characteristics for specific metropolitan areas.

**Competitive Intelligence**: Monitor competitor pricing strategies and property portfolios for strategic business planning.

**Lead Generation**: Identify potential properties and contacts for real estate professionals targeting specific market segments.

#### Business Value

The comprehensive data extraction enables data-driven decision making in Italy's complex real estate market. By providing systematic access to market intelligence, the scraper supports more accurate property valuations, informed investment strategies, and effective market positioning for real estate professionals.

### Conclusion

The Immobiliare.it Property Search Scraper provides essential market intelligence capabilities for anyone serious about understanding Italy's real estate landscape. With access to data from Italy's leading property portal that serves over 55 million monthly users and hosts more than 1.2 million listings, this tool transforms complex manual research into streamlined automated insights.

Whether you're conducting market research, seeking investment opportunities, or analyzing competitive landscapes, this scraper delivers the comprehensive Italian property data needed for informed decision-making. Start extracting valuable market intelligence today and gain the competitive advantage that systematic data collection provides.

## Your feedback

We are always working to improve Actors' performance. So, if you have any technical feedback about Immobiliare.it Property Search Scraper or simply found a bug, please create an issue on the Actor's Issues tab in Apify Console.

# Actor input Schema

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

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

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

Limit the number of items per URL you want to scrape

## `max_retries_per_url` (type: `integer`):

Limit the number of retries for each URL if the scrape is detected as a bot or the page fails to load

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

Select proxies to be used by your scraper.

## Actor input object example

```json
{
  "urls": [
    "https://www.immobiliare.it/vendita-appartamenti/roma/#120239840"
  ],
  "max_items_per_url": 20,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": false
  }
}
```

# 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/#120239840"
    ],
    "max_items_per_url": 20,
    "max_retries_per_url": 2,
    "proxy": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("ecomscrape/immobiliare-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/#120239840"],
    "max_items_per_url": 20,
    "max_retries_per_url": 2,
    "proxy": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("ecomscrape/immobiliare-property-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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/#120239840"
  ],
  "max_items_per_url": 20,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": false
  }
}' |
apify call ecomscrape/immobiliare-property-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=ecomscrape/immobiliare-property-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Immobiliare Property Search Scraper",
        "description": "Powerful scraper for Italy's #1 property portal Immobiliare.it. Extract comprehensive real estate data including prices, property details, and market insights from over 1.2M listings across Italy for investment analysis and market research.",
        "version": "0.0",
        "x-build-id": "fSOtl7d7DRA9xPQpC"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/ecomscrape~immobiliare-property-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-ecomscrape-immobiliare-property-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/ecomscrape~immobiliare-property-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-ecomscrape-immobiliare-property-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/ecomscrape~immobiliare-property-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-ecomscrape-immobiliare-property-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "urls": {
                        "title": "URLs of the Property list page urls to scrape",
                        "type": "array",
                        "description": "Add the URLs of the Property list page urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "max_items_per_url": {
                        "title": "Limit the number of items per URL",
                        "type": "integer",
                        "description": "Limit the number of items per URL you want to scrape"
                    },
                    "max_retries_per_url": {
                        "title": "Limit the number of retries for each URL",
                        "type": "integer",
                        "description": "Limit the number of retries for each URL if the scrape is detected as a bot or the page fails to load"
                    },
                    "proxy": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Select proxies to be used by your scraper."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
